DNS e rede 1 Pontos finais 8 Principais Recursos

API de Geolocalização de IP

Consulte o contexto de um endereço IP público com dados do provedor principal e sinais complementares do DomScan. A localização é aproximada. PTR, FCrDNS e o enriquecimento por faixas de IP de nuvem estão concentrados em IPv4.

Categoria DNS e rede
Pontos finais 1
Principais Recursos 8
Perguntas frequentes 4

Usado por pessoas em empresas incríveis

VercelLLM PulseOLXCasa ModernaPipeCal.comBeehiivSnykTogglRemoteSprigDeel

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.

Ao vivo Status do serviço

Consulte o estado do serviço ao vivo e as respostas de falha documentadas antes de fazer a integração.

OpenAPI Artefatos da API

OpenAPI, Swagger, Postman, CLI, SDK e links MCP ficam a um clique.

Chaves API Acesso protegido

Endpoints autenticados usam chaves API com custos de créditos claros antes da chamada.

10,000 Cota gratuita

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.

Workflows de produto

Incorpore checagens de domínio, inteligência DNS, sinais de risco ou enriquecimento em onboarding, busca e ferramentas internas.

Automação de analistas

Substitua consultas manuais repetidas por jobs agendados, alertas e etapas de investigação reproduzíveis.

Dados JSON limpos

Use campos previsíveis, códigos de status documentados e custos em créditos em vez de raspar páginas de fornecedores.

IA e operações

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.

1
Autentique uma vez

Envie sua chave API com o cabeçalho documentado e mantenha requisições consistentes entre serviços.

2
Consulte com exemplos

Comece pelos exemplos curl e HTTP, depois mapeie os parâmetros no código da sua aplicação.

3
Opere e monitore

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.

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âmetros da requisição

Parâmetro

ip
Campos da resposta

Resposta de Exemplo

ipdomaingeolocationgeolocation.countrygeolocation.country_namegeolocation.regiongeolocation.region_namegeolocation.citygeolocation.postalgeolocation.latitudegeolocation.longitudegeolocation.timezone
Cobertura de status

Códigos de Estado HTTP

200400401402429504

Pontos finais

GET /v1/ip
Créditos: 1Autenticação: Autenticação necessária
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.

Status do serviço Artefatos da API

OpenAPI, Swagger, Postman, CLI, SDK e links MCP ficam a um clique.

Chaves API Acesso protegido

Endpoints autenticados usam chaves API com custos de créditos claros antes da chamada.

Cota gratuita Cadastre-se Gratuitamente

Comece com 10.000 créditos mensais e faça upgrade só quando o uso crescer.

Ativo Pedido de Exemplo

Comece pelos exemplos curl e HTTP, depois mapeie os parâmetros no código da sua aplicação.

Principais Recursos

Geolocalização

Cidade, região, país, código postal e coordenadas estimados pelo provedor, quando disponíveis.

Detecção de ISP

Mostra o provedor de Internet associado pelo fornecedor dos dados.

Consulta de Organização

Mostra a organização associada ao IP ou à rede. Não comprova a propriedade do endereço.

Informações de ASN

ASN e informações do operador para contextualizar o roteamento.

Detecção de Hospedagem

Usa o indicador de hospedagem do provedor e, para IPv4, faixas conhecidas de nuvem e padrões PTR como indícios.

Sinais de Segurança Limitados

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.

Consulta de Fuso Horário

Mostra o fuso horário associado pelo provedor à localização aproximada do IP.

DNS Reverso

Verifica PTR e FCrDNS para IPv4, quando disponíveis. O domínio informado na consulta não influencia essa classificação.

Pedido de Exemplo

GET /v1/ip bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/ip?ip=8.8.8.8"

Resposta de Exemplo

200 OK json
{
  "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

Quão precisa é a geolocalização?

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.

Posso buscar endereços IPv6?

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.

Como você detecta proxies?

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.

Os dados são em tempo real?

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.

OK 200

Pedido bem-sucedido

Pedido inválido 400

Parâmetros inválidos

Não autorizado 401

Chave de API ou sessão em falta ou inválida.

Pagamento necessário 402

Não tens créditos suficientes para executar este pedido.

Demasiados pedidos 429

Limite de taxa excedido

Tempo limite do gateway 504

A consulta ao serviço a montante expirou.

Buscar Endereço IP