IP2Location.io IP Geolocation API

Overview

IP2Location.io provides RESTful API allowing users to check IP address location in real time. The REST API supports both IPv4 and IPv6 address lookup.

The API does not requires any API key to work, but it has limitation. It is free for up to 1,000 queries daily. If you need more queries, you can sign up for a Free Plan and get an API key with just a few clicks!

What data you can get:

Location & Geography

country, region, district, city, ZIP code, latitude & longitude, time zone.

Network & Connectivity

ASN (Autonomous System Number), AS (Autonomous system (AS) name), AS domain Name, AS usage type, AS CIDR, ISP (Internet Service Provider), domain, net speed, IDD code, area code, address type, usage type.

Mobile Information

MNC (Mobile Network Code), MCC (Mobile Country Code), Mobile Brand.

Currency & Language

currency code, currency name, currency symbol, language code, language name.

Proxy & Security

proxy type, last seen, threat level/type, proxy provider, fraud score.

Others

IAB category, weather, elevation, population and more.

Get Full Access to Advanced Data

Try 7-Days Free Trial »

Get Started With Free Plan

Sign Up Free Account »

Rate Limiting

An API rate limit refers to the maximum number of API calls that can be made within a specific time period. IP2Location.io allows you to perform up to 1,000 queries per day without the need to sign up for an API key (keyless). Once this limit is reached, any additional API calls will fail until the time period resets at 00:00 UTC daily.

If you wish to remove the daily rate limit and perform more than 1,000 queries per day, you can get started by signing up for our to obtain an API key. It's free, and with this plan, you are able to make up to 50,000 queries per month.

Below is the command to perform the keyless query:

https://api.ip2location.io/?ip=8.8.8.8

Authentication

To authenticate your API requests, you can either include your API key as bearer token or URL parameter.

Below is the command to perform the authenticated query:

# With API key as URL parameter
curl "https://api.ip2location.io/?ip=8.8.8.8&key={YOUR_API_KEY}"


# With API key as Bearer token
curl -H "Authorization: Bearer {YOUR_API_KEY}" https://api.ip2location.io/?ip=8.8.8.8

Parameters

The REST API calling syntax. Please see the table below for the description of each parameter.

Name Description
key (required) API key.
ip (required) IP address (IPv4 or IPv6) for reverse IP location lookup purposes. If not present, the server IP address will be used for the location lookup.
format (optional) Format of the response message.
Valid value: json | xml

If unspecified, json format will be used for the response message.
lang (optional) Translation information(ISO639-1). The translation is only applicable for continent, country, region and city name.
Valid value: ar | cs | da | de | en | es | et | fi | fr | ga | it | ja | ko | ms | nl | pt | ru | sv | tr | vi | zh-cn | zh-tw

You can only specify one language value for the returns.

Note: This parameter is only available for Plus and Security plan only.

API Endpoint

The IP2Location.io API supports json(default) and xml response formats. Please find the sample response of all plans below.

Get started with our free API and build smarter solutions with ease. Or, get full access with 7 Days Free Trial Plan.

Query String 
https://api.ip2location.io/?key={YOUR_API_KEY}&ip=8.8.8.8&format=json
Response
{
	"ip":"8.8.8.8",
	"country_code":"US",
	"country_name":"United States of America",
	"region_name":"California",
	"city_name":"Mountain View",
	"latitude":37.38605,
	"longitude":-122.08385,
	"zip_code":"94035",
	"time_zone":"-07:00",
	"asn":"15169",
	"as":"Google LLC",
	"is_proxy":false
}
https://api.ip2location.io/?key={YOUR_API_KEY}&ip=8.8.8.8&format=xml
Response
<result>
	<ip>8.8.8.8</ip>
	<country_code>US</country_code>
	<country_name>United States of America</country_name>
	<region_name>California</region_name>
	<city_name>Mountain View</city_name>
	<latitude>37.38605</latitude>
	<longitude>-122.08385</longitude>
	<zip_code>94035</zip_code>
	<time_zone>-07:00</time_zone>
	<asn>15169</asn>
	<as>Google LLC</as>
	<is_proxy>false</is_proxy>
</result>

Field & Object Explanation

The REST API returns the following fields and values.

Field Description
ip IP address
country_code Two-character country code based on ISO 3166.
country_name Country name based on ISO 3166.
region_name Region or state name.
city_name City name.
latitude City latitude. Defaults to capital city latitude if city is unknown.
longitude City longitude. Defaults to capital city longitude if city is unknown.
zip_code ZIP/Postal code.
time_zone UTC time zone (with DST supported).
asn Autonomous system number (ASN).
as Autonomous system (AS) name.

For a full list of fields, refer to the Field Reference section below.

Query String 
https://api.ip2location.io/?key={YOUR_API_KEY}&ip=8.8.8.8&format=json
Response
{
	"ip":"8.8.8.8",
	"country_code":"US",
	"country_name":"United States of America",
	"region_name":"California",
	"city_name":"Mountain View",
	"latitude":37.38605,
	"longitude":-122.08385,
	"zip_code":"94035",
	"time_zone":"-07:00",
	"asn":"15169",
	"as":"Google LLC",
	"isp":"Google LLC",
	"domain":"google.com",
	"net_speed":"T1",
	"idd_code":"1",
	"area_code":"650",
	"weather_station_code":"USCA0746",
	"weather_station_name":"Mountain View",
	"elevation":32,
	"usage_type":"DCH",
	"is_proxy":false
}
https://api.ip2location.io/?key={YOUR_API_KEY}&ip=8.8.8.8&format=xml
Response
<result>
	<ip>8.8.8.8</ip>
	<country_code>US</country_code>
	<country_name>United States of America</country_name>
	<region_name>California</region_name>
	<city_name>Mountain View</city_name>
	<latitude>37.38605</latitude>
	<longitude>-122.08385</longitude>
	<zip_code>94035</zip_code>
	<time_zone>-07:00</time_zone>
	<asn>15169</asn>
	<as>Google LLC</as>
	<isp>Google LLC</isp>
	<domain>google.com</domain>
	<net_speed>T1</net_speed>
	<idd_code>1</idd_code>
	<area_code>650</area_code>
	<weather_station_code>USCA0746</weather_station_code>
	<weather_station_name>Mountain View</weather_station_name>
	<elevation>32</elevation>
	<usage_type>DCH</usage_type>
	<is_proxy>false</is_proxy>
</result>

Field & Object Explanation

Includes all fields from Free Plan, plus:

{
	"isp":"Google LLC",
	"domain":"google.com",
	"net_speed":"T1",
	"idd_code":"1",
	"area_code":"650",
	"weather_station_code":"USCA0746",
	"weather_station_name":"Mountain View",
	"elevation":32,
	"usage_type":"DCH",
}
Field Description
isp Internet Service Provider or company's name.
domain Internet domain name associated with IP address range.
net_speed Internet connection type.
DIAL = dial-up, DSL = broadband/cable/fiber/mobile, COMP = corporate, T1 = data center/transit, SAT = satellite
idd_code The IDD prefix to call the city from another country.
area_code A varying length number assigned to geographic areas for calls between cities.
weather_station_code The special code to identify the nearest weather observation station.
weather_station_name The name of the nearest weather observation station.
elevation Average height of city above sea level in meters (m).
usage_type Usage type classification of ISP or company
(COM) Commercial
(ORG) Organization
(GOV) Government
(MIL) Military
(EDU) University/College/School
(LIB) Library
(CDN) Content Delivery Network
(ISP) Fixed Line ISP
(MOB) Mobile ISP
(DCH) Data Center/Web Hosting/Transit
(SES) Search Engine Spider
(AIC) AI Crawler
(RSV) Reserved

Represents an ISP that offers both fixed-line and mobile internet services. These ranges are classified as “ISP/MOB”.

For a full list of fields, refer to the Field Reference section below.

Query String 
https://api.ip2location.io/?key={YOUR_API_KEY}&ip=8.8.8.8&format=json&lang=ko
Response
{
	"ip":"8.8.8.8",
	"country_code":"US",
	"country_name":"United States of America",
	"region_name":"California",
	"city_name":"Mountain View",
	"latitude":37.38605,
	"longitude":-122.08385,
	"zip_code":"94035",
	"time_zone":"-07:00",
	"asn":"15169",
	"as":"Google LLC",
	"isp":"Google LLC",
	"domain":"google.com",
	"net_speed":"T1",
	"idd_code":"1",
	"area_code":"650",
	"weather_station_code":"USCA0746",
	"weather_station_name":"Mountain View",
	"mcc":"-",
	"mnc":"-",
	"mobile_brand":"-",
	"elevation":32,
	"usage_type":"DCH",
	"address_type":"Anycast",
	"continent":{
		"name":"North America",
		"code":"NA",
		"hemisphere":["north","west"],
		"translation":{
			"lang":"ko",
			"value":"북아메리카"
		}
	},
	"country":{
		"name":"United States of America",
		"alpha3_code":"USA",
		"numeric_code":840,
		"demonym":"Americans",
		"flag":"https://cdn.ip2location.io/assets/img/flags/us.png",
		"capital":"Washington, D.C.",
		"total_area":9826675,
		"population":339665118,
		"currency":{
			"code":"USD",
			"name":"United States Dollar",
			"symbol":"$"
		},
		"language":{
			"code":"EN",
			"name":"English"
		},
		"tld":"us",
		"translation":{
			"lang":"ko",
			"value":"미국"
		}
	},
	"region":{
		"name":"California",
		"code":"US-CA",
		"translation":{
			"lang":"ko",
			"value":"캘리포니아주"
		}
	},
	"city":{
		"name":"Mountain View",
		"translation":{
			"lang":null,
			"value":null
		}
	},
	"time_zone_info":{
		"olson": "America/Los_Angeles",
		"current_time": "2025-07-16T19:06:49-07:00",
		"gmt_offset": -25200,
		"is_dst": true,
		"abbreviation": "PDT",
		"dst_start_date": "2025-03-09",
		"dst_end_date": "2025-11-02",
		"sunrise": "06:00",
		"sunset": "20:29"
	},
	"geotargeting":{
		"metro":"807"
	},
	"is_proxy":false
}
https://api.ip2location.io/?key={YOUR_API_KEY}&ip=8.8.8.8&format=xml&lang=ko
Response
<result>
	<ip>8.8.8.8</ip>
	<country_code>US</country_code>
	<country_name>United States of America</country_name>
	<region_name>California</region_name>
	<city_name>Mountain View</city_name>
	<latitude>37.38605</latitude>
	<longitude>-122.08385</longitude>
	<zip_code>94035</zip_code>
	<time_zone>-07:00</time_zone>
	<asn>15169</asn>
	<as>Google LLC</as>
	<isp>Google LLC</isp>
	<domain>google.com</domain>
	<net_speed>T1</net_speed>
	<idd_code>1</idd_code>
	<area_code>650</area_code>
	<weather_station_code>USCA0746</weather_station_code>
	<weather_station_name>Mountain View</weather_station_name>
	<mcc>-</mcc>
	<mnc>-</mnc>
	<mobile_brand>-</mobile_brand>
	<elevation>32</elevation>
	<usage_type>DCH</usage_type>
	<address_type>Anycast</address_type>
	<continent>
		<name>North America</name>
		<code>NA</code>
		<hemisphere>
			<item>north</item>
			<item>west</item>
		</hemisphere>
		<translation>
			<lang>ko</lang>
			<value>북아메리카</value>
		</translation>
	</continent>
	<country>
		<name>United States of America</name>
		<alpha3_code>USA</alpha3_code>
		<numeric_code>840</numeric_code>
		<demonym>Americans</demonym>
		<flag>https://cdn.ip2location.io/assets/img/flags/us.png</flag>
		<capital>Washington, D.C.</capital>
		<total_area>9826675</total_area>
		<population>339665118</population>
		<currency>
			<code>USD</code>
			<name>United States Dollar</name>
			<symbol>$</symbol>
		</currency>
		<language>
			<code>EN</code>
			<name>English</name>
		</language>
		<tld>us</tld>
		<translation>
			<lang>ko</lang>
			<value>미국</value>
		</translation>
	</country>
	<region>
		<name>California</name>
		<code>US-CA</code>
		<translation>
			<lang>ko</lang>
			<value>캘리포니아주</value>
		</translation>
	</region>
	<city>
		<name>Mountain View</name>
		<translation>
			<lang/>
			<value/>
		</translation>
	</city>
	<time_zone_info>
		<olson>America/Los_Angeles</olson>
		<current_time>2025-07-16T19:06:49-07:00</current_time>
		<gmt_offset>-25200</gmt_offset>
		<is_dst>true</is_dst>
		<abbreviation>PDT</abbreviation>
		<dst_start_date>2025-03-09</dst_start_date>
		<dst_end_date>2025-11-02</dst_end_date>
		<sunrise>06:00</sunrise>
		<sunset>20:29</sunset>>
	</time_zone_info>
	<geotargeting>
		<metro>807</metro>
	</geotargeting>
	<is_proxy>false</is_proxy>
</result>

Field & Object Explanation

Includes all fields from Starter Plan, plus:

{
	"mcc":"-",
	"mnc":"-",
	"mobile_brand":"-",
}
Field Description
mcc Mobile Country Codes (MCC) as defined in ITU E.212 for use in identifying mobile stations in wireless telephone networks, particularly GSM and UMTS networks.
mnc Mobile Network Code (MNC) is used in combination with a Mobile Country Code (MCC) to uniquely identify a mobile phone operator or carrier.
mobile_brand Commercial brand associated with the mobile carrier. 
{
	"address_type":"Anycast"
}
Field Description
address_type IP address types as defined in Internet Protocol version 4 (IPv4) and Internet Protocol version 6 (IPv6).
(A) Anycast - One to the closest
(U) Unicast - One to one
(M) Multicast - One to multiple
(B) Broadcast - One to all		 
"continent":{
	"name":"North America",
	"code":"NA",
	"hemisphere":["north","west"],
	"translation":{
		"lang":"ko",
		"value":"북아메리카"
	}
}
Field Description
continent (Continent Object)
name Continent name.
code Two-character continent code.
hemisphere The hemisphere of where the country located. The data in array format with first item indicates (north/south) hemisphere and second item indicates (east/west) hemisphere information.
translation Translation data based on the given lang code. 
"country":{
	"name":"United States of America",
	"alpha3_code":"USA",
	"numeric_code":840,
	"demonym":"Americans",
	"flag":"https://cdn.ip2location.io/assets/img/flags/us.png",
	"capital":"Washington, D.C.",
	"total_area":9826675,
	"population":339665118,
	"currency":{
		"code":"USD",
		"name":"United States Dollar",
		"symbol":"$"
	},
	"language":{
		"code":"EN",
		"name":"English"
	},
	"tld":"us",
	"translation":{
		"lang":"ko",
		"value":"미국"
	}
}
Field Description
country (Country Object)
name Country name based on ISO 3166.
alpha3_code Three-character country code based on ISO 3166.
numeric_code Three-character country numeric code based on ISO 3166.
demonym Native of the country
flag URL of the country flag image.
capital Capital of the country.
total_area Total area in km2.
population Population of the country.
currency Currency of the country
language Language of the country
tld Country-Code Top-Level Domain.
translation Translation data based on the given lang code. 
"region":{
	"name":"California",
	"code":"US-CA",
	"translation":{
		"lang":"ko",
		"value":"캘리포니아주"
	}
}
Field Description
region (Region Object)
name Region or state name.
code ISO3166-2 code.
translation Translation data based on the given lang code. 
"city":{
	"name":"Mountain View",
	"translation":{
		"lang":null,
		"value":null
	}
}
Field Description
city (City Object)
name City name.
translation Translation data based on the given lang code. 
"time_zone_info":{
	"olson": "America/Los_Angeles",
	"current_time": "2025-07-16T19:06:49-07:00",
	"gmt_offset": -25200,
	"is_dst": true,
	"abbreviation": "PDT",
	"dst_start_date": "2025-03-09",
	"dst_end_date": "2025-11-02",
	"sunrise": "06:00",
	"sunset": "20:29"
}
Field Description
time_zone_info (Time Zone Info Object)
olson Time zone in Olson format.
current_time Current time in ISO 8601 format.
gmt_offset GMT offset value in seconds.
is_dst Indicate if the time zone value is in DST.
abbreviation The time zone abbreviation of the Olson time zone, for example EST and EEST.
dst_start_date The date (UTC) of Daylight Saving Time (DST) begins.
dst_end_date The date (UTC) of Daylight Saving Time (DST) ends.
sunrise Time of sunrise. (hh:mm format in local time, i.e, 07:47)
sunset Time of sunset. (hh:mm format in local time, i.e 19:50) 
"geotargeting":{
	"metro":"807"
}
Field Description
geotargeting (Geotargeting Object)
metro Metro code based on zip/postal code.

For a full list of fields, refer to the Field Reference section below.

Query String 
https://api.ip2location.io/?key={YOUR_API_KEY}&ip=8.8.8.8&format=json&lang=ko
Response
{
	"ip":"8.8.8.8",
	"country_code":"US",
	"country_name":"United States of America",
	"region_name":"California",
	"district":"Santa Clara County",
	"city_name":"Mountain View",
	"latitude":37.38605,
	"longitude":-122.08385,
	"zip_code":"94035",
	"time_zone":"-07:00",
	"asn":"15169",
	"as":"Google LLC",
	"as_info": {
		"as_number": "15169",
		"as_name": "Google LLC",
		"as_domain": "google.com",
		"as_usage_type": "DCH",
		"as_cidr": "8.8.8.0/24"
	},
	"isp":"Google LLC",
	"domain":"google.com",
	"net_speed":"T1",
	"idd_code":"1",
	"area_code":"650",
	"weather_station_code":"USCA0746",
	"weather_station_name":"Mountain View",
	"mcc":"-",
	"mnc":"-",
	"mobile_brand":"-",
	"elevation":32,
	"usage_type":"DCH",
	"address_type":"Anycast",
	"ads_category": "IAB19-11",
	"ads_category_name": "Data Centers",
	"continent":{
		"name":"North America",
		"code":"NA",
		"hemisphere":["north","west"],
		"translation":{
			"lang":"ko",
			"value":"북아메리카"
		}
	},
	"country":{
		"name":"United States of America",
		"alpha3_code":"USA",
		"numeric_code":840,
		"demonym":"Americans",
		"flag":"https://cdn.ip2location.io/assets/img/flags/us.png",
		"capital":"Washington, D.C.",
		"total_area":9826675,
		"population":339665118,
		"currency":{
			"code":"USD",
			"name":"United States Dollar",
			"symbol":"$"
		},
		"language":{
			"code":"EN",
			"name":"English"
		},
		"tld":"us",
		"translation":{
			"lang":"ko",
			"value":"미국"
		}
	},
	"region":{
		"name":"California",
		"code":"US-CA",
		"translation":{
			"lang":"ko",
			"value":"캘리포니아주"
		}
	},
	"city":{
		"name":"Mountain View",
		"translation":{
			"lang":null,
			"value":null
		}
	},
	"time_zone_info":{
		"olson": "America/Los_Angeles",
		"current_time": "2025-07-16T19:06:49-07:00",
		"gmt_offset": -25200,
		"is_dst": true,
		"abbreviation": "PDT",
		"dst_start_date": "2025-03-09",
		"dst_end_date": "2025-11-02",
		"sunrise": "06:00",
		"sunset": "20:29"
	},
	"geotargeting":{
		"metro":"807"
	},

	"is_proxy":false,
	"fraud_score":0,
	"proxy":{
		"last_seen":13,
		"proxy_type":"DCH",
		"threat":"-",
		"provider":"-",
		"is_vpn":false,
		"is_tor":false,
		"is_data_center":true,
		"is_public_proxy":false,
		"is_web_proxy":false,
		"is_web_crawler":false,
		"is_ai_crawler":false,
		"is_residential_proxy":false,
		"is_consumer_privacy_network":false,
		"is_enterprise_private_network":false,
		"is_spammer":false,
		"is_scanner":false,
		"is_botnet":false,
		"is_bogon":false
	}
}
https://api.ip2location.io/?key={YOUR_API_KEY}&ip=8.8.8.8&format=xml&lang=ko
Response
<result>
	<ip>8.8.8.8</ip>
	<country_code>US</country_code>
	<country_name>United States of America</country_name>
	<region_name>California</region_name>
	<district>Santa Clara County</district>
	<city_name>Mountain View</city_name>
	<latitude>37.38605</latitude>
	<longitude>-122.08385</longitude>
	<zip_code>94035</zip_code>
	<time_zone>-07:00</time_zone>
	<asn>15169</asn>
	<as>Google LLC</as>
	<as_info>
		<as_number>15169</as_number>
		<as_name>Google LLC</as_name>
		<as_domain>google.com</as_domain>
		<as_usage_type>DCH</as_usage_type>
		<as_cidr>8.8.8.0/24</as_cidr>
	</as_info>
	<isp>Google LLC</isp>
	<domain>google.com</domain>
	<net_speed>T1</net_speed>
	<idd_code>1</idd_code>
	<area_code>650</area_code>
	<weather_station_code>USCA0746</weather_station_code>
	<weather_station_name>Mountain View</weather_station_name>
	<mcc>-</mcc>
	<mnc>-</mnc>
	<mobile_brand>-</mobile_brand>
	<elevation>32</elevation>
	<usage_type>DCH</usage_type>
	<address_type>Anycast</address_type>
	<ads_category>IAB19-11</ads_category>
	<ads_category_name>Data Centers</ads_category_name>
	<continent>
		<name>North America</name>
		<code>NA</code>
		<hemisphere>
			<item>north</item>
			<item>west</item>
		</hemisphere>
		<translation>
			<lang>ko</lang>
			<value>북아메리카</value>
		</translation>
	</continent>
	<country>
		<name>United States of America</name>
		<alpha3_code>USA</alpha3_code>
		<numeric_code>840</numeric_code>
		<demonym>Americans</demonym>
		<flag>https://cdn.ip2location.io/assets/img/flags/us.png</flag>
		<capital>Washington, D.C.</capital>
		<total_area>9826675</total_area>
		<population>339665118</population>
		<currency>
			<code>USD</code>
			<name>United States Dollar</name>
			<symbol>$</symbol>
		</currency>
		<language>
			<code>EN</code>
			<name>English</name>
		</language>
		<tld>us</tld>
		<translation>
			<lang>ko</lang>
			<value>미국</value>
		</translation>
	</country>
	<region>
		<name>California</name>
		<code>US-CA</code>
		<translation>
			<lang>ko</lang>
			<value>캘리포니아주</value>
		</translation>
	</region>
	<city>
		<name>Mountain View</name>
		<translation>
			<lang/>
			<value/>
		</translation>
	</city>
	<time_zone_info>
		<olson>America/Los_Angeles</olson>
		<current_time>2025-07-16T19:06:49-07:00</current_time>
		<gmt_offset>-25200</gmt_offset>
		<is_dst>true</is_dst>
		<abbreviation>PDT</abbreviation>
		<dst_start_date>2025-03-09</dst_start_date>
		<dst_end_date>2025-11-02</dst_end_date>
		<sunrise>06:00</sunrise>
		<sunset>20:29</sunset>>
	</time_zone_info>
	<geotargeting>
		<metro>807</metro>
	</geotargeting>
	<is_proxy>false</is_proxy>
	<fraud_score>0</fraud_score>
	<proxy>
		<last_seen>13</last_seen>
		<proxy_type>DCH</proxy_type>
		<threat>-</threat>
		<provider>-</provider>
		<is_vpn>false</is_vpn>
		<is_tor>false</is_tor>
		<is_data_center>true</is_data_center>
		<is_public_proxy>false</is_public_proxy>
		<is_web_proxy>false</is_web_proxy>
		<is_web_crawler>false</is_web_crawler>
		<is_ai_crawler>false</is_ai_crawler>
		<is_residential_proxy>false</is_residential_proxy>
		<is_consumer_privacy_network>false</is_consumer_privacy_network>
		<is_enterprise_private_network>false</is_enterprise_private_network>
		<is_spammer>false</is_spammer>
		<is_scanner>false</is_scanner>
		<is_botnet>false</is_botnet>
		<is_bogon>false</is_bogon>
	</proxy>
</result>

Field & Object Explanation

Includes all fields from Plus Plan, plus:

"as_info": {
	"as_number": "15169",
	"as_name": "Google LLC",
	"as_domain": "google.com",
	"as_usage_type": "DCH",
	"as_cidr": "8.8.8.0/24"
}
Field Description
as_info (AS Info Object)
as_name Autonomous system (AS) name.
as_number Autonomous system number (ASN).
as_domain Domain name of the AS registrant.
as_cidr CIDR range for the whole AS.
as_usage_type Usage type of the AS registrant. 
"proxy":{
	"last_seen":13,
	"proxy_type":"DCH",
	"threat":"-",
	"provider":"-",
	"is_vpn":false,
	"is_tor":false,
	"is_data_center":true,
	"is_public_proxy":false,
	"is_web_proxy":false,
	"is_web_crawler":false,
	"is_ai_crawler":false,
	"is_residential_proxy":false,
	"is_consumer_privacy_network":false,
	"is_enterprise_private_network":false,
	"is_spammer":false,
	"is_scanner":false,
	"is_botnet":false,
	"is_bogon":false
}
Field Description
proxy (Proxy Object)
last_seen Proxy last seen in days.
proxy_type Type of proxy.
(VPN) Virtual Private Networks
(TOR) Tor Exit Nodes
(DCH) Hosting Providers, Data Centers or Content Delivery Networks
(PUB) Public Proxies
(WEB) Web Proxies
(SES) Search Engine Robots
(AIC) AI Crawler
(RES) Residential Proxies
(CPN) Consumer Privacy Networks
(EPN) Enterprise Private Networks
threat Security threat reported.
(SPAM) Email and forum spammers
(SCANNER) Network security scanners
(BOTNET) Malware infected devices
(BOGON) Unassigned or illegitimate IP addresses announced via BGP.
provider Name of VPN provider if available.
is_vpn Anonymizing VPN services.
is_tor Tor Exit Nodes.
is_data_center Hosting Provider, Data Center or Content Delivery Network.
is_public_proxy Public Proxies.
is_web_proxy Web Proxies.
is_web_crawler Search Engine Robots.
is_ai_crawler Specifically identifies IP addresses used by artificial intelligence companies to crawl the web for LLM training data or real-time retrieval (RAG).
is_residential_proxy Residential proxies.
is_spammer Email and forum spammers.
is_scanner Network security scanners.
is_botnet Malware infected devices.
is_bogon Unassigned or illegitimate IP addresses announced via BGP.
is_consumer_privacy_network Consumer Privacy Networks.
is_enterprise_private_network Enterprise Private Networks. 
{
	"fraud_score":0,
}
Field Description
fraud_score Potential risk score (0 - 99) associated with IP address. A higher IP2Proxy Fraud Score indicates a greater likelihood of fraudulent activity and a lower reputation. 
{
	"ads_category": "IAB19-11",
	"ads_category_name": "Data Centers",
}
Field Description
ads_category The domain category code based on IAB Tech Lab Content Taxonomy.
ads_category_name The domain category based on IAB Tech Lab Content Taxonomy. These categories are comprised of Tier-1 and Tier-2 (if available) level categories widely used in services like advertising, Internet security and filtering appliances. 
{
	"district":"Santa Clara County",
}
Field Description
district District or county name.

For a full list of fields, refer to the Field Reference section below.

Field Reference

The REST API returns the following fields and values.

Field Description
ip IP address
country_code Two-character country code based on ISO 3166.
country_name Country name based on ISO 3166.
region_name Region or state name.
city_name City name.
latitude City latitude. Defaults to capital city latitude if city is unknown.
longitude City longitude. Defaults to capital city longitude if city is unknown.
zip_code ZIP/Postal code.
time_zone UTC time zone (with DST supported).
asn Autonomous system number (ASN).
as Autonomous system (AS) name.
as_info (AS Info Object)
as_name Autonomous system (AS) name.
as_number Autonomous system number (ASN).
as_domain Domain name of the AS registrant.
as_cidr CIDR range for the whole AS.
as_usage_type Usage type of the AS registrant.
isp Internet Service Provider or company's name.
domain Internet domain name associated with IP address range.
net_speed Internet connection type.
DIAL = dial-up, DSL = broadband/cable/fiber/mobile, COMP = corporate, T1 = data center/transit, SAT = satellite
idd_code The IDD prefix to call the city from another country.
area_code A varying length number assigned to geographic areas for calls between cities.
weather_station_code The special code to identify the nearest weather observation station.
weather_station_name The name of the nearest weather observation station.
mcc Mobile Country Codes (MCC) as defined in ITU E.212 for use in identifying mobile stations in wireless telephone networks, particularly GSM and UMTS networks.
mnc Mobile Network Code (MNC) is used in combination with a Mobile Country Code (MCC) to uniquely identify a mobile phone operator or carrier.
mobile_brand Commercial brand associated with the mobile carrier.
elevation Average height of city above sea level in meters (m).
usage_type Usage type classification of ISP or company
(COM) Commercial
(ORG) Organization
(GOV) Government
(MIL) Military
(EDU) University/College/School
(LIB) Library
(CDN) Content Delivery Network
(ISP) Fixed Line ISP
(MOB) Mobile ISP
(DCH) Data Center/Web Hosting/Transit
(SES) Search Engine Spider
(AIC) AI Crawler
(RSV) Reserved

Represents an ISP that offers both fixed-line and mobile internet services. These ranges are classified as “ISP/MOB”.
address_type IP address types as defined in Internet Protocol version 4 (IPv4) and Internet Protocol version 6 (IPv6).
(A) Anycast - One to the closest
(U) Unicast - One to one
(M) Multicast - One to multiple
(B) Broadcast - One to all
ads_category The domain category code based on IAB Tech Lab Content Taxonomy.
ads_category_name The domain category based on IAB Tech Lab Content Taxonomy. These categories are comprised of Tier-1 and Tier-2 (if available) level categories widely used in services like advertising, Internet security and filtering appliances.
district District or county name.
continent (Continent Object)
name Continent name.
code Two-character continent code.
hemisphere The hemisphere of where the country located. The data in array format with first item indicates (north/south) hemisphere and second item indicates (east/west) hemisphere information.
translation Translation data based on the given lang code.
country (Country Object)
name Country name based on ISO 3166.
alpha3_code Three-character country code based on ISO 3166.
numeric_code Three-character country numeric code based on ISO 3166.
demonym Native of the country
flag URL of the country flag image.
capital Capital of the country.
total_area Total area in km2.
population Population of the country.
currency Currency of the country
language Language of the country
tld Country-Code Top-Level Domain.
translation Translation data based on the given lang code.
region (Region Object)
name Region or state name.
code ISO3166-2 code.
translation Translation data based on the given lang code.
city (City Object)
name City name.
translation Translation data based on the given lang code.
time_zone_info (Time Zone Info Object)
olson Time zone in Olson format.
current_time Current time in ISO 8601 format.
gmt_offset GMT offset value in seconds.
is_dst Indicate if the time zone value is in DST.
abbreviation The time zone abbreviation of the Olson time zone, for example EST and EEST.
dst_start_date The date (UTC) of Daylight Saving Time (DST) begins.
dst_end_date The date (UTC) of Daylight Saving Time (DST) ends.
sunrise Time of sunrise. (hh:mm format in local time, i.e, 07:47)
sunset Time of sunset. (hh:mm format in local time, i.e 19:50)
geotargeting (Geotargeting Object)
metro Metro code based on zip/postal code.
is_proxy A indicator that tells you whether the IP address belongs to a known proxy, VPN, Tor exit node, or other types of masking services.
fraud_score Potential risk score (0 - 99) associated with IP address. A higher IP2Proxy Fraud Score indicates a greater likelihood of fraudulent activity and a lower reputation.
proxy (Proxy Object)
last_seen Proxy last seen in days.
proxy_type Type of proxy.
(VPN) Virtual Private Networks
(TOR) Tor Exit Nodes
(DCH) Hosting Providers, Data Centers or Content Delivery Networks
(PUB) Public Proxies
(WEB) Web Proxies
(SES) Search Engine Robots
(AIC) AI Crawler
(RES) Residential Proxies
(CPN) Consumer Privacy Networks
(EPN) Enterprise Private Networks
threat Security threat reported.
(SPAM) Email and forum spammers
(SCANNER) Network security scanners
(BOTNET) Malware infected devices
(BOGON) Unassigned or illegitimate IP addresses announced via BGP.
provider Name of VPN provider if available.
is_vpn Anonymizing VPN services.
is_tor Tor Exit Nodes.
is_data_center Hosting Provider, Data Center or Content Delivery Network.
is_public_proxy Public Proxies.
is_web_proxy Web Proxies.
is_web_crawler Search Engine Robots.
is_ai_crawler Specifically identifies IP addresses used by artificial intelligence companies to crawl the web for LLM training data or real-time retrieval (RAG).
is_residential_proxy Residential proxies.
is_spammer Email and forum spammers.
is_scanner Network security scanners.
is_botnet Malware infected devices.
is_bogon Unassigned or illegitimate IP addresses announced via BGP.
is_consumer_privacy_network Consumer Privacy Networks.
is_enterprise_private_network Enterprise Private Networks.

Field & Object Availability by Plan

Let's compare fields and object availability by plan.

Feature / Object Free Starter Plus Security
Basic Geolocation Data
  • IP Address
  • Country, Region, City
  • Latitude & Longitude
  • ZIP Code
  • Time Zone
Basic Autonomous System AS Info
  • ASN (Autonomous System Name)
  • AS (Autonomous System)
Basic Proxy Detection
Advanced Geolocation Data
  • ISP
  • Domain
  • Net Speed
  • IDD Code, Area Code
  • Weather Station Info
  • Elevation
  • Usage Type
Comprehensive Geolocation Data
  • Continent Object
  • Country Object
  • Region Object
  • Time Zone Info Object
  • Geotargeting Object
Mobile Data
  • MCC
  • MNC
  • Mobile Brand
Address Type Info
Advanced Autonomous System AS Data
  • AS Number
  • AS Name
  • AS Domain
  • AS Usage Type
  • AS CIDR
Complete Proxy Detection
  • Proxy Object
IP2Proxy Fraud Score
Advertising Category Info
District Info

Error Object & Codes

An Error object will be returned for any error encountered. For example:

{
	"error":{
		"error_code":10001,
		"error_message":"Invalid IP address."
	}
}

Below is the complete list of the error code and message returned by the IP2Location.io API.

Error Code Error Message
10000 Invalid API key or insufficient query.
10001 Invalid IP address.
10002 Internal server error.
10003 Invalid language code.
10004 Translation is not available with your plan.

Unlock Location Insights For Free

Empower your applications with accurate IP geolocation information now.

Try It for Free
IP2Location.io IP Geolocation API
Dive in and experience accurate IP geolocation API for FREE!
Get FREE Trial