Para quem é
Use verificações focadas para uma decisão ou monte um perfil mais amplo quando o contexto for importante.
O que você recebe
Coloque várias requisições compatíveis da API na fila e colete os resultados sem manter uma conexão do cliente aberta.
AssíncronoRESTMCPSDK
Escolha este produto quando
Escolha este produto quando
Escolha para verificar combinações de um corpus inglês de palavras únicas em 1 a 5 TLDs, com até 100 verificações de palavras e TLD por tarefa.
O que você recebe
Coloque várias requisições compatíveis da API na fila e colete os resultados sem manter uma conexão do cliente aberta.
Endpoints
Revise as operações, entradas, saídas, modos de execução e limites de resposta compatíveis antes da integração.
Créditos e autenticação
1 Autenticação obrigatória. Consulte a referência da operação para ver o custo exato e qualquer preço por item.
Operação de exemplo
Use operações documentadas para coletar, avaliar, enriquecer, verificar, comparar, proteger ou monitorar evidências públicas.
POST
/v1/domain-discovery/jobs
Parâmetros do Corpo
| Parâmetro | Tipo | obrigatório |
|---|---|---|
| tlds | string[] | obrigatório |
| limit | integer | opcional |
| cursor | string | opcional |
| min_length |
integer
Padrão
3
|
opcional |
| max_length |
integer
Padrão
16
|
opcional |
| singular_only |
boolean
Padrão
false
|
opcional |
Campos de Resposta
| Campo | Tipo |
|---|---|
job |
object |
job.id |
string |
job.status |
string |
job.total |
integer |
job.counts |
object |
job.counts.pending |
integer |
job.counts.processing |
integer |
job.counts.succeeded |
integer |
job.counts.failed |
integer |
job.counts.cancelled |
integer |
job.billing |
object |
job.billing.credits_charged |
integer |
job.billing.credits_refunded |
integer |
job.billing.credits_net |
integer |
job.webhook |
object |
job.webhook.configured |
boolean |
job.webhook.status |
string |
job.webhook.attempts |
integer |
job.status_url |
string |
job.results_url |
string |
job.results_csv_url |
string |
job.poll_after_ms |
integer | null |
job.created_at |
string |
job.started_at |
string | null |
job.completed_at |
string | null |
job.cancelled_at |
string | null |
job.updated_at |
string |
job.processing_deadline_at |
string |
job.results_expires_at |
string |
discovery |
object |
discovery.corpus |
string |
discovery.corpus_version |
string |
discovery.total_matching_words |
integer |
discovery.page_offset |
integer |
discovery.page_words |
integer |
discovery.domain_checks |
integer |
discovery.tlds[] |
string[] |
discovery.filters |
object |
discovery.filters.min_length |
integer |
discovery.filters.max_length |
integer |
discovery.filters.singular_only |
boolean |
discovery.credits_per_domain |
integer |
discovery.next_cursor |
string | null |
Pedido de Exemplo
curl -X POST "https://domscan.net/v1/domain-discovery/jobs" \
-H "Content-Type: application/json" \
-H "X-API-Key: $DOMSCAN_API_KEY" \
-d '{
"tlds": [
"io",
"ai"
],
"limit": 50,
"min_length": 4,
"max_length": 8,
"singular_only": true
}'Resposta de Exemplo
{
"job": {
"id": "example-id",
"status": "queued",
"total": 1,
"counts": {
"pending": 1,
"processing": 1,
"succeeded": 1,
"failed": 1,
"cancelled": 1
},
"billing": {
"credits_charged": 1,
"credits_refunded": 1,
"credits_net": 1
},
"webhook": {
"configured": false,
"status": "not_configured",
"attempts": 1
},
"status_url": "https://example.com",
"results_url": "https://example.com",
"results_csv_url": "https://example.com",
"created_at": "2026-08-27T12:00:00Z",
"updated_at": "2026-08-27T12:00:00Z",
"processing_deadline_at": "2026-08-27T12:00:00Z",
"results_expires_at": "2026-08-27T12:00:00Z",
"poll_after_ms": 1,
"started_at": "2026-08-27T12:00:00Z",
"completed_at": "2026-08-27T12:00:00Z",
"cancelled_at": "2026-08-27T12:00:00Z"
},
"discovery": {
"corpus": "iannuttall/unclaimed",
"corpus_version": "example",
"total_matching_words": 1,
"page_offset": 1,
"page_words": 1,
"domain_checks": 1,
"tlds": [
"com",
"net",
"org"
],
"filters": {
"min_length": 1,
"max_length": 1,
"singular_only": false
},
"credits_per_domain": 1,
"next_cursor": "example"
}
}Limites e fronteiras das evidências
Tarefas assíncronas retornam um identificador para consulta de status e recuperação posterior dos resultados.
Operações em lote processam várias entradas compatíveis e preservam os resultados documentados por item.
Parcial significa que alguns itens ou componentes solicitados foram concluídos, mas outros não.
A cobertura é limitada pelas entradas, orçamentos, fontes e limites de resposta documentados.
Um resultado ausente ou desconhecido não comprova que um identificador possa ser reivindicado ou registrado.
Revisado em 2026-08-22
Perguntas frequentes
Onde encontro a referência de solicitação e resposta de Receita de Localizador de Domínio?
Use a referência da API de Receita de Localizador de Domínio para revisar parâmetros, campos de resposta, exemplos, códigos de status e modos de operação compatíveis.
Como devo interpretar resultados desconhecidos ou incompletos de Receita de Localizador de Domínio?
Resultados desconhecidos ou parciais significam que as evidências solicitadas não puderam ser totalmente determinadas. Mantenha o estado do resultado, a confiança, a atualização e as limitações nas decisões seguintes.
Como Receita de Localizador de Domínio é cobrado?
O preço depende da operação e do modo de execução. Consulte a referência do endpoint para ver o custo atual em créditos, o requisito de autenticação e as regras por item.
