API Gratuita de Geolocalização e Risco de IP

API gratuita de geolocalização de IP & Risco

Alto desempenho, pilha dupla IPv4/IPv6, suporte multilíngue. Grátis e sem cadastro.

Este produto inclui dados GeoLite2 criados pela MaxMind, disponíveis em https://www.maxmind.com.

⏱️

Limite de frequência Máximo de 1 solicitação por segundo (1 req/s).

♾️

Cota total Sem limites de cota diária ou total. 100% gratuito para usar.

Endpoints da API

GET https://api.myipdns.com/

IPv4 IPv6 Formato JSON

GET https://v4.api.myipdns.com/

Apenas IPv4 Formato de Texto

GET https://v6.api.myipdns.com/

Apenas IPv6 Formato de Texto

Parâmetros

Parâmetro	Descrição	Exemplo
`ip`	O endereço IP a ser consultado. Se omitido, retorna o IP do solicitante.	`?ip=8.8.8.8`
`lang`	Idioma da resposta. Suportado: en, cn, ru, ja, fr, de, es, pt.	`?lang=zh-CN`

Exemplo de resposta JSON

Request: GET https://api.myipdns.com/?ip=8.8.8.8&lang=en

{
  "ip": "8.8.8.8",
  "continent": "North America",
  "continent_code": "NA",
  "country": "United States",
  "country_code": "US",
  "timezone": "America/Chicago",
  "latitude": 37.751,
  "longitude": -97.822,
  "asn": 15169,
  "as_org": "Google LLC",
  "native_type": "native",
  "rir_registry": "arin",
  "is_hosting": true,
  "usage_type": "DCH",
  "query_time": "0.03",
  "source": "maxmind.com"
}

API de Diagnóstico de Pilha de Protocolos e Privacidade no Terminal (/check)

Endpoint de inspeção direta de pilha e topologia de saída de alta precisão para curl, wget e scripts automatizados.

⚡

Limite de taxa de leitura 1 requisição/segundo (burst 5) por IP. O excesso retorna HTTP 429.

🔗

Cota de criação de links 5 gravações/hora por IP. O excesso continua retornando o diagnóstico normalmente sem link (HTTP 200).

Endpoints da API

GET https://myipdns.com/check

Dual-Stack Saída padrão (Cor ANSI / Texto de terminal)

GET https://myipdns.com/check?format=line

Dual-Stack Formato de linha (KEY=VALUE para análise em Shell e automação)

GET https://myipdns.com/check?format=json

Dual-Stack Formato JSON estruturado

Parâmetros

Parâmetro	Descrição	Exemplo
`format`	Especificação de formato: json (JSON estruturado) ou line (formato KEY=VALUE)	`?format=line` / `?format=json`
`share`	Gera um link de relatório de 30 dias e badge SVG (limite de 5 gravações/hora/IP)	`?share=1`
`color`	Desativa códigos de cores ANSI: ?color=0 ou ?plain=1	`?color=0` / `?plain=1`
`-4 / -6`	Sonda explicitamente pilha IPv4 ou IPv6: curl -4 ou curl -6	`curl -4 https://myipdns.com/check`

Especificação completa dos campos JSON

Field	Type	Description
`ip`	string	Endereço IP de saída do cliente
`ip_version`	string	Versão IP (IPv4 ou IPv6) (`IPv4` / `IPv6`)
`country`	string	Nome do país determinado por votação multifonte
`country_code`	string	Código de país ISO 3166-1 alfa-2
`city`	string \| null	Nome da cidade (ou null se não medido)
`asn`	string	Número de Sistema Autônomo (ex. AS15169)
`as_org`	string	Nome da organização ou ISP do ASN
`is_datacenter`	boolean	Booleano indicando rede de data center ou hospedagem
`is_proxy`	boolean	Booleano indicando saída de proxy comercial ou VPN
`transport`	object	Objeto de camada de transporte. 🔴 Métricas não medidas são estritamente null (nunca 0 ou false)
`transport.mss`	string	Tamanho máximo de segmento TCP observado (ex. 1380, ou "n/a")
`transport.mtu`	integer \| null	MTU de rota deduzida a partir do MSS (ex. 1420 para WireGuard, ou null)
`transport.mtu_note`	string \| null	Classificação heurística do link com base no MTU (ou null)
`transport.wscale`	integer \| null	Expoente de escala de janela TCP (ou null)
`transport.syn_win`	integer \| null	Tamanho da janela SYN inicial TCP (ou null)
`transport.syn_ttl`	integer \| null	TTL inicial estimado do SYN (ou null)
`transport.option_order`	string \| null	Ordem das opções SYN TCP (ou null)
`transport.ts_val`	integer \| null	Valor de timestamp TCP (ou null)
`transport.ts_hz`	integer \| null	Frequência de relógio de timestamp TCP em Hz (ou null)
`transport.ecn_enabled`	boolean \| null	Status ECN (ou null se não medido)
`crypto`	object	Objeto de aplicação e criptografia (versão HTTP, versão TLS, JA4, JA3, ALPN)
`verdict`	object	Veredito de topologia, base de inferência e resumo descritivo
`share_url`	string (optional)	Link de 30 dias gerado quando solicitado ?share=1 dentro da cota
`badge_url`	string (optional)	URL do badge SVG gerado quando solicitado ?share=1 dentro da cota

Formato de linha (KEY=VALUE para análise em Shell e automação) Example:

ip=35.212.190.31
ip_version=IPv4
country=United States
country_code=US
city=San Jose
asn=AS15169
as_org=Google LLC
is_datacenter=true
is_proxy=false
mss=1380
mtu=1420
mtu_note=Encapsulated Tunnel (WireGuard / Tailscale / CDN)
wscale=7
syn_win=65535
syn_ttl=64
option_order=MSS,SACK_PERM,TS,NOP,WS
ts_val=987654
ts_hz=1000
ecn_enabled=true
http_proto=HTTP/2.0
tls_version=TLS 1.3
ja4=t13d1516h2_8daaf6152771_000000000000
verdict=topo_terminated_remote_protocol
verdict_basis=reputation
verdict_summary=Data Center / Proxy Egress (Hosting Network)

Formato JSON estruturado Example:

{
  "ip": "35.212.190.31",
  "ip_version": "IPv4",
  "country": "United States",
  "country_code": "US",
  "city": "San Jose",
  "asn": "AS15169",
  "as_org": "Google LLC",
  "is_datacenter": true,
  "is_proxy": false,
  "transport": {
    "mss": "1380",
    "mtu": 1420,
    "mtu_note": "Encapsulated Tunnel (WireGuard / Tailscale / CDN)",
    "wscale": 7,
    "syn_win": 65535,
    "syn_ttl": 64,
    "option_order": "MSS,SACK_PERM,TS,NOP,WS",
    "ts_val": 987654,
    "ts_hz": 1000,
    "ecn_enabled": true
  },
  "crypto": {
    "http_proto": "HTTP/2.0",
    "tls_version": "TLS 1.3",
    "ja4": "t13d1516h2_8daaf6152771_000000000000"
  },
  "verdict": {
    "key": "topo_terminated_remote_protocol",
    "basis": "reputation",
    "summary": "Data Center / Proxy Egress (Hosting Network)"
  }
}

Interface de linha de comando (CLI / curl)

Nenhuma integração de API complexa necessária. Execute comandos diretamente no seu terminal para obter dados de IP ou IP em texto simples. As solicitações de CLI são limitadas a 1 por segundo.

1. Obter perfil JSON padrão do seu próprio IP:

curl https://myipdns.com

2. Obter perfil JSON padrão de um IP de destino (ex: 8.8.8.8):

curl https://myipdns.com/ip/8.8.8.8

3. Obter string de IP em texto simples (ideal para scripts shell):

curl https://myipdns.com/ip

Perguntas Frequentes sobre a API

Detalhes sobre medição direta de pilha de protocolos, regras de valores nulos e integração de scripts.

O /check emite um redirecionamento HTTP 302 direto para nosso domínio de sonda dual-stack (check_dns.myipdns.com). Ao ignorar proxies reversos e CDNs, o kernel do servidor inspeciona diretamente o pacote TCP SYN recebido.

Para evitar falsificações e interpretações incorretas. Na análise TCP, MTU 0 é inválido, e ECN desativado é diferente de ECN não medido. Parâmetros não medidos retornam estritamente null.

Use curl -sL 'https://myipdns.com/check?format=line' para formato KEY=VALUE com awk ou grep, ou utilize ?format=json com jq.

Leituras que excederem 1 req/s (burst 5) recebem HTTP 429 com cabeçalho Retry-After. Criações de compartilhamento que excederem 5/hora/IP retornam dados de diagnóstico com normalidade (HTTP 200) omitindo o link.

Créditos e Agradecimentos

Usamos as seguintes APIs de terceiros para verificar os pontos de saída da rede.

API Gratuita de Geolocalização de IP e Análise de Risco

API gratuita de geolocalização de IP & Risco

Endpoints da API

Parâmetros

Exemplo de resposta JSON

API de Diagnóstico de Pilha de Protocolos e Privacidade no Terminal (/check)

Endpoints da API

Parâmetros

Especificação completa dos campos JSON

Interface de linha de comando (CLI / curl)

Perguntas Frequentes sobre a API

Como o /check mede o MSS e o MTU do TCP sem distorção de proxy?

Por que métricas não medidas retornam null em JSON em vez de 0 ou false?

Como processo o /check em scripts Shell ou pipelines de CI/CD?

O que acontece quando os limites de taxa são excedidos?

Créditos e Agradecimentos