Geolocalización IP

Consulta la ubicación geográfica y datos ASN para direcciones IPv4 e IPv6.

Endpoints

GET /api/v1/ip/{ip}
GET /api/v1/ip          # Usa la dirección IP del cliente

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
ip	string	No	Dirección IPv4 o IPv6

Respuesta

{
  "ip": "8.8.8.8",
  "ipType": "IPV4",
  "countryCode": "US",
  "countryName": "United States",
  "regionName": "California",
  "regionCode": "CA",
  "cityName": "Mountain View",
  "continentCode": "NA",
  "continentName": "North America",
  "lat": 37.386,
  "lng": -122.0838,
  "zipCode": "94035",
  "timezone": "America/Los_Angeles",
  "isEU": false,
  "asn": 15169,
  "asnOrganization": "GOOGLE"
}

Campos de la Respuesta

Campo	Tipo	Descripción
ip	string	La dirección IP consultada
ipType	string	Versión de IP (IPV4 o IPV6)
countryCode	string	Código de país ISO 3166-1 alpha-2
countryName	string	Nombre completo del país
regionName	string	Nombre de la región/estado
regionCode	string	Código de la región/estado
cityName	string	Nombre de la ciudad
continentCode	string	Código de continente (NA, EU, AS, AF, OC, SA, AN)
continentName	string	Nombre completo del continente
lat	number	Latitud
lng	number	Longitud
zipCode	string	Código postal
timezone	string	Identificador de zona horaria IANA
isEU	boolean	Si el país pertenece a la Unión Europea
asn	integer	Número de Sistema Autónomo
asnOrganization	string	Nombre de la organización propietaria del ASN

Notas

• Las direcciones IP locales/privadas (loopback, link-local, site-local) devolverán 404 Not Found
• Funciona con la base de datos MaxMind GeoLite2
• La precisión varía según la ubicación -- generalmente a nivel de ciudad para la mayoría de regiones