Pular para conteúdo
🌐

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átis

Documentaçã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

ParamTipoObrigatórioDescrição
ipstringSimEndereço IPv4 ou IPv6

Exemplo de Requisição

curl "https://www.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:

HeaderDescrição
X-RateLimit-Daily-LimitLimite diário do plano
X-RateLimit-Daily-RemainingRequisições restantes hoje
X-RateLimit-Monthly-LimitLimite mensal do plano
X-RateLimit-Monthly-RemainingRequisições restantes no mês

Pronto para começar?

Cadastre-se gratuitamente e comece a usar a API em minutos.

Criar Conta Grátis