API
A stable, versioned JSON API for IP and domain intelligence. Authenticate with an API key and call the /v1 endpoints below.
Get an API key
Sign in to create keys and track your usage.
Authentication
Send your key as a bearer token. The X-Api-Key header and a ?key= query parameter are also accepted for quick tests.
curl https://ipneighbour.com/v1/lookup/8.8.8.8 \
-H "Authorization: Bearer ipn_your_key_here"
Public endpoints (/v1)
/v1/lookup/{query}
Quick summary: type detection, ASN, prefix, country, key metadata
/v1/all/{query}
Full aggregate of every section in one response
/v1/dns/{query}
DNS records (A, AAAA, MX, NS, CNAME, TXT) or reverse DNS for IPs
/v1/rdap/{query}
RDAP registration data from the appropriate RIR
/v1/network/{query}
ASN, prefix, registry, routing context, and abuse contacts
/v1/geolocation/{query}
Approximate geolocation data
/v1/neighbours/{query}
Infrastructure and hosting context insights
/v1/email/{query}
Email security posture (SPF, DMARC, MX) for domains
/v1/certs/{query}
Certificate Transparency history for domains
/v1/http/{query}
HTTP/TLS probe results (domains only)
/v1/me
Your key's tier, rate limit, quota, and current usage
Response format
Lookup endpoints return an envelope: { "query", "endpoint", "data" }, where data carries the result (with source, confidence, and timestamp fields where applicable). Errors return an error key with a human-readable message.
Rate limits & quotas
Each key is rate-limited per minute at its tier ceiling and metered against a monthly quota. Every response carries X-RateLimit-Limit / X-RateLimit-Remaining, and (where a quota applies) X-Quota-Limit / X-Quota-Remaining. Exceeding either returns 429 with a retry_after field; a missing or revoked key returns 401.
Internal endpoints
These power the website itself and are rate-limited per IP — no key required, but they are not versioned and may change.
/api/lookup/summary/{query}
Summary used by the lookup interface
/api/bulk
Bulk lookup of many IPs/domains (used by the Bulk tool)
/api/my-ip
Returns the requesting client's IP address