IP API Responses Developer Resource
Below is a description of all the information you'll get for the various plans we offer:
IPinfo Core
In addition to higher request limit, the IPinfo core 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 data.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 https://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",
"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, government or isp to indicate the ASN organization type.
The IPinfo Core also supports ASN lookups:
curl 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 https://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": ""
}
}
IPinfo Business
Our IPinfo 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 https://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 https://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"
]
}
IPinfo Enterprise
Our IPinfo Enterprise plan includes access to everything in IPinfo Business plan plus IP Whois, IP Ranges, IP Activity and full domains hosted on the IP.
IP Ranges API
curl https://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 IPinfo Enterprise plan includes higher limits. Whereas in the IPinfo Business plan, you can only get five domains per page, in the IPinfo Enterprise plan, you can get up to 1000 domains.
curl https://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",
...
]
}
