Consulte o estado do serviço ao vivo e as respostas de falha documentadas antes de fazer a integração.
Usado por pessoas em empresas incríveis
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/ip
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
Cidade, região, país, código postal e coordenadas estimados pelo provedor, quando disponíveis.
Mostra o provedor de Internet associado pelo fornecedor dos dados.
Mostra a organização associada ao IP ou à rede. Não comprova a propriedade do endereço.
ASN e informações do operador para contextualizar o roteamento.
Usa o indicador de hospedagem do provedor e, para IPv4, faixas conhecidas de nuvem e padrões PTR como indícios.
Mostra o indicador de proxy do provedor, uma lista selecionada de nós de saída Tor e indícios gerais de ASN possivelmente associado a VPN.
Mostra o fuso horário associado pelo provedor à localização aproximada do IP.
Verifica PTR e FCrDNS para IPv4, quando disponíveis. O domínio informado na consulta não influencia essa classificação.
Pedido de Exemplo
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/ip?ip=8.8.8.8"
Resposta de Exemplo
{
"ip": "8.8.8.8",
"domain": null,
"geolocation": {
"country": "US",
"country_name": "United States",
"region": null,
"region_name": null,
"city": null,
"postal": null,
"latitude": null,
"longitude": null,
"timezone": null,
"precision": "country"
},
"network": {
"asn": 15169,
"asn_name": "AS15169",
"asn_org": "Google LLC",
"isp": "Google LLC",
"connection_type": "hosting"
},
"security": {
"is_proxy": false,
"is_vpn": false,
"is_tor": false,
"is_tor_exit": false,
"is_datacenter": true,
"is_cloud": true,
"cloud_provider": "Google Cloud",
"threat_score": 0,
"type_classification": {
"type": "datacenter",
"confidence": "high"
},
"fcrdns": {
"ptr": "dns.google",
"fcrdns_valid": true
}
},
"intelligence_summary": {
"query_type": "ip",
"domain_resolved": false,
"cache_status": "miss",
"data_source": "cloudflare-intel+enrichment",
"confidence": "high",
"confidence_score": 100,
"asn_present": true,
"organization_present": true,
"country_present": true,
"security_signal_count": 2,
"risk_flags": [
"cloud",
"datacenter"
],
"hosting_category": "cloud"
},
"meta": {
"query_time_ms": 118,
"cached": false,
"source": "cloudflare-intel+enrichment"
}
}
Perguntas frequentes
A localização vem do provedor principal e é apenas uma estimativa. A qualidade varia conforme o endereço, a rede e a região. Não use esses dados como posição exata nem como prova de identidade.
O provedor principal pode retornar dados básicos de localização e rede para IPv6. As verificações complementares de PTR e FCrDNS e o enriquecimento por faixas de nuvem estão concentrados em IPv4, portanto a resposta IPv6 é menos completa.
O DomScan combina o indicador de proxy do provedor principal com uma lista selecionada de nós de saída Tor e indícios gerais de ASN possivelmente associado a VPN. Não há análise comportamental, e os sinais não cobrem todas as VPNs nem todos os proxies.
Não. Os dados do provedor principal e os enriquecimentos do DomScan podem ficar em cache por até 24 horas. Não há garantia de quando uma alteração nas fontes aparecerá.
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
A consulta ao serviço a montante expirou.
Buscar Endereço IP