IP

Geolocalização de IP

País, cidade, coordenadas e provedor de rede a partir de um endereço IP. Cinco fontes de dados diferentes, com fallback automático entre elas quando uma falha ou não tem o dado.

IP geolocation

Country, city, coordinates and network provider from an IP address. Five different data sources, with automatic fallback between them when one fails or lacks the data.

SYNC resposta na mesma chamada answers in the same call

Endpoints

GET /api/v1/ip/{ip} geolocaliza um IP específico geolocates a specific IP

GET /api/v1/ip/self geolocaliza quem está chamando geolocates the caller

Parâmetros

Parameters

Nome	Name	Onde	In	Descrição	Description
`ip`	path	IPv4 ou IPv6 público — endereços privados/reservados (10.0.0.0/8, 127.0.0.1, etc.) retornam 400	public IPv4 or IPv6 — private/reserved addresses (10.0.0.0/8, 127.0.0.1, etc.) return 400

Exemplo

Example

curl https://ip.alicercelabs.com.br/api/v1/ip/8.8.8.8 \
  -H "Authorization: Bearer <token>"

{
  "success": true,
  "data": {
    "ip": "8.8.8.8",
    "country": "United States",
    "country_code": "US",
    "region": "California",
    "city": "Mountain View",
    "lat": 37.4056,
    "lon": -122.0775,
    "timezone": "America/Los_Angeles",
    "isp": "Google LLC",
    "org": "Google Public DNS",
    "asn": "AS15169"
  },
  "meta": { "elapsed_ms": 4, "request_id": "..." }
}

Erros possíveis

Possible errors

Status	Motivo	Reason
400	formato de IP inválido, ou IP privado/reservado	invalid IP format, or a private/reserved IP
401	token ausente ou inválido	missing or invalid token
429	limite de taxa excedido	rate limit exceeded
500	todas as fontes de dados falharam pra esse IP	every data source failed for that IP

Limites

Limits

10.000/dia · 416/hora, por IP chamador, contado separadamente pra lookup e self. Respostas ficam em cache por 6 meses — chamadas repetidas pro mesmo IP não consomem uma nova consulta às fontes upstream, só a cota da própria API.

10,000/day · 416/hour, per calling IP, counted separately for lookup and self. Responses are cached for 6 months — repeat calls for the same IP don't hit upstream sources again, only the API's own quota.