Atardecer de Hoy
Entrar

API de pôr do sol

Consulte o horário e a qualidade do pôr do sol de qualquer cidade nos seus próprios projetos. A API devolve o horário do pôr do sol, a nota de qualidade e os dados do céu.

O widget e a API fazem parte do plano Pro, que ainda não está à venda. Esta página explica como vão funcionar quando ele chegar.

A API está disponível no plano Pro, com uma chave de acesso. Veja os preços para começar. Sua conta permite até 500 requisições por dia, somando todas as suas chaves.

A chave

Crie sua chave em Minha conta, API. Ela aparece uma única vez, então guarde-a em um lugar seguro. Envie-a em cada requisição no cabeçalho Authorization: Bearer sua-chave. Se uma chave vazar, revogue-a e crie outra.

A requisição

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

O slug de uma cidade é a última parte do endereço da página dela: para Rio de Janeiro é rio-de-janeiro-brasil. Os slugs são os mesmos em todos os idiomas.

ParâmetroO que indica
eventoatardecer (pôr do sol) ou amanecer (nascer do sol). Sem ele, o pôr do sol.
diasQuantos dias incluir em dias, de 1 a 14, contando hoje. Sem ele, só hoje.
idiomaes, pt ou en: o idioma dos textos da resposta (a faixa, o nome do lugar e o país, as mensagens de erro). Os nomes dos campos não mudam. Sem ele, espanhol.
curl -H "Authorization: Bearer sua-chave" \
  "https://atardecer-dehoy.com/api/v1/pronostico/rio-de-janeiro-brasil/?evento=atardecer&dias=3&idioma=pt"

A resposta

Esta é uma resposta real, de hoje, para Rio de Janeiro, com idioma=pt. Os horários estão em UTC, no formato ISO 8601; calidad é a nota de 0 a 100, banda é a faixa dessa nota, e estimacion é true quando ainda não há previsão ao vivo e o número vem do que é habitual nessa época do ano. Os campos do céu (cielo) são as nuvens, a umidade, o vento, a visibilidade e a chance de chuva.

{
  "ciudad": {
    "slug": "rio-de-janeiro-brasil",
    "nombre": "Rio de Janeiro",
    "pais": "Brasil",
    "zonaHoraria": "America/Sao_Paulo",
    "latitud": -22.9064,
    "longitud": -43.1822
  },
  "evento": "atardecer",
  "hoy": {
    "fecha": "2026-10-31",
    "hora": "2026-10-31T21:04:00.000Z",
    "calidad": 63,
    "banda": "Bom",
    "confianza": "alta",
    "estimacion": false,
    "cielo": {
      "nubesPorcentaje": 65,
      "nubesBajasPorcentaje": 64,
      "nubesAltasPorcentaje": 2,
      "humedadPorcentaje": 86,
      "vientoKmh": 8.6,
      "visibilidadMetros": 21560,
      "probabilidadLluviaPorcentaje": 0
    }
  },
  "dias": [
    {
      "fecha": "2026-10-31",
      "hora": "2026-10-31T21:04:00.000Z",
      "calidad": 63,
      "banda": "Bom",
      "estimacion": false
    },
    {
      "fecha": "2026-11-01",
      "hora": "2026-11-01T21:05:00.000Z",
      "calidad": 42,
      "banda": "Bom",
      "estimacion": false
    },
    {
      "fecha": "2026-11-02",
      "hora": "2026-11-02T21:05:00.000Z",
      "calidad": 36,
      "banda": "Regular",
      "estimacion": false
    }
  ],
  "atribucion": "Atardecer de Hoy, https://atardecer-dehoy.com/pt/fontes-de-dados/"
}

Os erros

StatusCódigoO que aconteceu
401missing_keyFalta a chave. Envie no cabeçalho Authorization: Bearer <chave>.
401invalid_keyA chave não é válida ou foi revogada.
403plan_without_apiA conta desta chave não tem um plano com acesso à API.
404city_not_foundNão há nenhuma cidade com esse slug.
429daily_limitO limite diário de requisições da sua conta, somando todas as suas chaves, foi atingido.

A atribuição

Se você mostrar estes dados no seu site, coloque um link para as nossas fontes de dados, como indica o campo atribucion: os dados do céu têm uma licença que exige isso.