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

Schema

application/json