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.

Open dashboard

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)

GET /v1/lookup/{query}

Quick summary: type detection, ASN, prefix, country, key metadata

GET /v1/all/{query}

Full aggregate of every section in one response

GET /v1/dns/{query}

DNS records (A, AAAA, MX, NS, CNAME, TXT) or reverse DNS for IPs

GET /v1/rdap/{query}

RDAP registration data from the appropriate RIR

GET /v1/network/{query}

ASN, prefix, registry, routing context, and abuse contacts

GET /v1/geolocation/{query}

Approximate geolocation data

GET /v1/neighbours/{query}

Infrastructure and hosting context insights

GET /v1/email/{query}

Email security posture (SPF, DMARC, MX) for domains

GET /v1/certs/{query}

Certificate Transparency history for domains

GET /v1/http/{query}

HTTP/TLS probe results (domains only)

GET /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.

GET /api/lookup/summary/{query}

Summary used by the lookup interface

POST /api/bulk

Bulk lookup of many IPs/domains (used by the Bulk tool)

GET /api/my-ip

Returns the requesting client's IP address