Domains in an address range
domains_in_rangeRead-onlyIdempotent
Reverse lookup across a small CIDR range: which hostnames have been observed on any address in it. NEEDS AN API KEY ON THE PLUS PLAN OR ABOVE.
THE RANGE IS CAPPED AT 256 ADDRESSES: an IPv4 /24 or narrower. Ask for /24s, and issue several calls rather than one wide one. Paging works as in domains_on_ip.
The same caution as domains_on_ip applies more strongly here: names sharing a /24 usually share a hosting provider and nothing else.
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": {
"cidr": "<cidr>"
},
"name": "domains_in_range"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cidr | Yes | A CIDR range covering at most 256 addresses, e.g. "8.8.8.0/24". | |
| 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 |