Consulte o estado do serviço ao vivo e as respostas de falha documentadas antes de fazer a integração.
Sinais de confiança antes da integração
Documentação transparente, solicitações autenticadas e detalhes visíveis de confiabilidade facilitam avaliar o DomScan antes de publicar.
OpenAPI, Swagger, Postman, CLI, SDK e links MCP ficam a um clique.
Endpoints autenticados usam chaves API com custos de créditos claros antes da chamada.
Comece com 10.000 créditos mensais e faça upgrade só quando o uso crescer.
O que esta API ajuda você a lançar
Use esta página como briefing de produção: endpoints, exemplos, formato da resposta e peças de workflow para conectar o DomScan ao seu produto.
Incorpore checagens de domínio, inteligência DNS, sinais de risco ou enriquecimento em onboarding, busca e ferramentas internas.
Substitua consultas manuais repetidas por jobs agendados, alertas e etapas de investigação reproduzíveis.
Use campos previsíveis, códigos de status documentados e custos em créditos em vez de raspar páginas de fornecedores.
Alimente agentes, dashboards, playbooks SOAR e CRMs via OpenAPI, SDK, Postman ou MCP.
Fluxo de integração
Um caminho simples da primeira requisição ao uso repetível em produção.
Envie sua chave API com o cabeçalho documentado e mantenha requisições consistentes entre serviços.
Comece pelos exemplos curl e HTTP, depois mapeie os parâmetros no código da sua aplicação.
Use códigos de status, custos em créditos e campos de resposta para criar retentativas, logs e alertas.
Kit de desenvolvedor
Saia desta página para docs legíveis por máquina, coleções de requisições, SDKs ou ferramentas para agentes.
Gere clientes ou inspecione cada formato de requisição e resposta.
Coleção PostmanImporte requisições prontas para testes manuais e repasse ao time.
SDKs e CLIUse pacotes mantidos e fluxos de linha de comando em vez de escrever boilerplate.
Integração MCPExponha inteligência de domínios para agentes de IA e assistentes internos.
Mapa de parâmetros e resposta
Revise entradas, campos de saída e códigos de status antes de ligar o endpoint ao seu cliente.
Parâmetro
Resposta de Exemplo
Códigos de Estado HTTP
Pontos finais
/v1/reverse/mx
Sinais de confiança antes da integração
Documentação transparente, solicitações autenticadas e detalhes visíveis de confiabilidade facilitam avaliar o DomScan antes de publicar.
OpenAPI, Swagger, Postman, CLI, SDK e links MCP ficam a um clique.
Endpoints autenticados usam chaves API com custos de créditos claros antes da chamada.
Comece com 10.000 créditos mensais e faça upgrade só quando o uso crescer.
Comece pelos exemplos curl e HTTP, depois mapeie os parâmetros no código da sua aplicação.
Principais Recursos
Retorna apenas o número de entradas recentes indicado por limit do índice de melhor esforço por host, alimentado por consultas /v1/dns/all, com deduplicação por domínio raiz ativada por padrão.
O endpoint não varre o DNS, arquivos de zona nem um conjunto completo de DNS passivo.
Use o resultado apenas como contexto adicional, não como prova completa para investigações ou dados comerciais.
Retorna apenas o número de entradas recentes indicado por limit do índice de melhor esforço por host, alimentado por consultas /v1/dns/all, com deduplicação por domínio raiz ativada por padrão.
O endpoint não varre o DNS, arquivos de zona nem um conjunto completo de DNS passivo.
Use o resultado apenas como contexto adicional, não como prova completa para investigações ou dados comerciais.
Retorna apenas o número de entradas recentes indicado por limit do índice de melhor esforço por host, alimentado por consultas /v1/dns/all, com deduplicação por domínio raiz ativada por padrão.
Use o resultado apenas como contexto adicional, não como prova completa para investigações ou dados comerciais.
Pedido de Exemplo
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/reverse/mx?mx=aspmx.l.google.com"
Resposta de Exemplo
{
"query": {
"mx": "aspmx.l.google.com",
"match": "exact",
"include_apex_only": true
},
"deprecated": true,
"deprecation_notice": "This endpoint is deprecated. It only searches a best-effort seven-day passive index populated by prior /v1/dns/all lookups and capped at 10,000 recent entries per key. It is not an internet-wide reverse DNS dataset.",
"results": [],
"summary": {
"total_found": 0,
"returned": 0
},
"freshness_summary": {
"source": "passive_dns",
"cache_status": "passive_cache_only",
"result_count": 0,
"returned_count": 0,
"apex_domain_count": 0,
"apex_deduped_count": 0,
"warning_count": 2,
"warnings": ["passive_cache_only", "no_cached_matches"],
"last_seen_span_days": null
},
"page": {
"limit": 100,
"next_cursor": null
},
"meta": {
"source": "passive_dns",
"note": "Best-effort seven-day index populated only by prior /v1/dns/all lookups"
},
"cache": {
"hit": null,
"age_s": null,
"ttl_s": null,
"key": null
}
}
Perguntas frequentes
Os registros MX (Mail Exchanger) especificam quais servidores de email recebem emails para um domínio. Eles incluem um valor de prioridade e nome do servidor.
Obsoleto: este endpoint pesquisa apenas nomes de host exatos em um índice de melhor esforço de sete dias, alimentado por consultas anteriores a /v1/dns/all. Cada host MX mantém no máximo 10,000 entradas recentes. A API avalia o número de entradas indicado por limit antes de retornar, por padrão, uma linha por domínio raiz. Não é um conjunto de dados de toda a Internet.
Use o resultado apenas como contexto adicional, não como prova completa para investigações ou dados comerciais.
O índice de melhor esforço é alimentado apenas por consultas /v1/dns/all, mantém as observações por sete dias e limita cada host MX a 10,000 entradas recentes. Gravações ausentes ou com falha podem criar lacunas.
Ferramentas e Recursos Relacionados
Códigos de Estado HTTP
Documentamos os códigos de estado HTTP que deves tratar para distinguir respostas bem-sucedidas, problemas de autenticação, créditos, limites de taxa, dados em falta e falhas do serviço a montante.
Pedido bem-sucedido
Parâmetros inválidos
Chave de API ou sessão em falta ou inválida.
Não tens créditos suficientes para executar este pedido.
Limite de taxa excedido
Erro interno
Erro do serviço RDAP de origem
O serviço a montante está indisponível ou a limitar temporariamente.
A consulta ao serviço a montante expirou.
Ver consulta reversa de MX obsoleta