API Responses

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 more 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",
  "asn": {
    "asn": "AS10507",
    "name": "Sprint Personal Communications Systems",
    "domain": "sprint.net",
    "route": "66.87.125.0/24",
    "type": "isp"
  }
}

The type field is one of either business, education, hosting or isp.

Business Plan

Our business plan includes access to multiple data fields besides ASN and geolocation, including privacy, abuse, company, carrier and 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": "business"
  },
  "company": {
    "name": "Google LLC",
    "domain": "google.com",
    "type": "business"
  },
  "privacy": {
    "vpn": false,
    "proxy": false,
    "tor": false,
    "hosting": false
  },
  "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": 11606,
    "domains": [
        "41.cn",
        "onionflix.cc",
        "newmax.info",
        "ftempurl.com",
        "itempurl.com"
    ]
  }
}

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"
  ]
}

Premium Plan

The premium plan, in addition to the data in business plan, also includes access to IP Ranges API and higher limits on Hosted Domains API.

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"
  },
  "company": {
    "name": "Google LLC",
    "domain": "google.com",
    "type": "business"
  },
  "privacy": {
    "vpn": false,
    "proxy": false,
    "tor": false,
    "hosting": false
  },
  "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": 11606,
    "domains": [
        "41.cn",
        "onionflix.cc",
        "newmax.info",
        "ftempurl.com",
        "itempurl.com"
    ]
  }
}

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 Premium plan includes higher limits. Whereas in the business plan, you can only get five domains per page, in the premium 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",
    ...
   ]
}