Domains on an address
domains_on_ipReverse lookup: which hostnames have been observed resolving to one IP address. NEEDS AN API KEY ON THE PLUS PLAN OR ABOVE.
Returns the hostname, its registrable domain, and when the pairing was first and last seen. A hosting or CDN address can carry a very long tail of unrelated names: co-location on an address is not evidence of a relationship between the domains, and should not be reported as one.
last_seen is when the pairing was last confirmed. An old last_seen means the name has moved or stopped resolving, not that it still points here.
A busy address holds more names than one reply: send after="" to walk all of them in stable order, passing each reply's next_cursor back as after. Accepts IPv4 and IPv6; for a range use domains_in_range.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ip": "<ip>"
},
"name": "domains_on_ip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ip | Yes | A single IPv4 or IPv6 address, e.g. "157.240.17.8". | |
| after | No | Paging. Send an EMPTY string to start a stable walk in key order, then pass each reply's next_cursor back here. Omit it for the most recently seen names first, which cannot be paged. | |
| limit | No | Maximum hostnames to return. Default 500, maximum 50000. | |
| first_seen_to | No | Only hostnames first observed at or before this time. Pair with first_seen_from to isolate a provisioning window. | |
| first_seen_from | No | Only hostnames FIRST observed at this address at or after this time. RFC3339 or YYYY-MM-DD, UTC. It narrows the answer, not the work: use it to cut the number of pages. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | ||
| hosts | Yes | ||
| limit | Yes | ||
| order | No | recent (last seen first, not pageable) or key (stable; page with next_cursor). | |
| query | Yes | ||
| addresses | Yes | How many addresses were searched. | |
| truncated | Yes | True when the limit cut the result short. | |
| next_cursor | No | Present when another page exists. Pass it as after. | |
| first_seen_to | No | ||
| first_seen_from | No |