Search the whole tracked pool
GET /api/v1/pool searches and filters every name Revised tracks, not just the directory. Starter and Business. Raw metrics, cursor paging.
GET /api/v1/pool searches and filters the whole tracked pool: every name Revised tracks, about 600,000, not only the curated directory. It is on Starter and Business. The Free plan is answered 402 upgrade_required with one line saying so. The MCP equivalent is search_pool.
The directory is a curated subset of the pool. To search the directory, with its Revised Score and Agent Citability, use GET /api/v1/domains.
curl "https://getrevised.com/api/v1/pool?tld=com&min_length=4&max_length=7&min_referring_domains=20&limit=100" \
-H "Authorization: Bearer $REVISED_API_KEY"What a row holds
Raw metrics and the availability stamp, never a curation verdict. There is no listing flag, tier, score, category or quality label in a row.
| Field | Meaning |
|---|---|
domain, tld, name_length | The name, its extension, and the characters before the extension. |
available, availability_checked_at | What our latest availability check said, and when. It can be days old; a name is only registrable if it is still free when you try. |
backlinks, referring_domains | Counts we hold. null means we hold none, not zero. |
traffic_best_rank, traffic_last_rank | Chrome top-list band: 1000 is top 1k. null means never in the top 1M. traffic_months, traffic_last_seen say how long. |
archive_first_seen, archive_last_seen, archive_snapshots | The web-archive capture range and count. |
Filters
All optional. A value the API cannot read is refused with 400, naming the parameter, never ignored.
| Parameter | Meaning |
|---|---|
tld | Up to 10 extensions, comma-separated: com, com,net,co.uk. |
min_length, max_length | Characters in the name before the extension, 1 to 63. |
min_referring_domains, min_backlinks | Floors. A floor matches only names that have the metric. |
max_traffic_rank | 1000, 10000, 100000 or 1000000: the best Chrome band the name has held. |
available | true (default), false or any. The default is the honest one: the pool is made of names that were available when found, and about 97% still read as available at their last check. |
first_seen_after, first_seen_before, last_seen_after, last_seen_before | Archive capture dates, YYYY-MM-DD. |
sort | domain (default), -domain, -referring_domains, -backlinks or traffic_rank (best first). A metric sort returns only names that have the metric. |
limit | Rows a page, up to your plan’s page size. Default 50. |
cursor | next_cursor from the previous page. |
There is no Domain Rating filter or field: that figure is third-party data that is not redistributed through the API.
Paging
Rows come in name order unless you pass sort. Pass next_cursor back as cursor until it is null. A cursor is signed and only continues the query that issued it: an altered one, or one used with a different filter set or sort, is refused with 400. Page size is 250 on Starter and 1000 on Business. A cursor is opaque; one the API did not issue is refused.
What is left out
The pool keeps only names that pass the directory’s safety checks: nothing on a malware, phishing, scam or advertising blocklist, no protected brands, no spam or parked-only history, no adult or gambling names. It also leaves out a name another account is holding while the hold runs, and subdomains.
If the pool has not been rebuilt for more than 24 hours the answer is 503 pool_stale: retry later.
Limits
Its own per-account ceiling applies on top of the per-key limit: 12 searches a minute on Starter, 30 on Business. Over it the answer is 429 with Retry-After. A search that times out is refused as 400: add a tld or a tighter floor. See Rate limits.
To look up one name you already have, see Look up any domain.