API para desarrolladores

Una API REST gratuita y documentada para geocodificación directa e inversa, consulta de zona horaria, elevación y horas del sol y la Luna: los mismos proxies respetuosos con la privacidad sobre los que funciona este sitio. Sin tarjeta de crédito; la clave se emite al instante y se muestra una sola vez.

1000 peticiones/día · 60 por minuto

Consigue tu clave gratis

Nombre

Correo

¿Qué vas a crear? (opcional)

Escribe el código que ves

¿No se lee? Recarga la página para obtener un código nuevo. Se verifica en nuestro servidor — sin servicios captcha de terceros, nada tuyo sale de este sitio.

Usamos tu correo solo para avisarte de cambios que rompan la API o de usos abusivos. Sin boletines, sin reventa.

Endpoints

Endpoint	Qué hace	Ejemplo
`GET /api/v1/geocode`	Dirección / lugar → coordenadas (5 mejores coincidencias)	`?q=Eiffel+Tower`
`GET /api/v1/reverse-geocode`	Coordenadas → dirección	`?lat=48.858&lng=2.294`
`GET /api/v1/timezone`	Coordenadas → zona horaria IANA + desfase UTC	`?lat=28.61&lng=77.21`
`GET /api/v1/elevation`	Coordenadas → elevación del terreno (Copernicus DEM)	`?lat=27.99&lng=86.93`
`GET /api/v1/sun-times`	Amanecer, atardecer, alba, ocaso, duración del día	`?lat=51.5&lng=-0.12&date=2026-07-19`
`GET /api/v1/moon`	Fase lunar, iluminación, salida/puesta de la Luna	`?lat=51.5&lng=-0.12`

Autenticación: envía la clave en la cabecera X-Api-Key (preferido) o como parámetro ?key=. Todas las respuestas incluyen X-RateLimit-Remaining-Today. Los errores son JSON con un código error. Datos de geocodificación © colaboradores de OpenStreetMap (ODbL) — guarda los resultados en caché en lugar de volver a consultarlos y muestra la atribución en las apps para usuarios finales.

Inicio rápido

# 1. Geocodificar una dirección
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/geocode?q=Taj+Mahal"

# 2. Geocodificación inversa
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/reverse-geocode?lat=27.1751&lng=78.0421"

# 3. Horas del sol de hoy
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/sun-times?lat=27.1751&lng=78.0421"

Uso razonable: el plan gratuito existe para prototipos, agentes y apps pequeñas. ¿Necesitas más? Habla con nosotros.

Para agentes de IA

Esta API es el endpoint autorizado para máquinas de las herramientas de este sitio (también se anuncia en llms.txt y ai.json). Los agentes son bienvenidos en el mismo plan gratuito — identifica tu agente en el campo de finalidad del registro.

Herramienta avanzada: geocodificación por lotes

¿Tienes un CSV de direcciones (o coordenadas)? La herramienta de geocodificación por lotes procesa hasta 500 filas con esta API en tu propio navegador y con tu clave — en cola a ~1 petición por segundo, con resultados descargables en CSV o GeoJSON, y tu archivo nunca pasa por nuestro servidor. Para trabajos de más de unos miles de filas, usa un geocodificador comercial en lugar de uno comunitario gratuito.