URL: /docs/api/pool

---
title: "Search the whole tracked pool"
sidebarTitle: Search the pool
description: GET /api/v1/pool searches and filters every name Revised tracks, not just the directory. Starter and Business. Raw metrics, cursor paging.
icon: database
---

`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`](/docs/mcp/tools#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`](/docs/api/filters).

```bash
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](/docs/api/rate-limits).

To look up one name you already have, see [Look up any domain](/docs/api/lookup).