Pular para o conteúdo

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âmetros de consulta
ParâmetroTipoDescrição
qstring
Palavras-chave
Keywords; every token must appear in the label (name without the suffix).
anyOfstring (csv)
Contém qualquer uma de
Comma-separated tokens; at least one must appear in the label.
excludestring (csv)
Excluir
Comma-separated tokens that must not appear in the label.
startsWithstring
Começa com
Label starts with this text.
endsWithstring
Termina com
Label ends with this text.
viewall | 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.
tldstring (csv)
Extensões
Comma-separated public suffixes, e.g. com,io,co.uk.
tldGrouplegacy_gtld | cctld | new_gtld | private (csv)
Grupo de extensões
Comma-separated: legacy_gtld, cctld, new_gtld, private.
sourcenamecheap | godaddy | dynadot | sedo | dropcatch | gname | catched | czds | registry-se | registry-pl | registry-uk | registry-au (csv)
Fonte
Comma-separated data sources.
minPricenumber 0–1000000000
Preço mín.
Minimum price in USD (best offer in view=all, the listing price otherwise).
maxPricenumber 0–1000000000
Preço máx.
Maximum price in USD.
minLengthinteger 1–63
Comprimento mín.
Minimum label length (characters, IDN decoded).
maxLengthinteger 1–63
Comprimento máx.
Maximum label length.
noHyphenboolean
Sem hífens
Exclude labels with a hyphen.
noDigitboolean
Sem números
Exclude labels with a digit.
onlyDigitsboolean
Só números
Only all-digit labels.
idnexclude | include | only
IDN
IDN handling: exclude, include (default) or only.
patternstring
Padrão
Character pattern: C consonant, V vowel, N digit, H hyphen, L any letter. E.g. CVCV, LLLL.
minWordsinteger 1–3
Mín. de palavras
Minimum dictionary words in the label (1–3).
maxWordsinteger 1–3
Máx. de palavras
Maximum dictionary words in the label (1–3).
dictionaryboolean
Uma única palavra de dicionário
Label is exactly one dictionary word.
endingWithininteger 1–720
Termina em até
Ends within N hours.
minScoreinteger 0–100
Pontuação mín.
Minimum Namester Score (0–100).
maxScoreinteger 0–100
Pontuação máx.
Maximum Namester Score.
minAgeinteger 0–50
Idade mín. (anos)
Minimum age in years.
minBidsinteger 0–10000
Mín. de lances
Minimum bids (total across listings in view=all).
minBacklinksPagointeger 0–1000000000
Mín. de backlinks
Minimum backlinks. Paid plans only (403 otherwise).
minDrPagointeger 0–100
DR mín.
Minimum Ahrefs DR. Paid plans only (403 otherwise).
minTfPagointeger 0–100
TF mín.
Minimum Majestic Trust Flow. Paid plans only (403 otherwise).
minCfPagointeger 0–100
CF mín.
Minimum Majestic Citation Flow. Paid plans only (403 otherwise).
minTrafficPagointeger 0–1000000000
Tráfego mín.
Minimum estimated monthly traffic. Paid plans only (403 otherwise).
minTldsTakenPagointeger 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).
minSearchVolumePagointeger 0–1000000000
Volume de busca mín.
Minimum monthly search volume reported by a supplier. Paid plans only (403 otherwise).
minBirthYearinteger 1985–2100
Ano de criação a partir de
Earliest registration year (where a source reports it).
maxBirthYearinteger 1985–2100
Ano de criação até
Latest registration year.
minWaybackYearinteger 1996–2100
Primeiro ano no Wayback a partir de
Earliest first Wayback Machine capture year (only names with Wayback data).
maxWaybackYearinteger 1996–2100
Primeiro ano no Wayback até
Latest first Wayback capture year.
minWaybackAgeinteger 0–50
Idade mín. no Wayback (anos)
Minimum years since the first Wayback capture (only names with Wayback data).
daysinteger 1–90
Últimos
deleted / registered views: look-back window in days (default 7).
sortscore | 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.
orderasc | desc
asc or desc.
pageSize25 | 50 | 100 | 200
Rows per page: 25, 50, 100 or 200.
cursorstring
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).