IP API Responses Developer Resource
Below is a description of all the information you'll get for the various plans we offer:
Free Plan
The free plan includes the geolocation information for an IP address and basic ASN details.
curl ipinfo.io/66.87.125.72/json?token=$TOKEN
{
"ip": "66.87.125.72",
"hostname": "ip-66-87-125-72.spfdma.spcsdns.net",
"city": "Springfield",
"region": "Massachusetts",
"country": "US",
"loc": "42.1015,-72.5898",
"org": "AS10507 Sprint Personal Communications Systems",
"postal": "01101",
"timezone": "America/New_York"
}
If the IP is anycast or bogon an additional field is returned indicating that.
Basic Plan
In addition to higher request limit, the basic plan also includes IP network flags and ASN details.
is_anonymous: Indicates whether the IP address is anonymous.trueif the IP address is associated with an IP privacy service, such as a VPN, proxy, Tor, or relay. This provides a high-level summary flag from our IP to Privacy API response.is_hosting: Indicates whether the IP address is an internet service hosting IP address. This information is separately derived from our IP to Privacy database.is_anycast: Indicates whether the IP address is an anycast IP.trueif the IP address maps to multiple physical servers in different locations via anycast routing.is_mobile: Indicates whether the IP address belongs to a mobile network.trueif the IP address is associated with a cellular network, carrier, or mobile device. This information is from our carrier IP API service.is_satellite: Indicates whether the IP address is part of a satellite internet connection.trueif the IP address belongs to a satellite internet pool.
curl ipinfo.io/8.8.8.8/json?token=$TOKEN
{
"ip": "8.8.8.8",
"hostname": "dns.google",
"city": "Mountain View",
"region": "California",
"country": "US",
"loc": "37.4056,-122.0775",
"org": "AS15169 Google LLC",
"postal": "94043",
"timezone": "America/Los_Angeles",
"is_anycast": true,
"is_mobile": false,
"is_anonymous": false,
"is_satellite": false,
"is_hosting": true,
"asn": {
"asn": "AS15169",
"name": "Google LLC",
"domain": "google.com",
"route": "8.8.8.0/24",
"type": "hosting"
}
}
The type field is one of either business, education, hosting or isp to indicate the ASN organization type.
The Basic Plan also supports ASN lookups:
https://ipinfo.io/AS18952?token=$TOKEN
{
"asn": "AS18952",
"name": "Big Valley of Pomo Indians of the Big Valley Rancheria California",
"country": "US",
"allocated": "2017-08-30",
"registry": "arin",
"domain": "big-valley.net",
"num_ips": 512,
"type": "government",
"prefixes": [
{
"netblock": "162.208.96.0/24",
"id": "BVR-NETS",
"name": "Big Valley of Pomo Indians of the Big Valley Rancheria California",
"country": "US",
"size": "256",
"status": "ALLOCATION",
"domain": "big-valley.net"
},
{
"netblock": "162.208.98.0/24",
"id": "BVR-NETS",
"name": "Big Valley of Pomo Indians of the Big Valley Rancheria California",
"country": "US",
"size": "256",
"status": "ALLOCATION",
"domain": "big-valley.net"
}
],
"prefixes6": [],
"peers": [
"7018"
],
"upstreams": [
"7018"
],
"downstreams": null
}
Standard Plan
In addition to higher request limit, the standard plan also includes privacy details.
curl ipinfo.io/8.8.8.8/json?token=$TOKEN
{
"ip": "8.8.8.8",
"hostname": "dns.google",
"anycast": true,
"city": "Mountain View",
"region": "California",
"country": "US",
"loc": "37.4056,-122.0775",
"postal": "94043",
"timezone": "America/Los_Angeles",
"asn": {
"asn": "AS15169",
"name": "Google LLC",
"domain": "google.com",
"route": "8.8.8.0/24",
"type": "business"
},
"privacy": {
"vpn": false,
"proxy": false,
"tor": false,
"relay": false,
"hosting": false,
"service": ""
}
}
Business Plan
Our business plan includes access to multiple data fields besides ASN and geolocation, including privacy, abuse, company, carrier and limited domains hosted on the IP.
curl ipinfo.io/8.8.8.8/json?token=$TOKEN
{
"ip": "8.8.8.8",
"hostname": "dns.google",
"anycast": true,
"city": "Mountain View",
"region": "California",
"country": "US",
"loc": "37.4056,-122.0775",
"postal": "94043",
"timezone": "America/Los_Angeles",
"asn": {
"asn": "AS15169",
"name": "Google LLC",
"domain": "google.com",
"route": "8.8.8.0/24",
"type": "hosting"
},
"company": {
"name": "Google LLC",
"domain": "google.com",
"type": "hosting"
},
"privacy": {
"vpn": false,
"proxy": false,
"tor": false,
"relay": false,
"hosting": true,
"service": ""
},
"abuse": {
"address": "US, CA, Mountain View, 1600 Amphitheatre Parkway, 94043",
"country": "US",
"email": "network-abuse@google.com",
"name": "Abuse",
"network": "8.8.8.0/24",
"phone": "+1-650-253-0000"
},
"domains": {
"ip": "8.8.8.8",
"total": 9791,
"domains": [
"musicool.cn",
"kagou.vip",
"nmgk2.com",
"91xiazai.com",
"bits-hyderabad.ac.in"
]
}
}
You can also query domains data separately. Check how you can find domains hosted on IP using Hosted Domains API.
curl ipinfo.io/domains/8.8.8.8?token=$TOKEN
{
"ip": "8.8.8.8",
"total": 11606,
"domains": [
"41.cn",
"onionflix.cc",
"newmax.info",
"ftempurl.com",
"itempurl.com"
]
}
Enterprise Plan
Our enterprise plan includes access to everything in business plan plus IP Whois, IP Ranges, IP Activity and full domains hosted on the IP.
IP Ranges API
curl ipinfo.io/ranges/comcast.net?token=$TOKEN
{
"domain": "comcast.net",
"num_ranges": "37330",
"ranges": [
"23.24.240.0/29",
"23.24.240.64/29",
"23.24.240.128/28",
"23.24.240.152/29",
"23.24.240.168/29",
"23.24.240.192/29",
"23.24.240.208/29",
"23.24.241.40/29",
"23.24.241.72/29",
"23.24.241.96/29",
"23.24.241.112/28",
"23.24.241.136/29",
"23.24.241.168/29",
"23.24.241.184/29",
...
]
}
Hosted Domains API
The Hosted Domains API in the Enterprise plan includes higher limits. Whereas in the business plan, you can only get five domains per page, in the enterprise plan, you can get up to 1000 domains.
curl ipinfo.io/domains/8.8.8.8?token=$TOKEN
{
"ip": "8.8.8.8",
"total": "37330",
"domains": [
"41.cn",
"onionflix.cc",
"newmax.info",
"ftempurl.com",
"itempurl.com",
"authrock.com",
"ctempurl.com",
"mtqnia.com",
"server-panel.net",
"gtempurl.com",
"htempurl.com",
...
]
}
