Histórico

HG BrasilWeather
Acesse dados passados de previsão do tempo, essenciais para análises de tendências e comparações de desempenho ao longo do tempo.

Você pode obter dados históricos de previsão do tempo utilizando parâmetros que filtram por data.

Esse método necessita de um plano que tenha suporte a dados históricos.

Requisição

As requisições têm como base o seguinte endpoint:

GET
https://api.hgbrasil.com/weather/historical?key=suachave

Você pode obter dados históricos de previsão do tempo para uma localidade através de um dos seguintes métodos:

Para definir o intervalo de dados a serem consultados, você pode utilizar um dos seguintes métodos:

Por intervalo de datas

start_date
string
Data de inicio no formato yyyy-mm-dd.
end_date
string
Data de término no formato yyyy-mm-dd.

Por uma data específica

date
string
Data no formato yyyy-mm-dd.

Por número de dias atrás

days_ago
number
Número de dias atrás.

Modos

Juntamente com uma das datas, é possível definir o modo de retorno dos dados:

mode
string
As opções são all, hourly (apenas os registros por hora) ou summary (apenas o resumo).

Exemplo

Logo, você provavelmente irá utilizar um endpoint como o seguinte:

GET
https://api.hgbrasil.com/weather/historical?woeid=455903&days_ago=3&mode=all&key=suachave
curl -X GET "https://api.hgbrasil.com/weather/historical?woeid=455903&days_ago=3&mode=all&key=suachave"

Resposta

{
  "by": "days_ago",
  "mode": "all",
  "valid_key": true,
  "city_woeid": 455903,
  "results": {
    "2026-11-21": {
      "city": "Ribeirão Preto, SP",
      "sunrise": "05:21 am",
      "sunset": "06:33 pm",
      "temp": {
        "max": 34,
        "min": 22,
        "avg": 28.1
      },
      "humidity": {
        "max": 100,
        "min": 45,
        "avg": 70.3
      },
      "cloudiness": {
        "max": 100,
        "min": 0,
        "avg": 52.3
      },
      "rain": {
        "max": 1,
        "min": 0,
        "avg": 0.1
      },
      "wind_speedy": {
        "max": 29.6,
        "min": 3.7,
        "avg": 12.9
      },
      "hourly": {
        "00:01": {
          "temp": 26,
          "humidity": 69,
          "cloudiness": 0,
          "rain": 0.99,
          "wind_speedy": "9.25 km/h",
          "wind_direction": 120,
          "condition_code": "40",
          "condition_slug": "rain"
        },
        "01:02": {
          "temp": 25,
          "humidity": 78,
          "cloudiness": 40,
          "rain": 0,
          "wind_speedy": "12.96 km/h",
          "wind_direction": 110,
          "condition_code": "29",
          "condition_slug": "cloudly_night"
        },
        "02:01": {
          "temp": 26,
          "humidity": 69,
          "cloudiness": 75,
          "rain": 0.24,
          "wind_speedy": "20.38 km/h",
          "wind_direction": 130,
          "condition_code": "40",
          "condition_slug": "rain"
        },
        "03:01": {
          "temp": 25,
          "humidity": 73,
          "cloudiness": 75,
          "rain": 0.49,
          "wind_speedy": "11.12 km/h",
          "wind_direction": 0,
          "condition_code": "4",
          "condition_slug": "storm"
        },
        "04:01": {
          "temp": 23,
          "humidity": 88,
          "cloudiness": 100,
          "rain": 0.1,
          "wind_speedy": "11.12 km/h",
          "wind_direction": 0,
          "condition_code": "40",
          "condition_slug": "rain"
        },
        "05:01": {
          "temp": 23,
          "humidity": 88,
          "cloudiness": 100,
          "rain": 0.12,
          "wind_speedy": "18.5 km/h",
          "wind_direction": 120,
          "condition_code": "40",
          "condition_slug": "rain"
        },
        "06:01": {
          "temp": 22,
          "humidity": 88,
          "cloudiness": 0,
          "rain": 0.11,
          "wind_speedy": "12.96 km/h",
          "wind_direction": 80,
          "condition_code": "40",
          "condition_slug": "rain"
        },
        "07:01": {
          "temp": 22,
          "humidity": 94,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "3.71 km/h",
          "wind_direction": 0,
          "condition_code": "27",
          "condition_slug": "clear_day"
        },
        "08:01": {
          "temp": 27,
          "humidity": 100,
          "cloudiness": 100,
          "rain": 0,
          "wind_speedy": "3.96 km/h",
          "wind_direction": 235,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "09:01": {
          "temp": 29,
          "humidity": 100,
          "cloudiness": 100,
          "rain": 0,
          "wind_speedy": "6.41 km/h",
          "wind_direction": 32,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "10:01": {
          "temp": 28,
          "humidity": 69,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "9.25 km/h",
          "wind_direction": 40,
          "condition_code": "27",
          "condition_slug": "clear_day"
        },
        "11:01": {
          "temp": 30,
          "humidity": 81,
          "cloudiness": 100,
          "rain": 0,
          "wind_speedy": "16.67 km/h",
          "wind_direction": 320,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "12:01": {
          "temp": 31,
          "humidity": 76,
          "cloudiness": 100,
          "rain": 0,
          "wind_speedy": "29.63 km/h",
          "wind_direction": 310,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "13:01": {
          "temp": 32,
          "humidity": 71,
          "cloudiness": 100,
          "rain": 0,
          "wind_speedy": "22.21 km/h",
          "wind_direction": 300,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "14:01": {
          "temp": 33,
          "humidity": 64,
          "cloudiness": 100,
          "rain": 0,
          "wind_speedy": "16.67 km/h",
          "wind_direction": 320,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "15:01": {
          "temp": 34,
          "humidity": 50,
          "cloudiness": 75,
          "rain": 0,
          "wind_speedy": "11.12 km/h",
          "wind_direction": 300,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "16:01": {
          "temp": 33,
          "humidity": 45,
          "cloudiness": 20,
          "rain": 0,
          "wind_speedy": "12.96 km/h",
          "wind_direction": 260,
          "condition_code": "29",
          "condition_slug": "cloudly_day"
        },
        "17:01": {
          "temp": 33,
          "humidity": 47,
          "cloudiness": 20,
          "rain": 0,
          "wind_speedy": "14.83 km/h",
          "wind_direction": 280,
          "condition_code": "29",
          "condition_slug": "cloudly_day"
        },
        "18:01": {
          "temp": 31,
          "humidity": 45,
          "cloudiness": 75,
          "rain": 0,
          "wind_speedy": "14.83 km/h",
          "wind_direction": 290,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "19:01": {
          "temp": 30,
          "humidity": 51,
          "cloudiness": 75,
          "rain": 0,
          "wind_speedy": "12.96 km/h",
          "wind_direction": 300,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "20:01": {
          "temp": 29,
          "humidity": 54,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "12.96 km/h",
          "wind_direction": 300,
          "condition_code": "27",
          "condition_slug": "clear_night"
        },
        "21:01": {
          "temp": 28,
          "humidity": 57,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "9.25 km/h",
          "wind_direction": 280,
          "condition_code": "27",
          "condition_slug": "clear_night"
        },
        "22:01": {
          "temp": 27,
          "humidity": 65,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "9.25 km/h",
          "wind_direction": 290,
          "condition_code": "27",
          "condition_slug": "clear_night"
        },
        "23:01": {
          "temp": 27,
          "humidity": 65,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "7.42 km/h",
          "wind_direction": 290,
          "condition_code": "27",
          "condition_slug": "clear_night"
        }
      }
    },
    "2026-11-20": {
      "city": "Ribeirão Preto, SP",
      "sunrise": "05:21 am",
      "sunset": "06:32 pm",
      "temp": {
        "max": 36,
        "min": 23,
        "avg": 29.8
      },
      "humidity": {
        "max": 100,
        "min": 34,
        "avg": 62.5
      },
      "cloudiness": {
        "max": 100,
        "min": 0,
        "avg": 22.9
      },
      "rain": {
        "max": 1.2,
        "min": 0,
        "avg": 0.1
      },
      "wind_speedy": {
        "max": 18.5,
        "min": 2.9,
        "avg": 8.6
      },
      "hourly": {
        "00:01": {
          "temp": 26,
          "humidity": 69,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "5.54 km/h",
          "wind_direction": 310,
          "condition_code": "27",
          "condition_slug": "clear_night"
        },
        "01:01": {
          "temp": 26,
          "humidity": 69,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "3.71 km/h",
          "wind_direction": 320,
          "condition_code": "27",
          "condition_slug": "clear_night"
        },
        "02:01": {
          "temp": 25,
          "humidity": 78,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "3.71 km/h",
          "wind_direction": 20,
          "condition_code": "27",
          "condition_slug": "clear_night"
        },
        "03:01": {
          "temp": 24,
          "humidity": 83,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "5.54 km/h",
          "wind_direction": 10,
          "condition_code": "27",
          "condition_slug": "clear_night"
        },
        "04:01": {
          "temp": 24,
          "humidity": 83,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "5.54 km/h",
          "wind_direction": 20,
          "condition_code": "27",
          "condition_slug": "clear_night"
        },
        "05:01": {
          "temp": 24,
          "humidity": 83,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "3.71 km/h",
          "wind_direction": 330,
          "condition_code": "27",
          "condition_slug": "clear_night"
        },
        "06:01": {
          "temp": 23,
          "humidity": 88,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "3.71 km/h",
          "wind_direction": 80,
          "condition_code": "27",
          "condition_slug": "clear_day"
        },
        "07:01": {
          "temp": 27,
          "humidity": 100,
          "cloudiness": 100,
          "rain": 0,
          "wind_speedy": "4.14 km/h",
          "wind_direction": 46,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "08:01": {
          "temp": 28,
          "humidity": 100,
          "cloudiness": 100,
          "rain": 0,
          "wind_speedy": "2.88 km/h",
          "wind_direction": 22,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "09:01": {
          "temp": 30,
          "humidity": 80,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "3.71 km/h",
          "wind_direction": 280,
          "condition_code": "27",
          "condition_slug": "clear_day"
        },
        "10:01": {
          "temp": 31,
          "humidity": 70,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "7.42 km/h",
          "wind_direction": 330,
          "condition_code": "27",
          "condition_slug": "clear_day"
        },
        "11:01": {
          "temp": 33,
          "humidity": 59,
          "cloudiness": 20,
          "rain": 0,
          "wind_speedy": "9.25 km/h",
          "wind_direction": 360,
          "condition_code": "29",
          "condition_slug": "cloudly_day"
        },
        "12:01": {
          "temp": 34,
          "humidity": 51,
          "cloudiness": 40,
          "rain": 0,
          "wind_speedy": "7.42 km/h",
          "wind_direction": 350,
          "condition_code": "29",
          "condition_slug": "cloudly_day"
        },
        "13:01": {
          "temp": 34,
          "humidity": 40,
          "cloudiness": 40,
          "rain": 0,
          "wind_speedy": "14.83 km/h",
          "wind_direction": 30,
          "condition_code": "29",
          "condition_slug": "cloudly_day"
        },
        "14:01": {
          "temp": 36,
          "humidity": 37,
          "cloudiness": 75,
          "rain": 0,
          "wind_speedy": "16.67 km/h",
          "wind_direction": 340,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "15:01": {
          "temp": 35,
          "humidity": 34,
          "cloudiness": 75,
          "rain": 0,
          "wind_speedy": "16.67 km/h",
          "wind_direction": 330,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "16:01": {
          "temp": 35,
          "humidity": 36,
          "cloudiness": 40,
          "rain": 0,
          "wind_speedy": "18.5 km/h",
          "wind_direction": 330,
          "condition_code": "29",
          "condition_slug": "cloudly_day"
        },
        "17:01": {
          "temp": 36,
          "humidity": 34,
          "cloudiness": 40,
          "rain": 0,
          "wind_speedy": "12.96 km/h",
          "wind_direction": 300,
          "condition_code": "29",
          "condition_slug": "cloudly_day"
        },
        "18:01": {
          "temp": 35,
          "humidity": 36,
          "cloudiness": 20,
          "rain": 0.13,
          "wind_speedy": "14.83 km/h",
          "wind_direction": 300,
          "condition_code": "40",
          "condition_slug": "rain"
        },
        "19:01": {
          "temp": 34,
          "humidity": 40,
          "cloudiness": 0,
          "rain": 0.13,
          "wind_speedy": "12.96 km/h",
          "wind_direction": 280,
          "condition_code": "40",
          "condition_slug": "rain"
        },
        "20:01": {
          "temp": 33,
          "humidity": 43,
          "cloudiness": 0,
          "rain": 0.17,
          "wind_speedy": "5.54 km/h",
          "wind_direction": 280,
          "condition_code": "40",
          "condition_slug": "rain"
        },
        "21:01": {
          "temp": 28,
          "humidity": 61,
          "cloudiness": 0,
          "rain": 0.39,
          "wind_speedy": "9.25 km/h",
          "wind_direction": 100,
          "condition_code": "40",
          "condition_slug": "rain"
        },
        "22:01": {
          "temp": 28,
          "humidity": 61,
          "cloudiness": 0,
          "rain": 0.3,
          "wind_speedy": "9.25 km/h",
          "wind_direction": 130,
          "condition_code": "40",
          "condition_slug": "rain"
        },
        "23:01": {
          "temp": 27,
          "humidity": 65,
          "cloudiness": 0,
          "rain": 1.19,
          "wind_speedy": "9.25 km/h",
          "wind_direction": 90,
          "condition_code": "45",
          "condition_slug": "rain"
        }
      }
    },
    "2026-11-19": {
      "city": "Ribeirão Preto, SP",
      "sunrise": "05:21 am",
      "sunset": "06:32 pm",
      "temp": {
        "max": 34,
        "min": 22,
        "avg": 28.3
      },
      "humidity": {
        "max": 100,
        "min": 36,
        "avg": 66.4
      },
      "cloudiness": {
        "max": 91,
        "min": 0,
        "avg": 32.4
      },
      "rain": {
        "max": 0.1,
        "min": 0,
        "avg": 0
      },
      "wind_speedy": {
        "max": 16.7,
        "min": 3.7,
        "avg": 10.1
      },
      "hourly": {
        "00:01": {
          "temp": 23,
          "humidity": 83,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "9.25 km/h",
          "wind_direction": 100,
          "condition_code": "27",
          "condition_slug": "clear_night"
        },
        "01:01": {
          "temp": 22,
          "humidity": 88,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "9.25 km/h",
          "wind_direction": 120,
          "condition_code": "27",
          "condition_slug": "clear_night"
        },
        "02:01": {
          "temp": 22,
          "humidity": 88,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "9.25 km/h",
          "wind_direction": 160,
          "condition_code": "27",
          "condition_slug": "clear_night"
        },
        "03:01": {
          "temp": 22,
          "humidity": 88,
          "cloudiness": 40,
          "rain": 0.1,
          "wind_speedy": "9.25 km/h",
          "wind_direction": 160,
          "condition_code": "40",
          "condition_slug": "rain"
        },
        "04:01": {
          "temp": 23,
          "humidity": 83,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "3.71 km/h",
          "wind_direction": 110,
          "condition_code": "27",
          "condition_slug": "clear_night"
        },
        "05:01": {
          "temp": 22,
          "humidity": 88,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "9.25 km/h",
          "wind_direction": 50,
          "condition_code": "27",
          "condition_slug": "clear_night"
        },
        "06:01": {
          "temp": 22,
          "humidity": 88,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "3.71 km/h",
          "wind_direction": 150,
          "condition_code": "27",
          "condition_slug": "clear_day"
        },
        "07:01": {
          "temp": 25,
          "humidity": 100,
          "cloudiness": 91,
          "rain": 0,
          "wind_speedy": "3.89 km/h",
          "wind_direction": 4,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "08:01": {
          "temp": 27,
          "humidity": 100,
          "cloudiness": 74,
          "rain": 0,
          "wind_speedy": "7.24 km/h",
          "wind_direction": 8,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "09:01": {
          "temp": 29,
          "humidity": 91,
          "cloudiness": 62,
          "rain": 0,
          "wind_speedy": "7.49 km/h",
          "wind_direction": 354,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "10:01": {
          "temp": 30,
          "humidity": 71,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "14.83 km/h",
          "wind_direction": 290,
          "condition_code": "27",
          "condition_slug": "clear_day"
        },
        "11:01": {
          "temp": 32,
          "humidity": 66,
          "cloudiness": 75,
          "rain": 0,
          "wind_speedy": "16.67 km/h",
          "wind_direction": 290,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "12:01": {
          "temp": 32,
          "humidity": 59,
          "cloudiness": 75,
          "rain": 0,
          "wind_speedy": "12.96 km/h",
          "wind_direction": 320,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "13:01": {
          "temp": 33,
          "humidity": 43,
          "cloudiness": 75,
          "rain": 0,
          "wind_speedy": "14.83 km/h",
          "wind_direction": 290,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "14:01": {
          "temp": 33,
          "humidity": 43,
          "cloudiness": 75,
          "rain": 0,
          "wind_speedy": "14.83 km/h",
          "wind_direction": 290,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "15:01": {
          "temp": 33,
          "humidity": 40,
          "cloudiness": 75,
          "rain": 0,
          "wind_speedy": "16.67 km/h",
          "wind_direction": 280,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "16:01": {
          "temp": 34,
          "humidity": 38,
          "cloudiness": 75,
          "rain": 0,
          "wind_speedy": "14.83 km/h",
          "wind_direction": 230,
          "condition_code": "28",
          "condition_slug": "cloud"
        },
        "17:01": {
          "temp": 34,
          "humidity": 36,
          "cloudiness": 20,
          "rain": 0,
          "wind_speedy": "14.83 km/h",
          "wind_direction": 230,
          "condition_code": "29",
          "condition_slug": "cloudly_day"
        },
        "18:01": {
          "temp": 32,
          "humidity": 43,
          "cloudiness": 20,
          "rain": 0,
          "wind_speedy": "12.96 km/h",
          "wind_direction": 220,
          "condition_code": "29",
          "condition_slug": "cloudly_day"
        },
        "19:01": {
          "temp": 32,
          "humidity": 40,
          "cloudiness": 20,
          "rain": 0,
          "wind_speedy": "11.12 km/h",
          "wind_direction": 240,
          "condition_code": "29",
          "condition_slug": "cloudly_night"
        },
        "20:01": {
          "temp": 32,
          "humidity": 43,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "9.25 km/h",
          "wind_direction": 240,
          "condition_code": "27",
          "condition_slug": "clear_night"
        },
        "21:01": {
          "temp": 31,
          "humidity": 48,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "3.71 km/h",
          "wind_direction": 200,
          "condition_code": "27",
          "condition_slug": "clear_night"
        },
        "22:01": {
          "temp": 28,
          "humidity": 61,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "7.42 km/h",
          "wind_direction": 40,
          "condition_code": "27",
          "condition_slug": "clear_night"
        },
        "23:01": {
          "temp": 27,
          "humidity": 65,
          "cloudiness": 0,
          "rain": 0,
          "wind_speedy": "5.54 km/h",
          "wind_direction": 20,
          "condition_code": "27",
          "condition_slug": "clear_night"
        }
      }
    }
  },
  "execution_time": 0.73,
  "from_cache": false
}