API de atardecer

Consulta la hora y la calidad del atardecer de cualquier ciudad desde tus propios proyectos. Devuelve la hora del atardecer, la puntuación de calidad y los datos del cielo.

El widget y la API forman parte del plan Pro, que todavía no está a la venta. Esta página explica cómo funcionarán cuando llegue.

La API está disponible en el plan Pro con una clave de acceso. Mira los precios para empezar. Tu cuenta admite hasta 500 peticiones al día, sumando todas tus claves.

La clave

Crea tu clave en Mi cuenta, API. Te la mostramos una sola vez, así que guárdala en un lugar seguro. Envíala en cada petición en la cabecera Authorization: Bearer tu-clave. Si una clave se filtra, revócala y crea otra.

La petición

GET https://atardecer-dehoy.com/api/v1/pronostico/{slug}/

El slug de una ciudad es la última parte de la dirección de su página: para Madrid es madrid-espana.

Parámetro	Qué indica
`evento`	`atardecer` o `amanecer`. Sin él, el atardecer.
`dias`	Cuántos días incluir en `dias`, de 1 a 14, hoy incluido. Sin él, solo hoy.
`idioma`	`es`, `pt` o `en`: el idioma de los textos de la respuesta (la banda, el nombre del lugar y su país, los mensajes de error). Los nombres de los campos no cambian. Sin él, español.

curl -H "Authorization: Bearer tu-clave" \
  "https://atardecer-dehoy.com/api/v1/pronostico/madrid-espana/?evento=atardecer&dias=3"

La respuesta

Esta es una respuesta real, de hoy, para Madrid. Las horas van en UTC, en formato ISO 8601; calidad va de 0 a 100, y estimacion es true cuando todavía no hay pronóstico en vivo y la cifra sale de lo habitual en esa época del año.

{
  "ciudad": {
    "slug": "madrid-espana",
    "nombre": "Madrid",
    "pais": "España",
    "zonaHoraria": "Europe/Madrid",
    "latitud": 40.4165,
    "longitud": -3.7026
  },
  "evento": "atardecer",
  "hoy": {
    "fecha": "2026-11-01",
    "hora": "2026-11-01T17:11:00.000Z",
    "calidad": 58,
    "banda": "Bueno",
    "confianza": "alta",
    "estimacion": false,
    "cielo": {
      "nubesPorcentaje": 0,
      "nubesBajasPorcentaje": 0,
      "nubesAltasPorcentaje": 0,
      "humedadPorcentaje": 39,
      "vientoKmh": 5.6,
      "visibilidadMetros": 43440,
      "probabilidadLluviaPorcentaje": 0
    }
  },
  "dias": [
    {
      "fecha": "2026-11-01",
      "hora": "2026-11-01T17:11:00.000Z",
      "calidad": 58,
      "banda": "Bueno",
      "estimacion": false
    },
    {
      "fecha": "2026-11-02",
      "hora": "2026-11-02T17:10:00.000Z",
      "calidad": 83,
      "banda": "Excelente",
      "estimacion": false
    },
    {
      "fecha": "2026-11-03",
      "hora": "2026-11-03T17:09:00.000Z",
      "calidad": 62,
      "banda": "Bueno",
      "estimacion": false
    }
  ],
  "atribucion": "Atardecer de Hoy, https://atardecer-dehoy.com/fuentes-de-datos/"
}

Los errores

Estado	Código	Qué pasó
401	`missing_key`	Falta la clave. Envíala en la cabecera Authorization: Bearer <clave>.
401	`invalid_key`	La clave no es válida o fue revocada.
403	`plan_without_api`	La cuenta de esta clave no tiene un plan con acceso a la API.
404	`city_not_found`	No hay ninguna ciudad con ese slug.
429	`daily_limit`	Se alcanzó el límite diario de peticiones de tu cuenta, que suma todas tus claves.

La atribución

Si muestras estos datos en tu sitio, enlaza a nuestras fuentes de datos, como indica el campo atribucion: los datos del cielo tienen una licencia que lo pide.