IP Location Module

IP to Location module provides geolocation information related to an IP address such as continent, country, country capital, country calling code, country top level domain, city, state/province, zip code, local languages, country flag, latitude and longitude information.

Response

{
  "ip": "8.8.8.8",
  "continent_code": "NA",
  "continent_name": "North America",
  "country_code2": "US",
  "country_code3": "USA",
  "country_name": "United States",
  "country_name_official": "United States of America",
  "country_capital": "Washington, D.C.",
  "state_prov": "California",
  "state_code": "US-CA",
  "district": "Santa Clara County",
  "city": "Mountain View",
  "zipcode": "94043-1351",
  "latitude": "37.42240",
  "longitude": "-122.08421",
  "is_eu": false,
  "calling_code": "+1",
  "country_tld": ".us",
  "languages": "en-US,es-US,haw,fr",
  "country_flag": "https://ipgeolocation.io/static/flags/us_64.png",
  "geoname_id": "6301403",
  "country_emoji": "🇺🇸"
}

Currency Module

IP to Currency module provides currency information of the country such as currency name, currency symbol and currency code from an IP address.

Response

"currency":{
  "name": "US Dollar",
  "code": "USD",
  "symbol": "$"
}

Time Zone Module

IP to Time Zone module provides time and timezone related information such as timezone name, UTC/GMT offset, current date and time string, is daylight saving time active and daylight saving in hours.

Response

"time_zone":{
  "name": "America/Los_Angeles",
  "offset": -8,
  "offset_with_dst": -7,
  "current_time": "2024-10-02 00:06:41.301-0700",
  "current_time_unix": 1727852801.301,
  "is_dst": true,
  "dst_savings": 1,
  "dst_exists": true,
  "dst_start": {
    "utc_time": "2024-03-10 TIME 10",
    "duration": "+1H",
    "gap": true,
    "dateTimeAfter": "2024-03-10 TIME 03",
    "dateTimeBefore": "2024-03-10 TIME 02",
    "overlap": false
  },
  "dst_end": {
    "utc_time": "2024-11-03 TIME 09",
    "duration": "-1H",
    "gap": false,
    "dateTimeAfter": "2024-11-03 TIME 01",
    "dateTimeBefore": "2024-11-03 TIME 02",
    "overlap": true
  }
}

Connection Information Module

Connection information module provides connection related information such as name of the ISP which owns this IP address, name of the organization/company to whom this IP address is further licensed by the ISP, ASN and the connection type (wired or wireless).

Response

{
  "isp": "Level 3 Communications",
  "connection_type": "wired",
  "organization": "Google Inc.",
  "asn": "AS15169"
}

Security Module

The security module provides threat intelligence data such as threat score, is tor, vpn or proxy, is known attacker and if the IP address belongs to one of the cloud providers.

Response

"security":{
  "threat_score": 42,
  "is_tor": false,
  "is_proxy": true,
  "proxy_type": "VPN",
  "is_anonymous": true,
  "is_known_attacker": true,
  "is_spam": false,
  "is_bot": false,
  "is_cloud_provider": true
}

User Agent Parser Module

User Agent module parses the browser user agent string and provides detailed device information such as device name, device version, device type, device operating system, device browser, browser engine and browser version. It can identify robots, crawlers and attackers.

Response

"user_agent":{
  "userAgentString": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_3) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.0.5 Safari/605.1.15",
  "name": "Safari",
  "type": "Browser",
  "version": "13.0.5",
  "versionMajor": "13",
  "device": {
    "name": "Apple Macintosh",
    "type": "Desktop",
    "brand": "Apple",
    "cpu": "Intel"
  },
  "engine": {
    "name": "AppleWebKit",
    "type": "Browser",
    "version": "605.1.15",
    "versionMajor": "605"
  },
  "operatingSystem": {
    "name": "Mac OS",
    "type": "Desktop",
    "version": "10.15.3",
    "versionMajor": "10.15"
  }
}

Reverse IP Lookup Module

With reverse IP Lookup, you can resolve the host name or domain or router dns address. This gives you detailed information about the original source of traffic.

Response

curl 'https://api.ipgeolocation.io/ipgeo?include=hostname&ip=8.8.8.8&apiKey=API_KEY'

Response

{
 "ip":"8.8.8.8",
 "hostname":"dns.google",
 "..."
}

Domain IP Lookup

Enter the domain address in place of IP address and our API will perform a DNS Lookup to give you the information about the web hosting provider and the geographical location of the website.

Response

{
  "domain": "ipgeolocation.io",
  "ip": "104.20.61.122",
  "isp": "Cloudflare, Inc.",
  "asn": "AS13335",
  "..."
}

Bulk IP Address Lookup Support

Use our Bulk IP Lookup endpoint to perform batch lookup of multiple IPs in one go. One request can have up to 50,000 IPs. Both IPv4 and IPv6 are supported.

Response

curl -X POST 'https://api.ipgeolocation.io/ipgeo-bulk?apiKey=API_KEY' \\
     -H 'Content-Type: application/json' \\
     -d '{
          "ips": ["1.1.1.1", "1.2.3.4", "1.2.3.5", "1.2.3.6", "1.2.3.7"]
         }'

Response in Multiple Languages

You can retrieve the geolocation information for an IP address in the following languages:

English

German

Russian

Japanese

French

Chinese Simplified ES Flag

Spanish

Czech

Italian

Korean

Persian

Portuguese

Use Cases

Website content localization

Adapt the content of your website to the destination of your visitors. Make your visitors feel right at home by "talking" to them in their local language and connect with them instantly. With IP geolocation, redirect your users to their region-specific websites and increase the possibility of increasing conversions up to 70%.

Non-intrusive geolocation

Do you have an awesome content localization strategy in place? IP geolocation is a non-intrusive way to know where your visitors are coming from. Don't ruin your visitor's website experience by showing annoying pop-ups asking for their location. Our geolocation API will detect their location from their IP address and show them the relevant message.

Digital Rights Protection

Enforce digital rights of your content using IP location API. Build a virtual fence around your content and make sure that only the people inside the fence can see it.

Prevent Threats and Scams

With our security and user agent module, you can identify anonymous traffic sources, known attackers, suspicious devices and tor nodes to prevent online fraud, trial abusers, forum spams and botnet attackers.

Ready to get started? Get Started with IP Intelligence API Today

Get Started

IP Geolocation API Documentation

Q: What information can I obtain using the IP Location API?

The IP Location API provides detailed geographical data based on IP addresses, including information like country, city, state, latitude, longitude, user’s time zone information, currency details, ISP, ASN, and organization name. You can also access threat intelligence, VPN/proxy status, and device data from the user-agent string.

Q: Does the IP Location API support batch IP address lookups?

Yes, the IP Location API supports batch IP address lookups, allowing you to query up to 50,000 IPs in a single request. However, this feature is available only on paid plans. The requests made in the batch will count towards your total API usage.

Q: Are there SDKs available for the IP Location API?

IPGeolocation offers SDKs for popular programming languages such as Java, Python, JavaScript, jQuery, TypeScript, C#, and PHP. These SDKs simplify the integration of the IP Location API into your projects. Additionally, detailed guides are available to assist with integrating the API and databases with Splunk.

Q: How frequently is the geolocation data updated?

Our IP Location API data updates every 24 hours. Our downloadable databases are available with weekly and monthly updates, providing you with the most up-to-date geolocation information.

Q: What security measures are in place for the IP Location API?

The IP Location API ensures data security with secure HTTPS connections for all API endpoints. Our infrastructure features globally distributed data and edge nodes, enhancing reliability and protection against DDoS attacks. Additionally, IPGeolocation complies with data protection regulations, including the General Data Protection Regulation (GDPR), to ensure user privacy and data security.

Q: What is IP Geolocation and how does it work?

IP Geolocation identifies the physical location of a device by analyzing its IP address along with data from internet registries, ISPs, network routing, and user reports. It helps determine key details such as country, state/region, city, ZIP code, ISP, and more. ipgeolocation.io combines multiple reliable data sources and frequent updates to deliver accurate, real-time location insights for both IPv4 and IPv6 addresses.

Q: How accurate is IP Geolocation data?

IP Geolocation is typically over 99% accurate at the country level and around 85% or higher at the city level, with a 20–50 km accuracy radius depending on the region and ISP. ipgeolocation.io maintains high accuracy by updating its database daily and using reliable data sources to deliver precise geolocation, along with ISP, timezone, and currency details.

Q: What can I use IP Geolocation for, in my application or website?

IP Geolocation helps personalize user experiences, display region-specific content, detect fraud, enforce compliance, and improve analytics. With ipgeolocation.io’s API, developers can easily integrate features like automatic timezone detection, localized content, and fraud prevention using security data such as is_bot, is_proxy, and more.

Q: What is an IP Geolocation API?

An IP Geolocation API allows applications to retrieve detailed location data about an IP address through simple API requests. ipgeolocation.io’s API returns data such as country, city, ISP, timezone, currency, and even detects VPN, proxy, and TOR usage, making it easy to enhance applications with location intelligence.

Q: How do I get an IP Geolocation API key?

You can get an API key by signing up for a free account at ipgeolocation.io. Once registered and logged into your dashboard, you’ll find your unique API key, which you can use to send requests to the API.

IP Geolocation API

IP Geolocation API provides real-time and accurate geolocation, and security information for any IPv4 or IPv6 address and domain name along with the user-agent detail for the provided user-agent string. You can geolocate your online visitors and provide them the customized user-experience accordingly.

We provide the two endpoints in our IP Lookup API to get geolocation information.

Single IP Geolocation Lookup API

Single IP Location API can be used in two ways to lookup any IP address or domain name with JSON or XML response. The URL for this endpoint is https://api.ipgeolocation.io/ipgeo and its full JSON response is below:

Response

{
  "ip": "8.8.8.8",
  "hostname": "dns.google",
  "continent_code": "NA",
  "continent_name": "North America",
  "country_code2": "US",
  "country_code3": "USA",
  "country_name": "United States",
  "country_name_official": "United States of America",
  "country_capital": "Washington, D.C.",
  "state_prov": "California",
  "state_code": "US-CA",
  "district": "Santa Clara",
  "city": "Mountain View",
  "zipcode": "94043-1351",
  "latitude": "37.42240",
  "longitude": "-122.08421",
  "is_eu": false,
  "calling_code": "+1",
  "country_tld": ".us",
  "languages": "en-US,es-US,haw,fr",
  "country_flag": "https://ipgeolocation.io/static/flags/us_64.png",
  "geoname_id": "6301403",
  "isp": "Google LLC",
  "connection_type": "",
  "organization": "Google LLC",
  "country_emoji": "🇺🇸",
  "asn": "AS15169",
  "currency": {
    "code": "USD",
    "name": "US Dollar",
    "symbol": "$"
  },
  "time_zone": {
    "name": "America/Los_Angeles",
    "offset": -8,
    "offset_with_dst": -7,
    "current_time": "2024-09-19 00:19:04.376-0700",
    "current_time_unix": 1726730344.376,
    "is_dst": true,
    "dst_savings": 1,
    "dst_exists": true,
    "dst_start": {
      "utc_time": "2024-03-10 TIME 10",
      "duration": "+1H",
      "gap": true,
      "dateTimeAfter": "2024-03-10 TIME 03",
      "dateTimeBefore": "2024-03-10 TIME 02",
      "overlap": false
    },
    "dst_end": {
      "utc_time": "2024-11-03 TIME 09",
      "duration": "-1H",
      "gap": false,
      "dateTimeAfter": "2024-11-03 TIME 01",
      "dateTimeBefore": "2024-11-03 TIME 02",
      "overlap": true
    }
  }
}

Passing an IPv4, IPv6 Address or a domain

In order to find geolocation information about an IP address or a domain name, pass it as a query parameter ip like below. Note that apiKey is also needed to be passed as a query parameter for authorization. This endpoint is meant to be called from the server side.

Passing an IPv4

Here's an example to get the geolocation information for '8.8.8.8'.

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Passing an IPv6

Here's an example to get the geolocation information for '2001:4860:4860::1'.

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Passing a Domain

Here's an example to get the geolocation information for 'dns.google.com'.

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Without Passing an IP Address

When this endpoint is queried without an IP address, it returns the geolocation information of the device/client which is calling it. This endpoint is meant to be called from client side.

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Note: apiKey parameter can also be ommitted from your API request when this endpoint is called from client side using Request Origin.

Bulk IP Geolocation Lookup API

This feature is available only on the paid API subscriptions. This endpoint allows you to perform the geolocation lookup for multiple IPv4, IPv6 addresses or domain names (maximum 50,000) at the same time. The requests count per lookup is equal to total IP addresses or domain names passed.

To perform bulk IP Geolocation Lookup, send a POST request and pass the "ips" array as JSON data along with it. Here is an example to query the geolocation data for multiple IPs at once.

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Response in Multiple Languages

The geolocation information for an IP address from the IP Geolocation API can be retrieved in the following languages

English (en)
German (de)
Russian (ru)
Japanese (ja)
French (fr)
Chinese Simplified (cn)
Spanish (es)
Czech (cs)
Italian (it)
Korean (ko)
Persian (fa)
Portuguese (pt)

By default, the API responds in English. You can change the response language by passing the language code as a query parameter lang. Here is an example to get the geolocation data for IP adderss '1.1.1.1' in Chinese language:

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Only the paid plan subscriptions can get the response in languages other than English. All the other subscriptions will only get the response in English.

Filter Responses

We've built our API to give you fine granularity. Specify what you want in query parameter and get only those fields. This will save you processing time, bandwidth and improve the API response time.

You can filter the API response in two ways:

• Get the Required Fields Only

First, you can filter the API response by specifying names of the fields that you want instead of getting the full response. Names of the required fields must be passed as a query parameter fields in the request. Here are a few examples to get only the required fields:

Get City Information Only

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Response

{
  "ip": "1.1.1.1",
  "city": "Kecamatan Margorejo"
}

Get Country Name and Country Code (ISO2) Only

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Response

{
  "ip": "1.1.1.1",
  "country_code2": "ID",
  "country_name": "Indonesia",
  "country_name_official": "Republic of Indonesia"
}

Get the Time Zone Information Only

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Response

{
  "ip": "8.8.8.8",
  "time_zone": {
    "name": "America/Los_Angeles",
    "offset": -8,
    "offset_with_dst": -7,
    "current_time": "2024-09-19 06:18:47.854-0700",
    "current_time_unix": 1726751927.854,
    "is_dst": true,
    "dst_savings": 1,
    "dst_exists": true,
    "dst_start": {
      "utc_time": "2024-03-10 TIME 10",
      "duration": "+1H",
      "gap": true,
      "dateTimeAfter": "2024-03-10 TIME 03",
      "dateTimeBefore": "2024-03-10 TIME 02",
      "overlap": false
    },
    "dst_end": {
      "utc_time": "2024-11-03 TIME 09",
      "duration": "-1H",
      "gap": false,
      "dateTimeAfter": "2024-11-03 TIME 01",
      "dateTimeBefore": "2024-11-03 TIME 02",
      "overlap": true
    }
  }
}

Get Only the Local Currency Information of Multiple IP Addresses

You can use our filters with Bulk IP Lookup as well. Here is an example:

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Response

[
  {
    "ip": "1.0.1.0",
    "currency": {
      "code": "CNY",
      "name": "Yuan Renminbi",
      "symbol": "¥"
    }
  },
  {
    "ip": "8.8.8.8",
    "currency": {
      "code": "USD",
      "name": "US Dollar",
      "symbol": "$"
    }
  }
]

Get Geolocation Information Only

We know, most of the times, users are interested in geolocation information only. So, we have added a shortcut for you. You can specify just fields=geo in your query parameter.

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Response

{
  "ip": "8.8.8.8",
  "continent_code": "NA",
  "continent_name": "North America",
  "country_code2": "US",
  "country_code3": "USA",
  "country_name": "United States",
  "country_name_official": "United States of America",
  "state_prov": "California",
  "state_code": "US-CA",
  "district": "Santa Clara",
  "city": "Mountain View",
  "zipcode": "94043-1351",
  "latitude": "37.42240",
  "longitude": "-122.08421",
  "is_eu": false
}

• Remove the Unnecessary Fields

Second, you can also filter the API response by specifying the names of fields (except IP address) that you want to remove from the API response. Names of the fields must be passed as a query parameter excludes in the request. Here are a few examples to exclude the unnecessary fields:

Exclude Continent Code, Currency and, Time zone Objects

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Response

{
  "ip": "8.8.8.8",
  "continent_name": "North America",
  "country_code2": "US",
  "country_code3": "USA",
  "country_name": "United States",
  "country_name_official": "United States of America",
  "country_capital": "Washington, D.C.",
  "state_prov": "California",
  "state_code": "US-CA",
  "district": "Santa Clara",
  "city": "Mountain View",
  "zipcode": "94043-1351",
  "latitude": "37.42240",
  "longitude": "-122.08421",
  "is_eu": false,
  "calling_code": "+1",
  "country_tld": ".us",
  "languages": "en-US,es-US,haw,fr",
  "country_flag": "https://ipgeolocation.io/static/flags/us_64.png",
  "geoname_id": "6301403",
  "isp": "Google LLC",
  "connection_type": "",
  "organization": "Google LLC",
  "country_emoji": "🇺🇸",
  "asn": "AS15169"
}

• Get the Geo Field and Exclude Continent Information

Third, You can combine the fields and excludes query parameters for fully customized API queries. This approach helps you retrieve only the necessary data while reducing response latency. Here's a sample code to demonstrate how to use both parameters effectively:

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Response

{
  "ip": "8.8.8.8",
  "country_code2": "US",
  "country_code3": "USA",
  "country_name": "United States",
  "country_name_official": "United States of America",
  "state_prov": "California",
  "state_code": "US-CA",
  "district": "Santa Clara",
  "city": "Mountain View",
  "zipcode": "94043-1351",
  "latitude": "37.42240",
  "longitude": "-122.08421"
}

IP-Security Information for an IP Address

IP Geolocation API also provides IP-Security information on all the paid subscriptions, but doesn't respond it by default. To get IP-Security information along with the geolocation information, you must pass the include=security as a query parameter in the URL.

Here is an example to IP Geolocation lookup that includes IP security information for the IP address:

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Response

{
  "ip": "8.8.8.8",
  "continent_code": "NA",
  "continent_name": "North America",
  "country_code2": "US",
  "country_code3": "USA",
  "country_name": "United States",
  "country_name_official": "United States of America",
  "state_prov": "California",
  "state_code": "US-CA",
  "district": "Santa Clara",
  "city": "Mountain View",
  "zipcode": "94043-1351",
  "latitude": "37.42240",
  "longitude": "-122.08421",
  "is_eu": false,
  "security": {
    "threat_score": 80,
    "is_tor": false,
    "is_proxy": true,
    "proxy_type": "VPN",
    "is_anonymous": true,
    "is_known_attacker": true,
    "is_spam": false,
    "is_bot": false,
    "is_cloud_provider": true
  }
}

Hostname Lookup for an IP Address

IPGeolocation API also provide hostname lookup for an IP address on all the paid subscriptions, but doesn't respond it by default. To get the hostname for an IP address, you can pass one of the three values hostname, liveHostname, hostnameFallbackLive as a URL parameter include=.

Here is an example to IP Geolocation lookup that includes hostname for the IP address:

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Response

{
  "ip": "8.8.8.8",
  "hostname": "dns.google",
  "continent_code": "NA",
  "continent_name": "North America",
  "country_code2": "US",
  "country_code3": "USA",
  "country_name": "United States",
  "country_name_official": "United States of America",
  "state_prov": "California",
  "state_code": "US-CA",
  "district": "Santa Clara",
  "city": "Mountain View",
  "zipcode": "94043-1351",
  "latitude": "37.42240",
  "longitude": "-122.08421",
  "is_eu": false
}

`include=hostname` URL Parameter

This URL parameter enables the IPGeolocation API to lookup hostname from our IP-Hostname database and returns the same IP address if there is no hostname found for the queried IP address. Lookup thru IP-Hostname database is faster than other options but is experimental and under process and can produce unwanted output.

`include=liveHostname` URL Parameter

This URL parameter enables the IPGeolocation API to lookup hostname from live sources. Lookup thru live sources is accurate but can introduce more latency to your query to IPGeolocation API

`include=hostnameFallbackLive` URL Parameter

This URL parameter enables the IPGeolocation API to lookup hostname from our IP-Hostname database and if there is no hostname found for the queried IP address, then lookup thru the live sources. This option has been introduced for faster and accurate lookup.

User-Agent Information for a Device

IP Geolocation API also provides User-Agent information of the client on all the paid subscriptions, but doesn't respond it by default. To get User-Agent information along with the geolocation information, you must pass the include=useragent as a query parameter in the URL.

Here is an example to IP Geolocation lookup that includes User-Agent information for a device from which the query originated:

Curl

Java

JQuery

Javascript

Node.js

PHP

Python

Swift

Ruby

Response

{
  "ip": "8.8.8.8",
  "continent_code": "NA",
  "continent_name": "North America",
  "country_code2": "US",
  "country_code3": "USA",
  "country_name": "United States",
  "country_name_official": "United States of America",
  "state_prov": "California",
  "state_code": "US-CA",
  "district": "Santa Clara",
  "city": "Mountain View",
  "zipcode": "94043-1351",
  "latitude": "37.42240",
  "longitude": "-122.08421",
  "is_eu": false,
  "user_agent": {
    "userAgentString": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36",
    "name": "Chrome",
    "type": "Browser",
    "version": "128",
    "versionMajor": "128",
    "device": {
      "name": "Linux Desktop",
      "type": "Desktop",
      "brand": "Unknown",
      "cpu": "Intel x86_64"
    },
    "engine": {
      "name": "Blink",
      "type": "Browser",
      "version": "128",
      "versionMajor": "128"
    },
    "operatingSystem": {
      "name": "Linux",
      "type": "Desktop",
      "version": "??",
      "versionMajor": "??"
    }
  }
}

Note: To get hostname, IP-Security information, and user-agent information together for an IP address and the device, you can pass include=hostname, security, useragent as a query parameter in the URL.

Reference to IPGeolocation API Response

Field	Type	Description	Can be empty?
domain	string	Domain name that is used to lookup geolocation information. It is not returned if an IP address is used to query IP Geolocation API.	Yes
ip	string	IP address that is used to lookup geolocation information.	No
hostname	string	Hostname of the IP address used to query IP Geolocation API.	No
continent_code	string	2-letter code of the continent.	No
continent_name	string	Name of the continent.	No
country_code2	string	Country code (ISO 3166-1 alpha-2) of the country.	No
country_code3	string	Country code (ISO 3166-1 alpha-3) of the country.	No
country_name	string	Name of the country.	No
country_name_official	string	Official name (ISO 3166) of the country.	No
country_capital	string	Name of the country’s capital.	No
state_prov	string	Name of the state/province/region.	Yes
state_code	string	Code of the state/province/region.	Yes
district	string	Name of the district or county.	Yes
city	string	Name of the city.	Yes
zipcode	string	ZIP/Postal code of the place	Yes
latitude	string	Latitude of the place.	No
longitude	string	Longitude of the place.	No
is_eu	boolean	Is the country belong to European Union?	No
calling_code	string	Calling code of the country.	No
country_tld	string	Top Level Domain Name (TLD) of the country	No
languages	string	Comma-separated list of the languages’ codes, spoken in the country.	No
country_flag	string	URL to get the country flag.	No
geoname_id	string	Geoname ID of the place from geonames.org	Yes
isp	string	Name of the ISP holding the IP address.	No
connection_type	string	Type of the connection, consuming the IP address.	Yes
organization	string	Name of AS organization holding the IP address.	Yes
country_emoji	string	Emoji of the Country flag.	Yes
asn	string	Autonomous system number of the autonomous system, to which IP address belongs to.	Yes
currency.code	string	Currency code (ISO 4217).	No
currency.name	string	Currency name (ISO 4217).	No
currency.symbol	string	Currency symbol.	No
time_zone.name	string	Name (ISO 8601) of the time zone.	No
time_zone.offset	number	Time zone offset from UTC.	No
time_zone.offset_with_dst	number	Time zone with DST offset from UTC.	No
time_zone.current_time	string	Current time in ‘yyyy-MM-dd HH:mm:ss.SSS±ZZZ’ format.	No
time_zone.current_time_unix	float	Current time in seconds since 1970.	No
time_zone.is_dst	boolean	Is the time zone in daylight savings?	No
time_zone.dst_savings	number	Total daylight savings.	No
time_zone.dst_exists	boolean	Whether Daylight Saving Time (DST) is observed in the region.	No
time_zone.dst_start.utc_time	string	The date and time in UTC when DST begins.	No
time_zone.dst_start.duration	string	The time change that occurs when DST starts.	No
time_zone.dst_start.gap	boolean	Is there a gap when the clocks jump forward or not.	No
time_zone.dst_start.dateTimeAfter	string	The local date and time that immediately follows the start of DST.	No
time_zone.dst_start.dateTimeBefore	string	The local date and time immediately before DST begins.	No
time_zone.dst_start.overlap	boolean	Whether there is an overlap of time due to clocks being set back when DST starts.	No
time_zone.dst_end.utc_time	string	The date and time in UTC when DST ends.	No
time_zone.dst_end.duration	string	The time change that occurs when DST ends.	No
time_zone.dst_end.gap	boolean	Is there a gap when the clocks jump backward or not.	No
time_zone.dst_end.dateTimeAfter	string	The local date and time that immediately follows the ends of DST.	No
time_zone.dst_end.dateTimeBefore	string	The local date and time immediately before DST ends.	No
time_zone.dst_end.overlap	boolean	Whether there is an overlap of time due to clocks being set back when DST ends.	No
security.threat_score	number	IP address’ threat score. It ranges from 0 to 100. 100 indicates highest threat and vice versa for lower score.	No
security.is_tor	boolean	Indicates if the IP address is being consumed on a Tor endpoint.	No
security.is_proxy	boolean	Indicates if the IP address belongs to a proxy networ	No
security.proxy_type	string	Type of the proxy network if the IP address belongs to a proxy network.	Yes
security.is_anonymous	boolean	Indicates if the IP address is being used anonymously.	No
security.is_known_attacker	boolean	Indicates if the IP address is enlisted as an attacking IP address.	No
security.is_spam	boolean	Indicates if the IP address is enlisted as a spam IP address.	No
security.is_bot	boolean	Indicates if the IP address is enlisted as a bot IP address.	No
security.is_cloud_provider	boolean	Indicates if the IP address belongs to a cloud provider (computing infrastructure providers).	No
user_agent.userAgentString	string	User-Agent string passed along with the query in the User-Agent header.	No
user_agent.name	string	User-Agent Name.	No
user_agent.type	string	User-Agent Class	No
user_agent.version	string	User-Agent Version.	No
user_agent.versionMajor	string	User-Agent Version Major.	No
user_agent.device.name	string	Device Name.	No
user_agent.device.type	string	Device Type.	No
user_agent.device.brand	string	Device Brand.	No
user_agent.device.cpu	string	Device CPU Model.	No
user_agent.engine.name	string	Layout Engine Name	No
user_agent.engine.type	string	Layout Engine Class	No
user_agent.engine.version	string	Layout Engine Version.	No
user_agent.engine.versionMajor	string	Layout Engine Version Major.	No
user_agent.operatingSystem.name	string	Operating System Name.	No
user_agent.operatingSystem.type	string	Operating System Class	No
user_agent.operatingSystem.version	string	Operating System Version.	No
user_agent.operatingSystem.versionMajor	string	Operating System Version Major.	No

Error Codes

IP Geolocation API returns HTTP status code 200 for a successful API request along with the response.

While, in case of a bad or invalid request, IP Geolocation API returns 4xx HTTP status code along with a descriptive message explaining the reason for the error.

Below is a detailed explanation of the specific HTTP status codes and their corresponding error conditions:

HTTP Status	Description
400 Bad Request	It is returned for one of the following reasons: If the provided IPv4, IPv6 address, or domain name is invalid. If special character(s) ( ) [ ] { } \| ^ ` is passed in the API URL either as paramter or its value. Specially in case of API key. If the IP addresses JSON list is empty, or the provided JSON does not have 'ips' field while querying `/ipgeo-bulk` endpoint. If more than 50,000 IP addresses are provided while quering from `/ipgeo-bulk` endpoint.
401 Unauthorized	It is returned for one of the following reasons: If API key (as `apiKey` URL parameter) is missing from the request to IP Geolocation API. If an invalid (a random value) API key is provided. If the API request is made from an unverified ipgeolocation.io account. If your account has been disabled or locked to use by the admin due to abuse or illegal activity. When the request to IP Geolocation API is made using API key for a database subscription When the request to IP Geolocation API is made on the 'paused' subscription. If you’re making API requests after your subscription trial has been expired. If your active until date has passed and you need to upgrade your account. If IP-hostname lookup, IP-security lookup or user-agent parsing endpoint is called using free subsciption API key. If bulk IP to geolocation look-ups endpoint is called using free subscription API key.
403 Forbidden	If IP to geolocation look-up for a domain name is done using a free subscription API key.
404 Not Found	It is returned for one of the following reasons: If the IPv4, IPv6, or domain name does not not exists in our database. If the IPv4, IPv6, or domain name is passed as a path variable, instead of url parameter as `ip=` . If the wrong endpoint is called, that does not exists in our API.
405 Method Not Allowed	If wrong HTTP request method is used for calling the endpoints. Only GET and POST methods are allowed. POST method for `/ipgeo-bulk` endpoint and GET method for `/ipgeo` endpoint requests.
413 Content Too Large	If the passed data in the POST requests is more than the limit of the API.
415 Unsupported Media Type	If the payload for IPs in `/ipgeo-bulk` endpoint is mising, or the content type is not mentioned as JSON.
423 Locked	If the passed IP address is from a bogon ip ranges, or is part of a private network.
429 Too Many Requests	It is returned for one of the following reasons: If the API usage limit has reached for the free subscriptions, or paid subscriptions with the status 'past due', 'deleted' or 'trial expired'. If the surcharge API usage limit has reached against the subscribed plan.
499 Client Closed Request	If the client has set the very short request or connection timeout, leading to the server closing the request prematurely.
5XX Server Side Error	If a `500` (Internal Server Error), `502` (Bad Gateway), `503` (Service Unavailable), `504` (Gateway Timeout), or `505` (HTTP Version Not Supported) status code is returned, it indicates an issue on our end. Please contact us with your request at support@ipgeolocation.io for further assistance.

API SDKs

To facilitate the developers, we have added some SDKs for various programming languages. The detailed documentation on how to use these SDKs is available in the respective SDK's documentation page linked below.

Our SDKs are also available on Github. Feel free to help us improve them. Following are the available SDKs:

IP Geolocation FAQs

What information can I obtain using the IP Location API?

Does the IP Location API support batch IP address lookups?

Are there SDKs available for the IP Location API?

How frequently is the geolocation data updated?

What security measures are in place for the IP Location API?

What is IP Geolocation and how does it work?

How accurate is IP Geolocation data?

What can I use IP Geolocation for, in my application or website?

What is an IP Geolocation API?

How do I get an IP Geolocation API key?

Is there a free IP Geolocation API available?

How do I integrate an IP Geolocation API into my website?

Can I track user locations in real time with an IP Geolocation API?

What’s the difference between IP Geolocation API and GPS location services?

How do I secure my IP Geolocation API to prevent misuse?

Can ipgeolocation.io's API identify attackers or spammers?

How can businesses utilize ipgeolocation.io's security data?

Does IP Location API provide real-time security information for IP addresses?

Overview
Single IP Geolocation Lookup API
Passing an IPv4, IPv6 Address or a domain
Without Passing an IP Address
Bulk IP Geolocation Lookup API
Response in Multiple Languages
Filter Responses
IP-Security Information for an IP Address
Hostname Lookup for an IP Address
User-Agent Device Info
Reference to IPGeolocation API Response
Error Codes
API SDKS
FAQs

Free IP Lookup API and Accurate IP Location Finder

IP Location Module

Response

Currency Module

Response

Time Zone Module

Response

Connection Information Module

Response

Security Module

Response

User Agent Parser Module

Response

Reverse IP Lookup Module

Response

Response

Domain IP Lookup

Response

Bulk IP Address Lookup Support

Response

Response in Multiple Languages

Use Cases

Website content localization

Non-intrusive geolocation

Digital Rights Protection

Prevent Threats and Scams

Ready to get started? Get Started with IP Intelligence API Today

IP Geolocation API Documentation

IP Geolocation API

Single IP Geolocation Lookup API

Response

Passing an IPv4, IPv6 Address or a domain

Passing an IPv4

Passing an IPv6

Passing a Domain

Without Passing an IP Address

Bulk IP Geolocation Lookup API

Response in Multiple Languages

Filter Responses

• Get the Required Fields Only

Get City Information Only

Response

Get Country Name and Country Code (ISO2) Only

Response

Get the Time Zone Information Only

Response

Get Only the Local Currency Information of Multiple IP Addresses

Response

Get Geolocation Information Only

Response

• Remove the Unnecessary Fields

Exclude Continent Code, Currency and, Time zone Objects

Response

• Get the Geo Field and Exclude Continent Information

Response

IP-Security Information for an IP Address

Response

Hostname Lookup for an IP Address

Response

include=hostname URL Parameter

include=liveHostname URL Parameter

include=hostnameFallbackLive URL Parameter

User-Agent Information for a Device

Response

Reference to IPGeolocation API Response

Error Codes

API SDKs

IP Geolocation FAQs

`include=hostname` URL Parameter

`include=liveHostname` URL Parameter

`include=hostnameFallbackLive` URL Parameter