← Docs

IP Address API

Where an IP is from, country, ASN, network.

Look up where an IP is coming from. Country, continent, ASN, and network name come back in the core response. IPv4 and IPv6.

On paid plans, ?deep=true adds datacenter, relay, and Tor flags, plus state and city where the network operator publishes them.

Lookup

GET
api.parseapi.com/ip/{ip}
Country, continent, ASN. Paid deep adds geo depth and flags
curl "https://api.parseapi.com/ip/8.8.8.8" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "ip": "8.8.8.8",
  "country": "US",
  "country_name": "United States",
  "continent": "NA",
  "asn": "AS15169",
  "asn_name": "Google LLC"
}

Response fields

ip
Queried IP address
country
ISO 3166-1 alpha-2 code
country_name
Country name
continent
Continent code
asn
Autonomous system number
asn_name
Network operator / organization name

Your IP

GET /ip returns the IP that made the request. No key needed.

GET
api.parseapi.com/ip
Same lookup, using the caller's address. No key needed
curl "https://api.parseapi.com/ip"
{
  "ip": "203.0.113.10",
  "country": "US",
  "country_name": "United States",
  "continent": "NA",
  "asn": "AS15169",
  "asn_name": "Google LLC"
}

Deep

Paid. State and city come from operator-published geofeeds, empty when not published. Flags come straight from official provider publications: cloud and CDN address space (datacenter), Apple Private Relay egress (relay), and known Tor exits (tor), refreshed daily.

curl "https://api.parseapi.com/ip/52.94.76.10?deep=true" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "ip": "52.94.76.10",
  "country": "US",
  "country_name": "United States",
  "continent": "NA",
  "asn": "AS16509",
  "asn_name": "Amazon.com, Inc.",
  "deep": {
    "state": "OR",
    "city": "Boardman",
    "registry": "arin",
    "datacenter": true,
    "relay": false,
    "tor": false,
    "provider": "aws"
  }
}

Deep fields

deep.state
State / province code from geofeed (ISO 3166-2 cleaned to ADM1)
deep.city
City (operator-published geofeed)
deep.registry
Regional internet registry (arin, ripencc, apnic, lacnic, afrinic)
deep.datacenter
Cloud or CDN address space (AWS, GCP, Azure, Oracle, Cloudflare, Fastly)
deep.relay
Privacy relay egress (Apple iCloud Private Relay)
deep.tor
Known Tor exit node
deep.provider
Provider behind the flag (aws, gcp, azure, oracle, cloudflare, fastly, apple)

Questions? Email