Endpoint reference for GET /v1/tools/reverse-ip-lookup: parameters, JSON response schema, error codes, and per-IP rate limits. No API key required.

GEThttps://api.domainee.dev/v1/tools/reverse-ip-lookup?ip=8.8.8.8

Resolve PTR (reverse DNS) records for an IP address, and list other domains observed on the same address. `hostnames` is the PTR answer, which is one or more names the IP's operator published; it is never a list of the sites hosted there, because DNS cannot produce one. `sharedHosts` is that separate list, from an observed-hostname corpus, and is null when no co-hosting source is configured. Private and reserved IPs are rejected.

Free. No API key required. CORS-enabled. Rate-limited per IP at 30/min and 500/day.

Parameters

Name	In	Type	Description
`ip`required	query	`string`	IPv4 or IPv6 address. example: `8.8.8.8`

Example request

curl

curl -s "https://api.domainee.dev/v1/tools/reverse-ip-lookup?ip=8.8.8.8" | jq

Example response

response.json

{
  "ok": true,
  "data": {
    "ip": "8.8.8.8",
    "hostnames": [
      "dns.google"
    ],
    "sharedHosts": null,
    "sharedHostsStatus": "unavailable",
    "sharedHostsNote": "No co-hosting data source is configured, so this result is the PTR record only."
  }
}

Other languages

fetch.js

const res = await fetch("https://api.domainee.dev/v1/tools/reverse-ip-lookup?ip=8.8.8.8");
const { ok, data } = await res.json();

requests.py

import requests
r = requests.get(
    "https://api.domainee.dev/v1/tools/reverse-ip-lookup",
    params={"ip":"8.8.8.8"},
)
data = r.json()["data"]

Rate limits & errors

30 requests/minute and 500 requests/day per IP. Exceeding either returns HTTP 429 with a Retry-After header.
All responses are JSON with the envelope { "ok": true, "data": {...} } on success or { "ok": false, "error": { "code", "message" } } on failure.
code values are stable; safe to switch on programmatically. message is human-friendly and may change.

Reverse IP Lookup API Reference

Parameters

Example request

Example response

Other languages

Rate limits & errors

See also

On this page