API de zona horaria por IP

Obtené el timezone IANA de cualquier dirección IPv4 o IPv6, junto con país, región y ciudad, en una sola llamada JSON. Usalo para mostrar horas locales, programar emails y precargar la zona horaria sin preguntarle al usuario.

Registrarse Leer la documentación

Free: 1.000 req/mes · HTTPS · uso personal y no comercial

Ejemplo

Consultá una IP y quedate con la zona horaria y la ubicación usando jq:

GET /v0/ip/{ip} 
$ curl -s https://api.networkdatalabs.com/v0/ip/8.8.8.8 \
    -H "Authorization: Bearer YOUR_API_KEY" \
    | jq '.location | {timezone, country_code, region, city}'

{
  "timezone": "America/Los_Angeles",
  "country_code": "US",
  "region": "California",
  "city": "Mountain View"
}

timezone es un nombre IANA como America/Los_Angeles o America/Chicago, así que lo pasás directo a Intl.DateTimeFormat, zoneinfo de Python o cualquier librería de fechas, y el horario de verano lo resuelve tu runtime. ¿Tenés una lista? POST /v0/bulk (planes pagos) acepta hasta 100 IPs por request con el mismo esquema; cada IP cuenta para la cuota mensual.

Campos de la respuesta

  • location.timezone — nombre de zona horaria IANA, o null cuando la IP no tiene ubicación.
  • Ubicación — country_code, country, region, region_code, city, latitude, longitude, accuracy_radius_km y confidence.
  • Red — ASN, organización del AS e ISP, en la misma llamada.

Es el mismo lookup GET /v0/ip/{ip} que nuestra API de geolocalización de IP: el timezone viene en todos los planes, incluido Free.

Para qué lo usan los equipos

  • Horas locales en la UI — mostrar fechas, vencimientos y eventos en la zona horaria del visitante desde la primera carga
  • Enviar a la hora correcta — programar emails, notificaciones y recordatorios para la mañana del destinatario, no la tuya
  • Valores por defecto — precargar la zona horaria en el registro y que el usuario la confirme
  • Chequeos de consistencia — comparar el timezone de la IP con el que reporta el navegador como una señal más en tu lógica de riesgo

Lo que no hace

  • Es la zona horaria de la IP, no la configuración del usuario. Detrás de una VPN o un relay de privacidad, es la de la ubicación de salida. Dejá que el usuario la cambie.
  • Puede ser null. Direcciones bogon, privadas y algunas anycast pueden no tener ubicación; usá un fallback como UTC.

FAQ

¿En qué formato viene la zona horaria?

Un nombre de la base IANA (por ejemplo America/Los_Angeles), no un offset fijo de UTC, así tu librería de fechas maneja bien el horario de verano.

¿Soporta IPv6?

Sí. GET /v0/ip/{ip} y POST /v0/bulk aceptan direcciones IPv4 e IPv6 (por ejemplo 2001:4860:4860::8888). Una IP mal formada devuelve 400 INVALID_IP.

¿Hay plan gratis?

Sí: 1.000 requests por mes calendario UTC con geolocalización (incluida la zona horaria) + ASN, 1 request por segundo, para uso personal y no comercial. Los planes pagos arrancan en US$9/mes (US$90/año), llegan pronto y no tienen cargos por excedente.

Empezá a construir

Creá una cuenta gratis, o leé el quickstart y la referencia completa en la documentación.

Registrarse Leer la documentación

APIs relacionadas