Filters

GET /api/v1/domains takes three kinds of query parameter: the paging trio, the ordering, and the filters. This page documents all of them. Filtering is free — reading a page never spends a reveal, whatever it matched.

Values are refused, not ignored. A parameter listed here, carrying a value it cannot honour, is 400 invalid_request naming the parameter and what it accepts. A silently dropped filter would return more rows than you asked for, which is a bigger and plausible-looking page with no way to detect it. Parameters not listed here are ignored, so tracking and cache-busting keys are safe to leave on the query string.

Paging and ordering

Documented in full on Pagination and sync.

Filters

ageMin

Minimum age of the domain in whole years. Integer, 0 to 100.

Rows whose age_years is null never match, so ageMin=1 does not mean “at least a year old” — it means “at least a year old and the age is known”. Age is one of the metrics most often absent, which makes this the filter most likely to cut a shelf harder than intended. Check metrics_missing on the rows you do get back.

curl "https://getrevised.com/api/v1/domains?ageMin=10&limit=50" \
  -H "Authorization: Bearer $REVISED_API_KEY"

category

One category code, or several comma-separated. Lower case, hyphens — for example fitness, education, saas.

curl "https://getrevised.com/api/v1/domains?category=saas,education" \
  -H "Authorization: Bearer $REVISED_API_KEY"

There is no closed list of codes, and none is published: read them off a page of results rather than guessing. The codes are Revised’s own, not a user’s words — marketing and software are not among them. Some listings carry no category at all — they are in the directory and every other filter reaches them, but no category value returns them.

checkedDays

Only listings whose availability was re-checked within this many days. Integer, 1 to 3650.

availability_checked_at is a stamp, not a live check: reading a listing does not re-check it, and revealing one does. Use this filter when you are about to act on rows and want recent confirmation that the name is still unregistered.

curl "https://getrevised.com/api/v1/domains?checkedDays=7" \
  -H "Authorization: Bearer $REVISED_API_KEY"

citabilityMin

Minimum Agent Citability score — how often sources that AI assistants cite link to this domain. Integer, 0 to 100.

Listings with no citability row never match. Absence is not a zero; it means the domain has no row in the current index.

featured

Boolean. Restricts to the curated shelf.

This reads the shelf rank, which is not the same thing as the featured value of the tier field, and the two can disagree. To select by shelf, use tier.

priceRange

Estimated-value band. One of:

Bucketed on the same figure the response reports as estimated_value_cents, so filtering by a band and reading the values back agree. Nothing in the directory is for sale by Revised; this is a valuation, not a price.

q

Free text, 1 to 80 characters.

Filter structurally — category, tld, a metric floor — before reaching for text. Whitespace-only input reads as no search rather than an error.

rd

Referring-domain band, by band id. Comma-separate for several. The ids are not the band strings a row reports in referring_domains — those contain < and +, which percent-encode into unreadable URLs.

curl "https://getrevised.com/api/v1/domains?rd=lt10,250plus" \
  -H "Authorization: Bearer $REVISED_API_KEY"

recommended

Boolean. Only listings that pass Revised’s own heuristic: a category of any kind (including the literal other), at least one recognisable linking site, and a Revised Score floor.

rsMin and rsMax

Revised Score bounds, integers 0 to 100. rsMin is compared against the low end of each listing’s published range.

The exact score is not part of the API — revised_score is published as a range at every tier, so any two listings are comparable.

curl "https://getrevised.com/api/v1/domains?rsMin=60&rsMax=85" \
  -H "Authorization: Bearer $REVISED_API_KEY"

Every listing has a Revised Score, so unlike the other floors this one excludes nothing for being unknown.

source

Linking-source display name. Comma-separate for several. Case is preserved, unlike the other list parameters, so send the name as it appears on a row.

These are the recognisable sites that link to a listing — the same values that appear in the linked_by array. Observed examples: Hacker News, Wikipedia, Medium, United Nations, Cornell University, FCC. There is no endpoint that enumerates them; read them off linked_by.

curl "https://getrevised.com/api/v1/domains?source=Hacker%20News,Wikipedia" \
  -H "Authorization: Bearer $REVISED_API_KEY"

spam

Spam band ceiling. One of low or moderate.

tier

Which shelf. On this endpoint the only accepted value is open.

curl "https://getrevised.com/api/v1/domains?tier=open&limit=250" \
  -H "Authorization: Bearer $REVISED_API_KEY"

tier=open is the cheapest slice of the directory to work with: open names are published on the Revised website anyway, so they arrive populated on every plan, revealing one spends nothing, and they are the only names you may republish. See Republication.

A single-value enum rather than a boolean, so the URL says what it selects. Rows come back carrying tier values of open, regular or featured; the filter selects open only. To select regular or featured, use the MCP search_domains tool, whose tier argument takes all three.

tld

Exact TLD without the leading dot — com, org, com.au. Comma-separate for several.

curl "https://getrevised.com/api/v1/domains?tld=com.au,com&rsMin=50" \
  -H "Authorization: Bearer $REVISED_API_KEY"

Comma-separated lists

category, rd, source and tld take several values, comma-joined, and match any of them. An item the API cannot read is refused — the response names which item went and what one of that kind has to look like — rather than being dropped from the list.

Combining filters

Filters combine with AND. Start structural and narrow from there.

import os, requests

BASE = "https://getrevised.com/api/v1"
AUTH = {"Authorization": f"Bearer {os.environ['REVISED_API_KEY']}"}

res = requests.get(
    f"{BASE}/domains",
    headers=AUTH,
    params={
        "tier": "open",          # names disclosed on every plan, republishable
        "tld": "com",
        "rsMin": 60,
        "spam": "low",
        "checkedDays": 30,       # confirmed unregistered in the last month
        "limit": 250,
    },
    timeout=30,
).json()

for row in res["data"]:
    print(row["id"], row["domain"], row["revised_score"], row["referring_domains"])

00aLaXEG  greenfieldfarms.com  {'low': 61, 'high': 70}  100-500
X00w46xl  tidewaterlabs.com    {'low': 64, 'high': 70}  50-100

Every parameter on this page is also in the OpenAPI document, with its JSON Schema constraints.