Referência para desenvolvedores

Créditos e preços

API da DomScan: DomScan inclui 10.000 créditos gratuitos por mês. Sem necessidade de cartão de crédito. Comece a usar em segundos.

Créditos e preços

DomScan inclui 10.000 créditos gratuitos por mês. Sem necessidade de cartão de crédito. Comece a usar em segundos.

Os créditos são renovados mensalmente no aniversário do cadastro. Precisa de mais créditos? Compre pacotes que nunca expiram:

Créditos por endpoint

Consulte abaixo os custos dos endpoints mais comuns. Alguns endpoints de referência são gratuitos. Para obter a tabela de preços completa e legível por máquina, use /v1/pricing.

Ponto finalCréditosDescrição
/v1/coverage 0 Listar TLDs com mapeamentos RDAP
/v1/tlds 0 Lista de metadados de TLD
/v1/watchlist 1 Ver a sua lista de observação
/v1/webhooks 2 Por alerta entregue ao seu endpoint de webhook. As entregas com falha são reembolsadas e os eventos de teste são gratuitos.
/v1/status 1 Verificar disponibilidade de domínio
/v1/health/quick 1 Verificação de saúde rápida
/v1/dns 1 Consulta DNS
/v1/dns/bulk 1/domain Pesquisa DNS em lote (até 25 domínios)
/v1/ip 1 Geolocalização de IP
/v1/value 2 Avaliação de domínio
/v1/prices 0-1/pair Preços de registo
/v1/tlds/:tld 1 Detalhes de TLD
/v1/watchlist/check 1 Verificar item da lista de observação
/v1/typos/permutations 1 Permutações de typos
/v1/typos/score 1 Pontuação de risco de typo
/v1/email/check 1 Verificação de lista negra de email
/v1/status/bulk 1/domain Verifique disponibilidade para vários nomes de domínios ao mesmo tempo. Suporta até 50 domínios por pedido.
/v1/health 3 Verificação de saúde completa
/v1/dns/all 2 Todos os registos DNS
/v1/profile 3 Perfil de domínio
/v1/redirects 2 Cadeia de redirecionamento
/v1/tech 3-9 Detecção de pilha tecnológica
/v1/categorize 3 Categorização de website
/v1/similarity 2 Similaridade de domínios
/v1/typos 2-3 Detecção de typosquatting
/v1/reputation 3 Reputação de domínio
/v1/reputation/bulk 3/domain Reputação de domínios em lote (até 3 domínios)
/v1/certificates 2 Certificado SSL
/v1/certificates/bulk 2/domain Certificado SSL
/v1/social 2 Verificação de nomes em redes sociais
/v1/social/bulk 2/handle Verificação em massa de nomes de usuário nas redes sociais
/v1/company 3 Consulta de empresa
/v1/suggest 2-5 Sugestões de domínios
/v1/whois 3 Consulta WHOIS
/v1/whois/history 3 Histórico de alterações WHOIS
/v1/whois/bulk 3/domain Consulta WHOIS em massa (até 20 domínios)
/v1/rdap/bulk 2/query Consulta WHOIS
/v1/prices/bulk 1/pair Preços em massa
/v1/dns/security 3 Análise de segurança DNS
/v1/dns/propagation 2 Propagação de DNS
/v1/dns/propagation/bulk 2/domain Propagação de DNS
/v1/email-auth/bulk 3/domain Autenticação de email
/v1/hosting/bulk 3/domain Detecção de alojamento
/v1/value/bulk 2/domain Avaliação em massa
/v1/health/bulk 3/domain Verificação de saúde em massa
/v1/subdomains 4-5 Localizador de subdomínios
/v1/subdomains/bulk 4-5/domain Localizador de subdomínios
/v1/report 5 Relatório abrangente (poupa ~10 créditos em comparação com chamadas individuais)

Controle de créditos

Quando seus créditos chegam a zero, as solicitações de API que custam créditos retornam HTTP 402 (pagamento obrigatório). Ferramentas gratuitas baseadas em navegador não são afetadas.

HTTP 402 Payment Required
{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits. This endpoint costs 2 credits but you have 0.",
    "credits_remaining": 0,
    "credits_required": 2,
    "purchase_url": "https://domscan.net/billing"
  }
}

Precisa de mais créditos? Compre pacotes que nunca expiram:

Os créditos são renovados mensalmente no aniversário do cadastro.

Cabeçalhos de resposta de créditos

Todas as respostas autenticadas da API incluem um cabeçalho X-Credits-Remaining mostrando seu saldo de crédito atual após a solicitação.

X-Credits-Remaining: 9500

Toda resposta /v1 autenticada, inclusive as de erro, traz estes cabeçalhos:

  • X-Credits-Charged: créditos cobrados por esta requisição, líquidos de qualquer reembolso feito na mesma requisição (0 quando nada foi cobrado).
  • X-Credits-Remaining: seu saldo após a requisição. É omitido no raro caso de o saldo não ser conhecido de antemão.
  • X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset: sua capacidade de rajada, as requisições que você ainda pode enviar imediatamente e o horário Unix em segundos em que a capacidade é totalmente reposta.
  • MCP sobre HTTP retorna X-Credits-Charged e X-Credits-Remaining para as chamadas de ferramentas de cada requisição.

Estime o custo antes de executar

Envie o método, o caminho, a consulta e o corpo de uma requisição para POST /v1/estimate para obter os créditos que ela cobraria, com detalhamento e observações. Nada é executado e a estimativa custa 0 créditos. Quando a cobrança final depende do resultado, a estimativa é o máximo e uma observação explica o motivo.

POST /v1/estimate

Corpo da requisição

ParâmetroTipoDescrição
method obrigatório string
Valores permitidos GETPOSTPUTPATCHDELETE
Método HTTP da requisição a ser estimada.
path obrigatório string Caminho da requisição a ser estimada, por exemplo /v1/value/bulk. Uma query string no caminho também é lida.
query opcional object Parâmetros de consulta como objeto. Arrays são unidos por vírgulas.
body opcional any Corpo JSON que a requisição enviaria.

Exemplo de requisição

curl -X POST "https://domscan.net/v1/estimate" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"method":"POST","path":"/v1/value/bulk","body":{"domains":["example.com","example.org"]}}'

Exemplo de resposta

{
  "credits": 2,
  "breakdown": [
    { "component": "domains", "quantity": 2, "unit_credits": 1, "credits": 2 }
  ],
  "notes": ["Requisições rejeitadas com status 4xx ou que falham com status 5xx são reembolsadas automaticamente."],
  "maximum": false,
  "rejected": false
}

Campos da resposta

Campo Tipo
credits integer
breakdown[] object[]
breakdown[] object
breakdown[].component string
breakdown[].quantity integer
breakdown[].unit_credits number
breakdown[].credits integer
notes[] string[]
maximum boolean
rejected boolean
billing_model string
endpoint object
endpoint.method string
endpoint.path string
dry_run boolean

Os endpoints de bulk, compare, recipe e pricing também aceitam dry_run=true. A requisição é respondida com HTTP 200 e a mesma estimativa mais "dry_run": true, sem executá-la nem cobrar créditos.

Calculadora de créditos

Estime o seu uso de créditos para operações em massa:

Total de créditos necessários
100
Isso representa 1.0% dos seus créditos mensais gratuitos

Pacotes de créditos

Precisa de mais créditos? Compre pacotes que nunca expiram:

PacotePreçoPor crédito
50,000 créditos €9 / £7.50 / ¥1,500 €0.00018
250,000 créditos €29 / £24 / ¥4,800 €0.000116
1,000,000 créditos €79 / £66 / ¥13,000 €0.000079