Referência da API

Retorna apenas o próprio endereço IP público do cliente que fez a requisição, como texto simples (Content-Type: text/plain) — ex.: 73.9.114.155. Equivalente direto do ipinfo.io/ip: funciona de forma idêntica via curl, Wget, HTTPie ou uma visita simples pelo navegador (sem detecção de User-Agent, diferente do atalho curl ipto.to acima), e é renderizado como apenas o IP puro, sem elementos de página, quando aberto no navegador.

Sem parâmetros, sem query string. Para o objeto completo de geolocalização/inteligência de ameaças, use GET /v1/ip abaixo. Esta rota lê o IP de conexão diretamente (sem consulta a D1/KV) e não é contabilizada no orçamento diário de requisições — veja Limites de taxa.

Retorna geolocalização e inteligência de ameaças para o IP da requisição, incluindo dados no nível de cidade via o objeto de borda da CF.

Nenhum parâmetro obrigatório. Aceita ?lang=, ?fields=, ?format= — veja Localização e Formatos de saída abaixo.

Consulte qualquer endereço IPv4. Os campos de nível de cidade (city, state, postal_code, latitude, longitude, timezone) são preenchidos quando o IP está presente em um dos dois conjuntos de dados geográficos combinados, IP2Location ou MaxMind — verifique geo_precision na resposta para saber se você recebeu dados de nível de cidade ou de país. O formato de timezone depende de qual fonte deu o match (uma string de UTC-offset do IP2Location, ou um nome IANA do MaxMind). Consultas IPv6 atualmente retornam apenas dados de nível de país.

O endpoint de busca unificada por trás da barra de pesquisa da página inicial. Detecta se :query é um IP, um ASN (AS15169 ou 15169), um código de país de 2 letras, um e-mail ou um número de telefone, e então agrega todas as verificações relevantes em uma única resposta. Para uma busca por IP, isso dispara — em paralelo, no lado do servidor — a busca de IP principal mais RPKI, IP-para-empresa, operadora móvel, domínios hospedados e locais próximos, de modo que uma única busca consome apenas uma requisição do seu orçamento diário de limite de taxa, em vez de uma por funcionalidade.

Cada subcampo degrada de forma independente — uma fonte upstream lenta ou com falha (RIPEstat, um servidor RDAP, crt.sh) aparece apenas como aquele campo específico sendo null, nunca como falha da busca inteira. Somente uma consulta principal inválida (ex.: um IP malformado) retorna um status de erro para a requisição como um todo.

DNS reverso — uma única consulta PTR ao vivo via DNS-over-HTTPS, não um banco de dados de enumeração de domínios. Retorna null se o IP não tiver registro PTR.

Validação de origem de rota RPKI para a rota atualmente anunciada de um IP, resolvida ao vivo via RIPEstat (nenhum banco de dados de ROA é ingerido ou mantido sincronizado localmente). status é sempre "valid", "invalid" ou "unknown" — nunca sintetizado a partir de qualquer outro sinal; qualquer falha ou timeout do RIPEstat retorna "unknown" com uma string de motivo, não um erro.

Validação RPKI explícita (ASN, prefix) — para quando você já sabe exatamente qual rota quer verificar, em vez da conveniência derivada de IP acima.

Identifica a organização à qual um IP está registrado, combinando dados do registrante RDAP (WHOIS estruturado) com o nome da organização do próprio ASN em uma confiança categórica, nunca uma pontuação numérica.

O próprio registro de registro RDAP subjacente — bloco de rede, datas de registro/última alteração, e todos os contatos que o RDAP tem registrados. Diferente do /company acima, que reconcilia esses mesmos dados de registrante com o nome da organização do ASN em uma única resposta com nível de confiança; este endpoint retorna o registro bruto tal como está, mais próximo da saída clássica de WHOIS. Endereços IPv6 também são suportados.

Identificação de operadora móvel best-effort para IPs classificados como redes móveis, cruzada com um diretório de operadoras MCC/MNC. Deliberadamente não possui um único campo de operadora — veja matched_carrier_entries e note abaixo — já que um nome de operadora isolado seria lido como uma afirmação ao vivo por assinante, o que estes dados não conseguem sustentar com honestidade.

Encontra domínios associados a um IP através do seu hostname de DNS reverso (PTR) e de logs de transparência de certificados (crt.sh) — não é uma busca reversa de IP genérica. O próprio campo limitations da resposta explica exatamente o que isso consegue e não consegue encontrar.

Busca em massa — até 100 IPs por requisição, somente Pro/Enterprise. Retorna um objeto indexado com cada IP como chave. Mais rápido que chamadas sequenciais graças a leituras paralelas de cache e banco de dados. Cada IP no lote conta contra o seu orçamento diário de requisições, assim como consultá-lo individualmente. Requisições do plano gratuito recebem um 403 — veja preços.

Consulte um Sistema Autônomo pelo número. Retorna o nome da organização, país, continente, contagem de faixas de IP, tipo de classificação, taxa de câmbio e dados de referência regionais (idiomas, tld, capital, fronteiras).

Faz a geocodificação reversa da localização de nível de cidade já existente de um IP, e então retorna pontos de interesse próximos (restaurantes, parques, escolas, transporte público, marcos notáveis), dados locais de criminalidade onde há uma fonte disponível (apenas Reino Unido e EUA), e uma estimativa opcional de trajeto de carro sob demanda.

Estatísticas agregadas em nível de país, além de dados de referência regionais (moeda, taxa de câmbio, idiomas, tld, capital, fronteiras).

Analisa uma string de User-Agent. Retorna navegador, sistema operacional, tipo de dispositivo e detecção de bot. Lê o cabeçalho User-Agent do solicitante por padrão, ou passe qualquer string via ?ua=.

Valida e formata um número de telefone gratuitamente, sempre: região, tipo de linha e formatação E.164/nacional/internacional via um parser auto-hospedado, sem chamada a fornecedor. Quando há orçamento premium mensal disponível por IP/chave (100/mês no Free, mais nos planos pagos — veja preços), a mesma requisição também retorna um nome de operadora ao vivo, status de portabilidade, e um tipo de telefone classificado pelo provedor, de um serviço de consulta de operadoras em tempo real — veja source e os campos abaixo. Um country_name localizado, além de lang/lang_source, é sempre incluído, independentemente do nível — veja Localização. Esgotar o orçamento premium, ou qualquer problema upstream, retorna sem problemas aos campos gratuitos acima; a requisição nunca falha por causa disso. Para uma referência de operadoras de rede em nível de país em vez de uma consulta por número, veja GET /v1/carriers.

Validação em massa. Todos os planos têm acesso ao envio em massa (diferente de /v1/ip/bulk) — o limite de lote por plano é o que mantém o Free limitado, não um 403. Free: 10/requisição, 100/dia. Pro: 100/requisição, 1.000/dia. Enterprise: 1.000/requisição, 10.000/dia. Este orçamento é separado do seu limite geral diário de requisições — veja Limites de taxa.

Consulta de referência: quais operadoras de rede móvel (MCC/MNC) são conhecidas para um determinado país — não vinculada a nenhum número de telefone específico. Extraído de uma compilação MCC/MNC mantida pela comunidade (licença MIT, última sincronização em 2026 — veja o repositório de docs para detalhes); uma tabela de referência estática, não um feed ao vivo, já que atribuições de plano de numeração não mudam com frequência suficiente para justificar isso.

Validação de sintaxe de e-mail, uma verificação ao vivo de registro MX via DNS-over-HTTPS, e detecção de domínio descartável/temporário contra uma lista de bloqueio mantida pela comunidade (licença CC0, sincronizada diariamente). Não verifica se a caixa de entrada em si existe — isso exigiria um handshake SMTP que esta API não realiza (veja a referência de campos abaixo para saber exatamente o que has_mx prova e não prova).

Combina qualquer combinação de IP, e-mail, telefone e User-Agent que você fornecer em uma única pontuação de 0–100 — a única coisa que nenhum dos serviços ip-api.com, ipapi.co, ipgeolocation.io, ipify.org, ipregistry.co, ip2location.io, AbstractAPI, IPLocate.io ou BigDataCloud oferece como um sinal único combinado (verificado diretamente). Todas as quatro entradas são opcionais e independentes — passe qualquer subconjunto. ip usa o seu próprio IP e ua usa o seu próprio cabeçalho User-Agent por padrão, se omitidos, a mesma convenção de GET /v1/ip e GET /v1/ua. Um sinal que você não passar simplesmente fica ausente da resposta, não é pontuado como limpo — seu peso é redistribuído entre os sinais que você de fato forneceu.

Renderiza uma URL em uma instância real de Chrome headless (Cloudflare Browser Rendering, não um fornecedor terceirizado de screenshots) e retorna um PNG. Alvos internos/privados (localhost, faixas RFC 1918, endereços link-local/de metadados de nuvem) são rejeitados antes mesmo do navegador ser iniciado. Sujeito aos próprios limites de plataforma do Browser Rendering, que são muito mais restritivos que o resto desta API — espere que isso seja limitado bem antes do seu orçamento diário normal de requisições em planos Cloudflare mais baixos.

Identifica o idioma de um trecho de texto via análise local de frequência de trigramas — sem chamada a fornecedor externo, sem inferência por modelo de IA, sem registro de logs. Entradas com menos de 10 caracteres retornam um idioma null; com menos de ~30 caracteres ainda pode retornar um palpite, mas reliable será false.

Converte um valor entre duas moedas (154 suportadas) usando o mesmo feed diário de taxas de referência que já alimenta currency_code/exchange_rate_usd em toda busca de IP, ASN e país — exposto aqui como um endpoint de conversão independente, em vez de aninhado dentro de uma resposta de geolocalização.

Tabela completa de taxas de câmbio (154 moedas) rebaseada em relação a qualquer moeda suportada, não apenas USD.

Histórico diário de taxa de referência para um par de moedas, até 90 dias atrás — os dados por trás do gráfico de tendência de taxa em a ferramenta de conversão de moedas. Preenchido retroativamente uma vez, e depois atualizado diariamente pelo mesmo cron que atualiza GET /v1/currency/convert. Esta é uma única taxa de referência diária ao longo do tempo, não um spread de compra/venda de negociação.

Condições atuais — e, com detail=1, uma previsão horária e para vários dias — para um nome de lugar, CEP ou par "lat,lon", ou para lat + lon ou um ip. Os locais dos EUA são atendidos pelo National Weather Service e o resto do mundo pelo MET Norway. Adicione include= para o documento completo, com unidades, até 9 dias, sol e lua, alertas oficiais e mais — veja o cartão include abaixo. A ferramenta weather-lookup também detecta automaticamente a localização do próprio solicitante no navegador antes de chamar este endpoint explicitamente.

Proxy ao vivo para o sistema TSDR (Trademark Status & Document Retrieval) do USPTO para status de processo por número de série de 8 dígitos — uma chamada direta por requisição, não uma cópia em cache ou revendida. Os dados de status de processo são uma obra do governo dos EUA e de domínio público segundo os próprios termos de uso do USPTO, então toda resposta traz um campo source/attribution, em vez de armazená-los em cache ou revendê-los silenciosamente. Dados de logotipo/imagem de marca estão deliberadamente fora do escopo — os termos do USPTO separam o licenciamento de imagens dos dados textuais de status de processo que este endpoint retorna. A busca por número de registro ainda não é suportada; apenas o caminho por número de série é documentado pelo USPTO atualmente. Experimente na ferramenta Trademark Lookup.

Proxy ao vivo para a API Patent File Wrapper do USPTO (Open Data Portal) para status de concessão por número de patente de utilidade de 7-8 dígitos — uma chamada direta por requisição, não uma cópia em cache ou revendida. A fonte originalmente utilizada (a Search API do PatentsView) foi confirmada como desativada em 2026-03-20; isso faz proxy para sua sucessora ao vivo. Os dados do Patent File Wrapper são uma obra do governo dos EUA e de domínio público segundo os próprios termos de uso do USPTO, então toda resposta traz um campo source/attribution. O escopo é centrado em solicitação/processo — sem grafo de citações, família de patentes, campo de status jurídico ou imagens como o Lens.org, Espacenet ou Google Patents mostram. A cobertura começa em solicitações depositadas em 2001. Patentes de design, de planta e de reemissão ainda não são suportadas; apenas patentes de utilidade concedidas por número de patente. Experimente na ferramenta Patent Lookup.

Feed paginado de VPN, Tor e inteligência de ameaças. 200 entradas por página. Cada entrada inclui IP/CIDR, atribuição do provedor, ISP, país e tipo de classificação.

Somente metadados — contagem total de entradas, contagens por fonte e horário da última sincronização. Não retorna dados de IP.

Faixas de rede abusivas, paginadas. Pontuadas de 1 a 10 por corroboração entre feeds. Níveis de risco: critical (8-10), high (5-7), medium (3-4).

Somente metadados — contagem total de redes, contagens por fonte, detalhamento por nível de risco, e horário da última sincronização.

Exportação CSV para download dos datasets abertos sobre os quais a API já é construída — os mesmos dados, sem nova licença. asn e ranges estão sempre disponíveis; geo-city retorna 503 até que o dataset dessa fonte esteja ativo em uma determinada implantação. geo-city exporta as linhas brutas de uma fonte geográfica por vez, não uma visão combinada — passe ?source=primary (padrão) ou ?source=secondary.

Emite uma chave de API instantaneamente — sem e-mail, sem cadastro. Toda chave começa no plano gratuito (1.000 requisições/dia; busca em massa não incluída). Chaves Pro e Enterprise desbloqueiam limites diários maiores e busca em massa (até 100 IPs/requisição) — veja preços. Guarde a chave — ela não pode ser recuperada depois.

Verifique quantas requisições uma chave já fez. Passe a chave em qualquer requisição /v1/* via o cabeçalho X-API-Key ou ?api_key= para que ela seja contabilizada.

Contato de denúncia de abuso da rede proprietária de um IP, obtido via RDAP: o RIR, o identificador da rede, o CIDR que a cobre e a(s) caixa(s) de e-mail de abuso. Use para saber para onde enviar uma denúncia.

available é false (com um motivo em failure) quando o registro não pôde ser acessado.

Os intervalos de IP efetivamente anunciados por um ASN, paginados, cada um com seu país e os indicadores de hospedagem / móvel / residencial / bot / lista negra.

Registro (RDAP) de um ASN: identificador, nome, país, tipo de alocação, datas de registro, o RIR e seus contatos.

available é false com um reason quando o registro está inacessível.

Outros ASNs provavelmente relacionados a este: primeiro a mesma organização registrada, depois o mesmo país e tipo.

Onde um ASN realmente está: pontos em nível de cidade geolocalizados a partir de uma amostra dos seus maiores intervalos, mais as cidades mais comuns. Alimenta o mapa de distribuição da página do ASN.

Uma amostra, não a lista completa de intervalos. Use /v1/asn/:asn/ranges para todos os intervalos.

Domínios hospedados em um ASN, encontrados por DNS reverso (PTR) em uma amostra de seus endereços. Cada entrada traz o domínio raiz, o hostname PTR e o IP amostrado.

Amostrado, então é uma pista do que o ASN hospeda, não uma lista completa. Para um único IP use /v1/ip/:ip/hosted-domains.

Relações BGP de um ASN: pares, provedores upstream e clientes downstream, com contagens.

available é false quando a fonte de dados BGP não pôde ser acessada. Arrays vazios com available: true significam que nada foi informado para esse ASN.

Diretório do espaço IPv4: uma entrada por bloco /8 com quantos intervalos, países e ASNs ele contém e seu país principal. Comece aqui e aprofunde com /v1/ip-ranges/:a e /v1/ip-ranges/:a/:b.

Os blocos /16 dentro de um /8 (por exemplo 8.0.0.0/8), com as mesmas contagens de intervalos, países e ASNs por bloco.

Os intervalos atribuídos dentro de um /16 (por exemplo 8.8.0.0/16), cada um com o ASN ao qual pertence, mais as contagens por bloco.

Uma fatia do payload Nearby para uma coordenada, para que o cliente renderize cada parte conforme chega: geocodificação reversa, pontos de interesse ou estatísticas locais de crime.

Tempo e distância de carro entre dois pontos. Um caminho rápido: dispensa a geocodificação reversa e a busca de pontos de interesse que /v1/places/:ip faz.

Quando nenhum destino pode ser resolvido, a resposta tem to: null, commute: null e uma string reason.

O payload de /v1/places/:ip ancorado em um endereço digitado em vez de um IP: geocodificação, localidade e uma estimativa opcional de trajeto.

found é false quando o endereço não pôde ser geocodificado.

Autocompletar de endereços: alguns locais correspondentes a um endereço parcial, opcionalmente priorizando um ponto.

O documento completo de clima, para um nome de lugar, código postal, coordenadas ou IP. Escolha os blocos que precisa com include: current, hourly, daily, astro (sol e lua), solar, indicators, alerts, marine, air_quality, nowcast, ou all. Os locais dos EUA vêm do National Weather Service e o resto do mundo do MET Norway; meta.source informa qual. Sem include você recebe o formato simples { query, weather } descrito acima.

meta.coverage indica quais campos existem para o local: probabilidade de chuva, rajadas e probabilidade de trovoada existem só nos EUA e nos países nórdicos e são null (nunca zero) nos demais. alerts são avisos oficiais dos EUA e da Noruega; marine, air_quality e nowcast cobrem apenas a Noruega e águas próximas e trazem available: false nos demais lugares. Tudo em meta.derived é uma estimativa do ipto.to, e indicators são sinalizações derivadas, não avisos oficiais. Mantenha meta.attribution ao exibir os dados (os dados do MET Norway são CC BY 4.0).

O registro diário do próprio ipto.to para lugares já consultados: a máxima mais alta, a mínima mais baixa e a maior precipitação vistas nos instantâneos de previsão do dia. Só há dados para lugares já solicitados, e o histórico se acumula com o tempo.

São instantâneos de previsão, não observações de estações nem reanálise; portanto, não os use como histórico observado. 404 significa que ainda não há instantâneos registrados para esse lugar.

Os quadros de animação de radar disponíveis, do mais antigo ao mais recente, cada um com um timestamp Unix e o id do quadro a usar na URL do tile de radar.

Um tile de mapa de radar (PNG) para um quadro, em uma posição z/x/y padrão de mapa web. Servido pela mesma origem, para que um mapa o carregue sem requisição a terceiros.

Um tile de mapa de imagens de satélite para uma posição z/x/y padrão de mapa web, servido pela mesma origem.

Contrato OpenAPI 3.1 legível por máquina para /v1/email/:email, escrito para que agentes LLM e MCP chamem o endpoint de e-mail sem ler esta documentação.