URL: /docs/api/lookup

---
title: "Look up any domain by name"
sidebarTitle: Look up a domain
description: 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.
icon: search
---

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

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

To find names by filters rather than look one up, see [Search the tracked pool](/docs/api/pool).