On this page

IP Address Geolocation API

Introduction

What is an IP Geolocation API?

The IP geolocation API is a web service used to identify internet users’ location information based on their IP address. The API provides highly accurate and detailed location data such as postal codes, city names, country names and much more.

How does an IP Geolocation API work?

A public IP address is a unique identifier that allows devices to connect to the internet. It is used by the global network of routers to accurately route data packets to the requesting user client. Hence, the IP address of a user is always public and visible to the external networks.

Harnessing this information gives IP Lookup tools like ours the ability to accurately locate user’s geolocation based on the IP address. You can check our two blog posts describing the fundamentals of IP Geolocation API technology and how BigDataCloud’s IP Geolocation is different from others.

How to use IP Geolocation API?

IP geolocation API is widely used for delivering content localisation, customer targeting, digital rights management and online fraud detection.

It is an essential component of modern digital platforms like social networking sites; e-commerce; travel; banking sites and content delivery/streaming sites. It is also leveraged in customer analytics and CRM platforms to enrich existing customer data.

How accurate are the results of an IP Geolocation API?

The accuracy of an IP Geolocation API varies based on the data sources and algorithms used by the service providers. Services that depend only on freely available data sources or external service providers are less reliable than others.

For a more detailed discussion about the accuracy of IP geolocation, please refer to our blog.

How is BigDataCloud’s IP Geolocation API different?

BigDataCloud is the industry’s first to provide an entirely scientific IP Geolocation technology. It is powered by patent-pending ‘Next Generation IP Geolocation Technology’ which provides the most accurate and detailed information about the geographical location, ownership and connectivity of an IPv4 IP address at submillisecond speed.

Core benefits of our IP Geolocation API are:

  • Lightning-fast response (sub-millisecond)
  • Country object data
  • Detailed locality data
  • Estimated location coordinates
  • Network data
  • Registration data
  • BGP prefix and status data
  • Next-Generation IP Geolocation Technology

Unprecedented Update Rate

  • Geolocation data re-evaluated every 2 hours or at least once a day
  • BGP data updated every 2 hours
  • Registry data updated at least once a day
  • Country object data usually updated at least once in a month 

Get started

This API is part of the IP Geolocation package and is available in free and paid plans. Please visit the IP Geolocation package page for limits and pricing information.

Endpoint

GET
https://api.bigdatacloud.net/data/ip-geolocation

Request

Parameter
Type
Required
Description
Parameter
ip
Type
string
Required
Optional, default value: [Caller's IP]
Description
IPv4 IP address in a string or numeric format. If omitted, the caller’s IP address is assumed
Parameter
localityLanguage
Type
string
Required
Optional, default value: en
Description
Preferred language for locality names in ISO 639-1 format, such as 'en' for English, 'es' for Spanish etc. If the requested language is unavailable for a requested location, it will default to English. If no English variant is available, will provide the native, local names. Use 'default' as the requested value to automatically adjust the language to the first administrative language in the Country.
Parameter
key
Type
string
Required
Yes
Description
Your API key

Responses

Example query

https://api.bigdatacloud.net/data/ip-geolocation?ip=193.114.112.1&localityLanguage=en&key=[YOUR API KEY]
  

Example response

  • 1
    {
  • 2
    "ip": "193.114.112.1",
  • 3
    "localityLanguageRequested": "en",
  • 4
    "isReachableGlobally": true,
  • 5
    "country": {...}
    • 6
      "isoAlpha2": "AU",
    • 7
      "isoAlpha3": "AUS",
    • 8
      "m49Code": 36,
    • 9
      "name": "Australia",
    • 10
      "isoName": "Australia",
    • 11
      "isoNameFull": "Australia",
    • 12
      "isoAdminLanguages": [...]
      • 13
        {...}
        • 14
          "isoAlpha3": "eng",
        • 15
          "isoAlpha2": "en",
        • 16
          "isoName": "English",
        • 17
          "nativeName": "English"
        • 18
          }
      • 19
        ],
    • 20
      "unRegion": "Oceania/Australia and New Zealand",
    • 21
      "currency": {...}
      • 22
        "numericCode": 36,
      • 23
        "code": "AUD",
      • 24
        "name": "Australian Dollar",
      • 25
        "minorUnits": 2
      • 26
        },
    • 27
      "wbRegion": {...}
      • 28
        "id": "EAS",
      • 29
        "iso2Code": "Z4",
      • 30
        "value": "East Asia & Pacific"
      • 31
        },
    • 32
      "wbIncomeLevel": {...}
      • 33
        "id": "HIC",
      • 34
        "iso2Code": "XD",
      • 35
        "value": "High income"
      • 36
        },
    • 37
      "callingCode": "61",
    • 38
      "countryFlagEmoji": "🇦🇺",
    • 39
      "wikidataId": "Q408",
    • 40
      "geonameId": 2077456,
    • 41
      "continents": [...]
      • 42
        {...}
        • 43
          "continent": "Oceania",
        • 44
          "continentCode": "OC"
        • 45
          }
      • 46
        ]
    • 47
      },
  • 48
    "location": {...}
    • 49
      "continent": "Oceania",
    • 50
      "continentCode": "OC",
    • 51
      "principalSubdivision": "South Australia",
    • 52
      "isoPrincipalSubdivision": "South Australia",
    • 53
      "isoPrincipalSubdivisionCode": "AU-SA",
    • 54
      "city": "Adelaide",
    • 55
      "localityName": "Adelaide",
    • 56
      "postcode": "5000",
    • 57
      "latitude": -34.93,
    • 58
      "longitude": 138.6,
    • 59
      "plusCode": "4QQW3J92+X2",
    • 60
      "timeZone": {...}
      • 61
        "ianaTimeId": "Australia/Adelaide",
      • 62
        "displayName": "(UTC+09:30) Central Australia Time (Adelaide)",
      • 63
        "effectiveTimeZoneFull": "Australian Central Standard Time",
      • 64
        "effectiveTimeZoneShort": "ACST",
      • 65
        "utcOffsetSeconds": 34200,
      • 66
        "utcOffset": "+09:30",
      • 67
        "isDaylightSavingTime": false,
      • 68
        "localTime": "2022-07-05T05:55:36.2885598"
      • 69
        },
    • 70
      "localityInfo": {...}
      • 71
        "administrative": [...]
        • 72
          {...}
          • 73
            "name": "Australia",
          • 74
            "description": "country in Oceania",
          • 75
            "isoName": "Australia",
          • 76
            "order": 3,
          • 77
            "adminLevel": 2,
          • 78
            "isoCode": "AU",
          • 79
            "wikidataId": "Q408",
          • 80
            "geonameId": 2077456
          • 81
            },
        • 82
          {...}
          • 83
            "name": "South Australia",
          • 84
            "description": "state of Australia",
          • 85
            "isoName": "South Australia",
          • 86
            "order": 4,
          • 87
            "adminLevel": 4,
          • 88
            "isoCode": "AU-SA",
          • 89
            "wikidataId": "Q35715",
          • 90
            "geonameId": 2061327
          • 91
            },
        • 92
          {...}
          • 93
            "name": "Adelaide",
          • 94
            "description": "local government area in South Australia",
          • 95
            "order": 7,
          • 96
            "adminLevel": 6,
          • 97
            "wikidataId": "Q1094063",
          • 98
            "geonameId": 7839644
          • 99
            },
        • 100
          {...}
          • 101
            "name": "Adelaide",
          • 102
            "description": "city centre of Adelaide, South Australia",
          • 103
            "order": 8,
          • 104
            "adminLevel": 10,
          • 105
            "wikidataId": "Q4681820",
          • 106
            "geonameId": 11523825
          • 107
            }
        • 108
          ],
      • 109
        "informative": [...]
        • 110
          {...}
          • 111
            "name": "Oceania",
          • 112
            "description": "geographic region comprising Melanesia, Micronesia and Polynesia",
          • 113
            "order": 1,
          • 114
            "isoCode": "OC",
          • 115
            "wikidataId": "Q538",
          • 116
            "geonameId": 6255151
          • 117
            },
        • 118
          {...}
          • 119
            "name": "Australia",
          • 120
            "description": "continent on the Earth's Southern Hemisphere",
          • 121
            "order": 2,
          • 122
            "isoCode": "OC",
          • 123
            "wikidataId": "Q3960"
          • 124
            },
        • 125
          {...}
          • 126
            "name": "Adelaide",
          • 127
            "description": "capital city of South Australia",
          • 128
            "order": 5,
          • 129
            "wikidataId": "Q5112",
          • 130
            "geonameId": 2078025
          • 131
            },
        • 132
          {...}
          • 133
            "name": "5000",
          • 134
            "description": "postal code",
          • 135
            "order": 6
          • 136
            }
        • 137
          ]
      • 138
        }
    • 139
      },
  • 140
    "lastUpdated": "2022-07-02T23:42:04.4522984Z",
  • 141
    "network": {...}
    • 142
      "registry": "APNIC",
    • 143
      "registryStatus": "assigned",
    • 144
      "registeredCountry": "AU",
    • 145
      "registeredCountryName": "Australia",
    • 146
      "organisation": "TPG Internet Pty Ltd",
    • 147
      "isReachableGlobally": true,
    • 148
      "isBogon": false,
    • 149
      "bgpPrefix": "193.114.112.0/24",
    • 150
      "bgpPrefixNetworkAddress": "193.114.112.0",
    • 151
      "bgpPrefixLastAddress": "193.114.112.255",
    • 152
      "totalAddresses": 256,
    • 153
      "carriers": [...]
      • 154
        {...}
        • 155
          "asn": "AS7545",
        • 156
          "asnNumeric": 7545,
        • 157
          "organisation": "TPG Internet Pty Ltd",
        • 158
          "name": "TPG-INTERNET-AP",
        • 159
          "registry": "APNIC",
        • 160
          "registeredCountry": "AU",
        • 161
          "registeredCountryName": "Australia",
        • 162
          "registrationLastChange": "2020-11-04",
        • 163
          "totalIpv4Addresses": 3232528,
        • 164
          "totalIpv4Prefixes": 6161,
        • 165
          "totalIpv4BogonPrefixes": 0,
        • 166
          "rank": 150,
        • 167
          "rankText": "#150 out of 75,050"
        • 168
          }
      • 169
        ],
    • 170
      "viaCarriers": [...]
      • 171
        {...}
        • 172
          "asn": "AS3356",
        • 173
          "asnNumeric": 3356,
        • 174
          "organisation": "Level 3 Parent LLC",
        • 175
          "name": "LEVEL3",
        • 176
          "registry": "ARIN",
        • 177
          "registeredCountry": "US",
        • 178
          "registeredCountryName": "United States of America",
        • 179
          "totalIpv4Addresses": 28201883,
        • 180
          "rank": 14,
        • 181
          "rankText": "#14 out of 75,050"
        • 182
          },
      • 183
        {...}
        • 184
          "asn": "AS174",
        • 185
          "asnNumeric": 174,
        • 186
          "organisation": "Cogent Communications",
        • 187
          "name": "COGENT-174",
        • 188
          "registry": "ARIN",
        • 189
          "registeredCountry": "US",
        • 190
          "registeredCountryName": "United States of America",
        • 191
          "totalIpv4Addresses": 21943522,
        • 192
          "rank": 15,
        • 193
          "rankText": "#15 out of 75,050"
        • 194
          },
      • 195
        {...}
        • 196
          "asn": "AS2764",
        • 197
          "asnNumeric": 2764,
        • 198
          "organisation": "AAPT Limited",
        • 199
          "name": "AAPT",
        • 200
          "registry": "APNIC",
        • 201
          "registeredCountry": "AU",
        • 202
          "registeredCountryName": "Australia",
        • 203
          "totalIpv4Addresses": 756992,
        • 204
          "rank": 452,
        • 205
          "rankText": "#452 out of 75,050"
        • 206
          },
      • 207
        {...}
        • 208
          "asn": "AS1299",
        • 209
          "asnNumeric": 1299,
        • 210
          "organisation": "Telia Company AB",
        • 211
          "name": "TWELVE99",
        • 212
          "registry": "RIPE",
        • 213
          "registeredCountry": "SE",
        • 214
          "registeredCountryName": "Sweden",
        • 215
          "totalIpv4Addresses": 257792,
        • 216
          "rank": 964,
        • 217
          "rankText": "#964 out of 75,050"
        • 218
          },
      • 219
        {...}
        • 220
          "asn": "AS4635",
        • 221
          "asnNumeric": 4635,
        • 222
          "organisation": "The Hong Kong Internet Exchange Limited",
        • 223
          "name": "HKIX-RS1",
        • 224
          "registry": "APNIC",
        • 225
          "registeredCountry": "HK",
        • 226
          "registeredCountryName": "Hong Kong",
        • 227
          "totalIpv4Addresses": 0
        • 228
          },
      • 229
        {...}
        • 230
          "asn": "AS7713",
        • 231
          "asnNumeric": 7713,
        • 232
          "organisation": "Telekomunikasi Indonesia PT",
        • 233
          "name": "telkomnet-as-ap",
        • 234
          "registry": "APNIC",
        • 235
          "registeredCountry": "ID",
        • 236
          "registeredCountryName": "Indonesia",
        • 237
          "totalIpv4Addresses": 4248064,
        • 238
          "rank": 125,
        • 239
          "rankText": "#125 out of 75,050"
        • 240
          },
      • 241
        {...}
        • 242
          "asn": "AS14061",
        • 243
          "asnNumeric": 14061,
        • 244
          "organisation": "DigitalOcean LLC",
        • 245
          "name": "DIGITALOCEAN-ASN",
        • 246
          "registry": "ARIN",
        • 247
          "registeredCountry": "US",
        • 248
          "registeredCountryName": "United States of America",
        • 249
          "totalIpv4Addresses": 2713849,
        • 250
          "rank": 170,
        • 251
          "rankText": "#170 out of 75,050"
        • 252
          },
      • 253
        {...}
        • 254
          "asn": "AS7575",
        • 255
          "asnNumeric": 7575,
        • 256
          "organisation": "Australian Academic and Research Network",
        • 257
          "name": "AARNET-AS-AP",
        • 258
          "registry": "APNIC",
        • 259
          "registeredCountry": "AU",
        • 260
          "registeredCountryName": "Australia",
        • 261
          "totalIpv4Addresses": 1334016,
        • 262
          "rank": 303,
        • 263
          "rankText": "#303 out of 75,050"
        • 264
          },
      • 265
        {...}
        • 266
          "asn": "AS8220",
        • 267
          "asnNumeric": 8220,
        • 268
          "organisation": "COLT Technology Services Group Limited",
        • 269
          "name": "COLT",
        • 270
          "registry": "RIPE",
        • 271
          "registeredCountry": "GB",
        • 272
          "registeredCountryName": "United Kingdom",
        • 273
          "totalIpv4Addresses": 1213696,
        • 274
          "rank": 325,
        • 275
          "rankText": "#325 out of 75,050"
        • 276
          },
      • 277
        {...}
        • 278
          "asn": "AS4739",
        • 279
          "asnNumeric": 4739,
        • 280
          "organisation": "iiNet Limited",
        • 281
          "name": "INTERNODE-AS",
        • 282
          "registry": "APNIC",
        • 283
          "registeredCountry": "AU",
        • 284
          "registeredCountryName": "Australia",
        • 285
          "totalIpv4Addresses": 742188,
        • 286
          "rank": 459,
        • 287
          "rankText": "#459 out of 75,050"
        • 288
          },
      • 289
        {...}
        • 290
          "asn": "AS6453",
        • 291
          "asnNumeric": 6453,
        • 292
          "organisation": "TATA COMMUNICATIONS AMERICA INC",
        • 293
          "name": "AS6453",
        • 294
          "registry": "ARIN",
        • 295
          "registeredCountry": "US",
        • 296
          "registeredCountryName": "United States of America",
        • 297
          "totalIpv4Addresses": 550912,
        • 298
          "rank": 556,
        • 299
          "rankText": "#556 out of 75,050"
        • 300
          },
      • 301
        {...}
        • 302
          "asn": "AS6939",
        • 303
          "asnNumeric": 6939,
        • 304
          "organisation": "Hurricane Electric LLC",
        • 305
          "name": "HURRICANE",
        • 306
          "registry": "ARIN",
        • 307
          "registeredCountry": "US",
        • 308
          "registeredCountryName": "United States of America",
        • 309
          "totalIpv4Addresses": 424960,
        • 310
          "rank": 670,
        • 311
          "rankText": "#670 out of 75,050"
        • 312
          },
      • 313
        {...}
        • 314
          "asn": "AS9268",
        • 315
          "asnNumeric": 9268,
        • 316
          "organisation": "Over the Wire Pty Ltd",
        • 317
          "name": "OVERTHEWIRE-AS-AP",
        • 318
          "registry": "APNIC",
        • 319
          "registeredCountry": "AU",
        • 320
          "registeredCountryName": "Australia",
        • 321
          "totalIpv4Addresses": 71424,
        • 322
          "rank": 2488,
        • 323
          "rankText": "#2,488 out of 75,050"
        • 324
          },
      • 325
        {...}
        • 326
          "asn": "AS36236",
        • 327
          "asnNumeric": 36236,
        • 328
          "organisation": "NetActuate Inc",
        • 329
          "name": "NETACTUATE",
        • 330
          "registry": "ARIN",
        • 331
          "registeredCountry": "US",
        • 332
          "registeredCountryName": "United States of America",
        • 333
          "totalIpv4Addresses": 57088,
        • 334
          "rank": 3980,
        • 335
          "rankText": "#3,980 out of 75,050"
        • 336
          },
      • 337
        {...}
        • 338
          "asn": "AS9902",
        • 339
          "asnNumeric": 9902,
        • 340
          "organisation": "NeocomISP Limited",
        • 341
          "name": "NEOCOMISP-KH-AP",
        • 342
          "registry": "APNIC",
        • 343
          "registeredCountry": "KH",
        • 344
          "registeredCountryName": "Cambodia",
        • 345
          "totalIpv4Addresses": 27648,
        • 346
          "rank": 5451,
        • 347
          "rankText": "#5,451 out of 75,050"
        • 348
          },
      • 349
        {...}
        • 350
          "asn": "AS24482",
        • 351
          "asnNumeric": 24482,
        • 352
          "organisation": "SG.GS",
        • 353
          "name": "SGGS-AS-AP",
        • 354
          "registry": "APNIC",
        • 355
          "registeredCountry": "SG",
        • 356
          "registeredCountryName": "Singapore",
        • 357
          "totalIpv4Addresses": 23809,
        • 358
          "rank": 5870,
        • 359
          "rankText": "#5,870 out of 75,050"
        • 360
          },
      • 361
        {...}
        • 362
          "asn": "AS16552",
        • 363
          "asnNumeric": 16552,
        • 364
          "organisation": "Tiggee LLC",
        • 365
          "name": "TIGGEE",
        • 366
          "registry": "ARIN",
        • 367
          "registeredCountry": "US",
        • 368
          "registeredCountryName": "United States of America",
        • 369
          "totalIpv4Addresses": 13312,
        • 370
          "rank": 8026,
        • 371
          "rankText": "#8,026 out of 75,050"
        • 372
          },
      • 373
        {...}
        • 374
          "asn": "AS58952",
        • 375
          "asnNumeric": 58952,
        • 376
          "organisation": "Frontiir Co. Ltd",
        • 377
          "name": "FRONTIIRCOLTD-MM",
        • 378
          "registry": "APNIC",
        • 379
          "registeredCountry": "MM",
        • 380
          "registeredCountryName": "Myanmar",
        • 381
          "totalIpv4Addresses": 7168,
        • 382
          "rank": 11922,
        • 383
          "rankText": "#11,922 out of 75,050"
        • 384
          },
      • 385
        {...}
        • 386
          "asn": "AS58511",
        • 387
          "asnNumeric": 58511,
        • 388
          "organisation": "ANYCAST HOLDINGS PTY LTD",
        • 389
          "name": "ANYCAST-GLOBAL-BACKBONE",
        • 390
          "registry": "APNIC",
        • 391
          "registeredCountry": "AU",
        • 392
          "registeredCountryName": "Australia",
        • 393
          "totalIpv4Addresses": 6656,
        • 394
          "rank": 12253,
        • 395
          "rankText": "#12,253 out of 75,050"
        • 396
          },
      • 397
        {...}
        • 398
          "asn": "AS59605",
        • 399
          "asnNumeric": 59605,
        • 400
          "organisation": "MENA LEVANT W.L.L",
        • 401
          "name": "ZAINGP-AS",
        • 402
          "registry": "RIPE",
        • 403
          "registeredCountry": "BH",
        • 404
          "registeredCountryName": "Bahrain",
        • 405
          "totalIpv4Addresses": 6400,
        • 406
          "rank": 12423,
        • 407
          "rankText": "#12,423 out of 75,050"
        • 408
          },
      • 409
        {...}
        • 410
          "asn": "AS37468",
        • 411
          "asnNumeric": 37468,
        • 412
          "organisation": "Angola Cables",
        • 413
          "name": "ANGOLA-CABLES",
        • 414
          "registry": "AFRINIC",
        • 415
          "registeredCountry": "AO",
        • 416
          "registeredCountryName": "Angola",
        • 417
          "totalIpv4Addresses": 6128,
        • 418
          "rank": 12927,
        • 419
          "rankText": "#12,927 out of 75,050"
        • 420
          },
      • 421
        {...}
        • 422
          "asn": "AS132337",
        • 423
          "asnNumeric": 132337,
        • 424
          "organisation": "ALPHA NETWORKS SOLUTION PTE. LTD.",
        • 425
          "name": "ANSPL-AS-AP",
        • 426
          "registry": "APNIC",
        • 427
          "registeredCountry": "SG",
        • 428
          "registeredCountryName": "Singapore",
        • 429
          "totalIpv4Addresses": 1536,
        • 430
          "rank": 26700,
        • 431
          "rankText": "#26,700 out of 75,050"
        • 432
          },
      • 433
        {...}
        • 434
          "asn": "AS140627",
        • 435
          "asnNumeric": 140627,
        • 436
          "organisation": "ONEQODE ASSETS PTY LTD",
        • 437
          "name": "ONEQODEASSETS-AS-AP",
        • 438
          "registry": "APNIC",
        • 439
          "registeredCountry": "AU",
        • 440
          "registeredCountryName": "Australia",
        • 441
          "totalIpv4Addresses": 512,
        • 442
          "rank": 52458,
        • 443
          "rankText": "#52,458 out of 75,050"
        • 444
          }
      • 445
        ]
    • 446
      }
  • 447
    }

Schema

application/json