🌐
Consulta IP
API para geolocalização e informações detalhadas de endereços IP. Retorna país, estado, cidade, provedor, coordenadas e mais.
Planos Disponíveis
Gratuito
Grátis
Consultas/minuto
3
requisições/dia
300
requisições/mês
5,000
3 consultas por minuto. 300 consultas/dia. 5.000 consultas/mês.
Começar GrátisDocumentação da API
Autenticação
Todas as requisições devem incluir o token no header:
Authorization: Bearer your_token
O token é gerado ao assinar um plano. Cadastre-se para obter o seu.
GET
/api/v1/ip/{ip}
Consultar informações de um IP
Parâmetros
| Param | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ip | string | Sim | Endereço IPv4 ou IPv6 |
Exemplo de Requisição
curl "https://pwapi.net/api/v1/ip/192.145.220.95" -H "Authorization: Bearer your_token"
Resposta de Sucesso 200
{
"success": true,
"data": {
"country_code": "BR",
"country_name": "Brazil",
"country_name_ptbr": "Brasil",
"region_name": "Ceará",
"region_code": "CE",
"city_name": "Forquilha",
"postal_code": "62115",
"latitude": "-3.8335",
"longitude": "-40.2343",
"accuracy_radius": 20,
"timezone": "America/Fortaleza",
"continent_code": "SA",
"continent_name": "South America",
"is_eu": false,
"asn": 271296,
"as_name": "IX-NETWORK ULTRA LTDA",
"is_proxy": false,
"proxy_type": null,
"isp": null,
"domain": null,
"usage_type": null,
"threat": null,
"last_seen": null,
"is_anonymous_proxy": false,
"is_satellite": false,
"is_anycast": null,
"country_alpha3": "BRA",
"capital": "Brasilia",
"currency_code": "BRL",
"currency_name": "Brazilian Real",
"idd_code": "55",
"cctld": "br",
"population": "218689757",
"total_area": "8514877"
}
}
Códigos de Erro
401 Não autenticado
403 Sem permissão
404 IP não encontrado
422 IP inválido
429 Rate limit
500 Erro interno
Headers de Rate Limit
Toda resposta inclui headers com informações de uso:
| Header | Descrição |
|---|---|
X-RateLimit-Daily-Limit | Limite diário do plano |
X-RateLimit-Daily-Remaining | Requisições restantes hoje |
X-RateLimit-Monthly-Limit | Limite mensal do plano |
X-RateLimit-Monthly-Remaining | Requisições restantes no mês |