Get one domain
One listing by id. Carries its real name where you are entitled to it — see the `domain` field. 404 once a listing leaves the directory, and 404 as well while a listing is newer than your plan's access delay.
/api/v1/domains/{id}One listing by id. Carries its real name where you are entitled to it — see the `domain` field. 404 once a listing leaves the directory, and 404 as well while a listing is newer than your plan's access delay.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path parameters
idstringrequiredA listing id, exactly as the feed issued it: eight characters, CASE-SENSITIVE — `00aLaXEG`, not `00alaxeg`.
Example: 00aLaXEG
Responses
The listing.
age_yearsanyAge in whole years.
agent_citabilityanyAgent 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.
availability_checked_atstring (date-time)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.
backlinksanyBanded total backlinks.
categoryanydiscovered_atstring (date-time)requiredWhen 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.
domainanyrequiredThe 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.
domain_authorityanyBanded domain authority, 0-100, from our link graph. Null where we have no figure — not a score of zero.
estimated_value_centsintegerrequiredThe 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.
featuredbooleanhold_expires_atanyWhen the active hold on this listing ends. Null when nothing is holding it.
hold_state"none" | "mine" | "other"required`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
idstringrequiredEight characters, CASE-SENSITIVE and mixed case in practice (`00aLaXEG`, `X00w46xl`). Store it verbatim: lower-casing one will not match on the way back.
length_bucketstringlinked_bystring[]Recognisable domains that link to this one.
mask_hintanyrequiredThe 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.
metrics_missingstring[]requiredWhich 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.
name_disclosedbooleanrequiredWhether `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.
referring_domainsanyBanded referring-domain count.
revised_scoreobjectThe published Revised Score range. The exact score is not part of the API.
snapshotsstringBanded archive snapshot count, e.g. `40+`.
spam"low" | "moderate"Available options: low, moderate
statusstringrequiredAlways `active` on a full row. Branch on this to tell a listing from a tombstone.
tier"featured" | "regular" | "open"requiredWhich 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
tldstringrequiredupdated_atstring (date-time)requiredFeed watermark. What `since` filters on, and the version of this row: with `id` it is what makes a repeated row safe to ignore.
word_countintegercurl --request GET \
--url "https://getrevised.com/api/v1/domains/00aLaXEG" \
--header "Authorization: Bearer YOUR_API_KEY"{
"age_years": {},
"agent_citability": {
"score": 123,
"sources": []
},
"availability_checked_at": "2023-11-07T05:31:56Z",
"backlinks": {},
"category": {},
"discovered_at": "2023-11-07T05:31:56Z",
"domain": {},
"domain_authority": {},
"estimated_value_cents": 123,
"featured": true,
"hold_expires_at": {},
"hold_state": "none",
"id": "<string>",
"length_bucket": "<string>",
"linked_by": [],
"mask_hint": {},
"metrics_missing": [],
"name_disclosed": true,
"referring_domains": {},
"revised_score": {
"high": 123,
"low": 123
},
"snapshots": "<string>",
"spam": "low",
"status": "<string>",
"tier": "featured",
"tld": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"word_count": 123
}