API
Consulte o mesmo banco de dados de domínios de forma programática.
Autenticação
Envie sua chave de API como token Bearer (ou no cabeçalho X-API-Key). Criar uma chave de API
curl -H "Authorization: Bearer sk_…" \ "https://namester.ai/api/v1/domains?view=auction&tld=com&maxPrice=100&sort=ends_at&order=asc"
- Acesso e limites de taxa: a API faz parte do Pro e do Max. A cota por hora do seu plano vale para todas as suas chaves somadas (Pro 25,000/hora, Max 100,000/hora), além de uma proteção contra picos por chave de 600 requisições/minuto. Toda resposta traz cabeçalhos X-RateLimit-* para a janela de uma hora; o 429 inclui Retry-After. Chaves de uma conta Grátis recebem 402 "API access requires a paid plan".
- Usa Claude, Cursor ou outro assistente de IA? Conecte a mesma chave ao Servidor MCP
- As respostas são JSON com os campos code, message e data; code 0 significa sucesso.
- A paginação é baseada em keyset: envie nextCursor de volta como cursor até que ele seja null.
- Preços em USD, horários em UTC (ISO 8601).
- Especificação legível por máquina: /api/v1/openapi.json
GET/api/v1/domains
Lista domínios. Mesmos filtros da página /domains; filtros de planos pagos retornam 403 sem um plano pago.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| q | string | Palavras-chave Keywords; every token must appear in the label (name without the suffix). |
| anyOf | string (csv) | Contém qualquer uma de Comma-separated tokens; at least one must appear in the label. |
| exclude | string (csv) | Excluir Comma-separated tokens that must not appear in the label. |
| startsWith | string | Começa com Label starts with this text. |
| endsWith | string | Termina com Label ends with this text. |
| view | all | auction | closeout | buy_now | make_offer | pre_release | pending_delete | deleted | registered | all = every domain with an active listing (best offer); a listing kind = one row per active listing of that kind; deleted / registered = registry drop events. |
| tld | string (csv) | Extensões Comma-separated public suffixes, e.g. com,io,co.uk. |
| tldGroup | legacy_gtld | cctld | new_gtld | private (csv) | Grupo de extensões Comma-separated: legacy_gtld, cctld, new_gtld, private. |
| source | namecheap | godaddy | dynadot | sedo | dropcatch | gname | catched | czds | registry-se | registry-pl | registry-uk | registry-au (csv) | Fonte Comma-separated data sources. |
| minPrice | number 0–1000000000 | Preço mín. Minimum price in USD (best offer in view=all, the listing price otherwise). |
| maxPrice | number 0–1000000000 | Preço máx. Maximum price in USD. |
| minLength | integer 1–63 | Comprimento mín. Minimum label length (characters, IDN decoded). |
| maxLength | integer 1–63 | Comprimento máx. Maximum label length. |
| noHyphen | boolean | Sem hífens Exclude labels with a hyphen. |
| noDigit | boolean | Sem números Exclude labels with a digit. |
| onlyDigits | boolean | Só números Only all-digit labels. |
| idn | exclude | include | only | IDN IDN handling: exclude, include (default) or only. |
| pattern | string | Padrão Character pattern: C consonant, V vowel, N digit, H hyphen, L any letter. E.g. CVCV, LLLL. |
| minWords | integer 1–3 | Mín. de palavras Minimum dictionary words in the label (1–3). |
| maxWords | integer 1–3 | Máx. de palavras Maximum dictionary words in the label (1–3). |
| dictionary | boolean | Uma única palavra de dicionário Label is exactly one dictionary word. |
| endingWithin | integer 1–720 | Termina em até Ends within N hours. |
| minScore | integer 0–100 | Pontuação mín. Minimum Namester Score (0–100). |
| maxScore | integer 0–100 | Pontuação máx. Maximum Namester Score. |
| minAge | integer 0–50 | Idade mín. (anos) Minimum age in years. |
| minBids | integer 0–10000 | Mín. de lances Minimum bids (total across listings in view=all). |
| minBacklinksPago | integer 0–1000000000 | Mín. de backlinks Minimum backlinks. Paid plans only (403 otherwise). |
| minDrPago | integer 0–100 | DR mín. Minimum Ahrefs DR. Paid plans only (403 otherwise). |
| minTfPago | integer 0–100 | TF mín. Minimum Majestic Trust Flow. Paid plans only (403 otherwise). |
| minCfPago | integer 0–100 | CF mín. Minimum Majestic Citation Flow. Paid plans only (403 otherwise). |
| minTrafficPago | integer 0–1000000000 | Tráfego mín. Minimum estimated monthly traffic. Paid plans only (403 otherwise). |
| minTldsTakenPago | integer 0–2000 | Mín. de outros TLDs (acompanhados) Minimum number of other TLDs of the same label in our data (TLDs we track, not registry totals). Paid plans only (403 otherwise). |
| minSearchVolumePago | integer 0–1000000000 | Volume de busca mín. Minimum monthly search volume reported by a supplier. Paid plans only (403 otherwise). |
| minBirthYear | integer 1985–2100 | Ano de criação a partir de Earliest registration year (where a source reports it). |
| maxBirthYear | integer 1985–2100 | Ano de criação até Latest registration year. |
| minWaybackYear | integer 1996–2100 | Primeiro ano no Wayback a partir de Earliest first Wayback Machine capture year (only names with Wayback data). |
| maxWaybackYear | integer 1996–2100 | Primeiro ano no Wayback até Latest first Wayback capture year. |
| minWaybackAge | integer 0–50 | Idade mín. no Wayback (anos) Minimum years since the first Wayback capture (only names with Wayback data). |
| days | integer 1–90 | Últimos deleted / registered views: look-back window in days (default 7). |
| sort | score | price | ends_at | length | bids | name | age | first_seen | Sort field. Sorting by a field that can be empty (price, ends_at, age, bids) only returns rows where it is set. deleted / registered support first_seen (event date) and name. |
| order | asc | desc | asc or desc. |
| pageSize | 25 | 50 | 100 | 200 | Rows per page: 25, 50, 100 or 200. |
| cursor | string | Opaque cursor from the previous response (nextCursor). |
Resposta
{
"code": 0,
"message": "ok",
"data": {
"items": [{ "name": "…", "tld": "com", "score": 72, "kind": "auction",
"source": "godaddy", "priceUsd": 45, "bids": 3,
"endsAt": "2026-11-08T14:00:00.000Z", "listings": 2, … }],
"nextCursor": "eyJzIjoic2NvcmUi…",
"view": "auction", "sort": "ends_at", "order": "asc",
"ignoredFilters": []
}
}Erros: 400 parâmetros inválidos · 401 chave ausente/inválida · 403 filtro pago · 404 domínio desconhecido · 429 limite de taxa excedido.
GET/api/v1/domains/{name}
Perfil do domínio: anúncios ativos em todas as fontes, detalhamento da pontuação, métricas de SEO, histórico de preços, vendas comparáveis, outras extensões e nomes semelhantes.
GET/api/v1/stats
Totais do inventário por tipo de anúncio, fonte e evento de registro (cache de até 5 minutos).