Look up any domain by name
GET /api/v1/lookup returns what Revised holds on any domain you type — backlinks and linking sites, traffic rank, Agent Citability, registration and expiry, archive history. Every plan.
GET /api/v1/lookup?domain=example.com returns what Revised holds on one domain, in one response. It is open to every plan, Free included, and it works for any name: whether or not the name is a listing in the directory.
It returns the same data the free web tools show for a typed name. It reads the name you send and nothing else, so the response has the same shape for every name and carries no listing status, tier, score or label. The MCP equivalent is lookup_domain.
curl "https://getrevised.com/api/v1/lookup?domain=example.com" \
-H "Authorization: Bearer $REVISED_API_KEY"Response
Every key is always present. A section we hold nothing for is null, which says nothing about the name itself: it means our data is empty for it.
| Field | What it holds |
|---|---|
domain | The registrable name the answer is for. A subdomain is reduced to it. |
backlinks | summary (backlinks, dofollow, referring domains, referring pages, as_of), crawl totals, linking_domains (up to 25, with link counts and link type), top_linking_domains, inlink_count. |
traffic | The Chrome top-list band history: current_bucket, best_bucket, first_seen, last_seen, months_present, trend. in_list: false means never in the top 1M since the list began, not zero traffic. |
citability | Agent Citability score and the seed_links behind it. null means no AI-cited links: none of our trusted seed sites link to the name. |
registration | A live registry and DNS check: phase, availability, registry_state, registered_at, expires_at, days_until_expiry, registrar, statuses. It can take a few seconds. |
archive | First and last web-archive capture and the snapshot count. |
authority | Inlink and referring-domain counts from our crawl. |
unavailable | Names of sections that failed to load right now. Retry later. |
Limits
Its own per-account ceiling applies on top of the per-key limit: 10 a minute on Free, 60 on Starter, 120 on Business. Free also has a daily cap of 500 lookups, counted over the UTC day, so a key cannot read the dataset one lookup at a time. Over either limit the answer is 429 with Retry-After. See Rate limits.
Errors
400 invalid_request for a path, port, query, IP address or anything that is not a domain name. 401 without a key. 429 over a limit. See Errors.
To find names by filters rather than look one up, see Search the tracked pool.