API de consulta de IP (geolocalização)
O endpoint de IP retorna a geolocalização aproximada e a rede de um endereço — país, região, cidade, fuso, ISP, organização e ASN — além de sinais úteis para antifraude: proxy/VPN, data center (hosting) e rede móvel. Aceita IPv4, IPv6 e domínio.
Para que serve
- Antifraude: sinalizar acessos via proxy/VPN ou data center.
- Geolocalização de acesso para análise de risco em login/checkout.
- Enriquecimento de logs com ISP, ASN e país de origem.
Requisição
Autentique com o header Authorization: Bearer — gere seu token no dashboard após ativar um plano.
curl -X POST "https://apiconsultas.xyz/api/v1/consultas/ip" \
-H "Authorization: Bearer dp_live_xxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"ip":"8.8.8.8"}'const res = await fetch("https://apiconsultas.xyz/api/v1/consultas/ip", {
method: "POST",
headers: {
Authorization: "Bearer dp_live_xxxxxxxxxxxxxxxxx",
"Content-Type": "application/json",
},
body: JSON.stringify({"ip":"8.8.8.8"}),
});
const data = await res.json();<?php
$ch = curl_init("https://apiconsultas.xyz/api/v1/consultas/ip");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer dp_live_xxxxxxxxxxxxxxxxx",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => '{"ip":"8.8.8.8"}',
]);
$data = json_decode(curl_exec($ch), true);Resposta (200)
Exemplo com valores ilustrativos. O nível de detalhe (dados completos ou mascarados) depende do seu plano.
{
"success": true,
"tipo_consulta": "ip",
"query": {
"termo_mascarado": "8.8.8.8",
"finalidade": "antifraude"
},
"resultado_count": 1,
"data_quality": {
"sources_used": 1,
"confidence_score": 90,
"has_address": true
},
"data": [
{
"ip_resultado": {
"ip": "8.8.8.8",
"pais": "United States",
"codigo_pais": "US",
"regiao": "Virginia",
"cidade": "Ashburn",
"isp": "Google LLC",
"asn": "AS15169 Google LLC",
"alertas": "Data center / Hosting"
}
}
],
"audit": {
"logged": true,
"timestamp": "2026-07-01T12:00:00.000Z"
},
"message": "Consulta realizada com sucesso."
}Campos retornados
| Campo | Descrição |
|---|---|
| ip_resultado.pais / regiao / cidade | Localização aproximada. |
| ip_resultado.isp / organizacao | Provedor e organização. |
| ip_resultado.asn / asn_nome | Sistema autônomo (ASN). |
| ip_resultado.alertas | Sinais de proxy/VPN, hosting e rede móvel. |
| ip_resultado.latitude / longitude | Coordenadas aproximadas e link de mapa. |
Perguntas frequentes
Aceita IPv6 e domínio?
Sim. O endpoint aceita IPv4, IPv6 e nomes de domínio; entradas inválidas ou IPs privados retornam erro.
A geolocalização é exata?
Não. É uma estimativa em nível de cidade/região baseada em bases de geolocalização — útil para análise de risco, não para localização precisa de pessoas.
Como detectar proxy ou VPN?
O campo ip_resultado.alertas indica quando o IP pertence a proxy/VPN, data center (hosting) ou rede móvel — sinais úteis para pontuar risco em antifraude.
Endpoints relacionados
Integre consulta de ip hoje
Ative um plano a partir de R$ 10, gere seu token Bearer e comece a consultar em minutos. Consultas ilimitadas enquanto o plano estiver ativo.