Developers

IP geolocation API

Location cross-checked across multiple databases with a confidence score, ASN and provider, VPN / proxy / Tor / data-center flags and batch lookups — in one fast JSON call.

# Your own IP, no key needed
$ curl v4.ipclarify.com
203.0.113.42
# Any IP, with your key
$ curl -H "Authorization: Bearer ipc_xxxxxx_…" https://v4.ipclarify.com/v1/8.8.8.8
# One field as plain text
$ curl -H "Authorization: Bearer ipc_xxxxxx_…" https://v4.ipclarify.com/v1/8.8.8.8/country
US

Plans

Free

Free

  • 30,000 requests / month
  • 30 requests / minute
  • Batch up to 25 IPs
  • Location, ASN, VPN / Tor / hosting flags
  • IP-change monitor
Start free

Business

Coming soon

  • 3,000,000 requests / month
  • 1,200 requests / minute
  • Batch up to 100 IPs
  • Location, ASN, VPN / Tor / hosting flags
  • IP-change monitor
Join the waitlist

Authentication

Send your key in the Authorization: Bearer <key> header. Keys are never accepted in the URL, because URLs end up in logs and browser history.

Endpoints

RequestReturnsKey
GET / (curl, wget)Your IP as plain textNo
GET /jsonYour full recordNo
GET /v1/{ip}Full record for any IPv4 or IPv6 addressYes
GET /v1/{ip}/{field}One field as plain text: country, city, region, asn, org, timezone, vpn, tor, hostingYes
GET /v1/meYour own record, counted against your keyYes
GET /v1/asn/{asn}Registry details for an AS numberYes
POST /v1/batchUp to your plan's batch size; body {"ips": [...]}Yes
GET /v1/usageQuota used this monthYes
POST /v1/checkinIP-change monitor (see below)Yes

Response

{
  "ip": "8.8.8.8",
  "version": 4,
  "reserved": null,
  "location": {
    "city": "Mountain View", "region": "California",
    "country": "US", "country_name": "United States", "continent": "North America",
    "lat": 37.42, "lon": -122.08, "timezone": "America/Los_Angeles", "postal": "94043",
    "confidence": 0.85, "sources_agree": 2, "sources_total": 2
  },
  "network": { "asn": 15169, "org": "Google LLC", "prefix": "8.8.8.0/24" },
  "privacy": { "vpn": false, "proxy": null, "tor": false, "hosting": false },
  "meta": { "cached": true, "db_build": "1a2b3c4d5e" }
}

confidence is 0–1: how closely independent databases agree on the location. vpn / proxy are null when we have no data rather than a confident "no". Field names never change within /v1.

IP-change monitor

Run this from a computer or router on the network you want to watch — every 5 minutes with cron, for example. We email you when the public IP changes.

curl -X POST -H "Authorization: Bearer ipc_xxxxxx_…" \
     -d "label=Home office" https://v4.ipclarify.com/v1/checkin

Errors and limits

Errors always look like {"error": {"code": "invalid_ip", "message": "…"}}. Every response includes RateLimit-Limit, RateLimit-Remaining and X-Quota-Remaining. Going over the per-minute limit returns 429 with Retry-After.

StatusCodeMeaning
401missing_key / invalid_keyNo key, or a revoked one
422invalid_ipNot a valid IPv4 or IPv6 address
404unknown_fieldField name not recognized
429rate_limited / quota_exceededSlow down, or wait for the monthly reset

All tools

Look up

Privacy & VPN

Network tools

More