Reveal a domain

Age in whole years.

Agent Citability score and the AI-cited sources that link to the domain. Null when the domain has no row in the current index — not a score of zero.

When we last checked that the name is unregistered. Revealing a name in the directory re-checks it on the spot; exports and this API carry the last-checked stamp rather than triggering a check of their own, so read this timestamp before acting on the row.

Banded total backlinks.

When this listing entered the directory. Written once and never rewritten, which is what `sort=latest` orders by and what makes that ordering safe to page. It is a fact about this directory, not about the domain: it is neither the registration date nor the date the name expired.

The registrable name, or NULL where it is withheld. TWO INDEPENDENT REASONS it can be null, and you cannot tell them apart from this field alone. (1) Another account holds the listing (`hold_state: "other"`) — a hold masks the name for every reader, and an unlimited reveal allowance is not an exemption from one; it comes back when their hold ends, and `hold_expires_at` says when. (2) Your plan has a monthly reveal ceiling and you have not revealed this listing: you receive names on the open tier (`tier: "open"`, published on the site anyway) and on anything you have already revealed, and a mask on the rest. `POST /domains/{id}/reveal` buys one. On a plan with no ceiling, only reason (1) applies. `mask_hint` is populated either way and is what to render. Read `tier` before republishing: only an `open` name is public.

Banded domain authority, 0-100, from our link graph. Null where we have no figure — not a score of zero.

The valuation model's low bound, in cents, falling back to the reference figure on a row the model has not valued. Nothing here is for sale. This is the SAME number `priceRange` buckets, so a band and the values it returns agree.

When the active hold on this listing ends. Null when nothing is holding it.

`none`, `mine` (held by this key's account) or `other`. A held listing stays in the directory and stays listed here; what a hold reserves is the right to take it, inside Revised. Who holds it is never disclosed. NOTE: taking, extending or ending a hold does not move `updated_at`, so an incremental `since` poll will not re-deliver a row whose hold state changed — read the listing directly, or `GET /holds` for your own.

Available options: none, mine, other

Eight characters, CASE-SENSITIVE and mixed case in practice (`00aLaXEG`, `X00w46xl`). Store it verbatim: lower-casing one will not match on the way back.

Recognisable domains that link to this one.

The public partial mask, e.g. `g▓▓▓▓▓▓farms` — true length, first letter, last word, hyphens. Always present, and the thing to render when `domain` is null. Null only for rows predating the mask backfill; `length_bucket` is the fallback shape.

Which of this row's optional metrics are NULL, by the key they are published under: `age_years`, `agent_citability`, `backlinks`, `category`, `domain_authority`. A null among those is ABSENT DATA, never a zero — an unscored domain is not a DA-0 domain — and the distinction is otherwise invisible in JSON. Empty when the row is complete. Note that the `min_*` filters exclude null rows rather than ranking them low, so a mild-looking floor can drop most of a page.

Whether `domain` holds a real registrable name. The same predicate `domain` itself is built from, so the two cannot disagree — false means `domain` is null and `mask_hint` is what to render. This is the discriminator; `mask_hint` is NOT, because it is populated on every row whether or not anything is masked. It is also not a reveal: on a plan with no reveal ceiling every name is disclosed without one having been bought.

Banded referring-domain count.

The published Revised Score range. The exact score is not part of the API.

Banded archive snapshot count, e.g. `40+`.

Available options: low, moderate

Always `active` on a full row. Branch on this to tell a listing from a tombstone.

Which shelf this listing sits on, and the only field that says whether its `domain` is PUBLIC. `open` means the name is already published on the site, in the listing page's title and in the sitemap, so you may republish it. `regular` and `featured` names are masked everywhere on the site and are disclosed to you under the API terms only — do not republish them. `featured` additionally means the curated shelf; it is not the same thing as the `featured` boolean, which reads the shelf rank and can disagree.

Available options: featured, regular, open

Feed watermark. What `since` filters on, and the version of this row: with `id` it is what makes a repeated row safe to ignore.