Você pode obter dados históricos de previsão do tempo utilizando parâmetros que filtram por data.
As requisições tem como base o seguinte endpoint:
GEThttps://api.hgbrasil.com/weather/historical?key=suachave
Você pode obter dados históricos de previsão do tempo para uma localizadade 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:
yyyy-mm-dd.yyyy-mm-dd.yyyy-mm-dd.Juntamente com uma das datas, é possível definir o modo de retorno dos dados:
all, hourly (apenas os registros por hora) ou summary (apenas o resumo).Logo, você provavelmente irá utilizar um endpoint como o seguinte:
GEThttps://api.hgbrasil.com/weather/historical?woeid=455903&days_ago=3&mode=all&key=suachave
{
"by": "days_ago",
"mode": "all",
"valid_key": true,
"city_woeid": 455903,
"results": {
"2025-11-12": {
"city": "Ribeirão Preto, SP",
"sunrise": "05:23 am",
"sunset": "06:27 pm",
"temp": {
"max": 37,
"min": 19,
"avg": 27.8
},
"humidity": {
"max": 72,
"min": 25,
"avg": 45.4
},
"cloudiness": {
"max": 75,
"min": 0,
"avg": 12.9
},
"rain": {
"max": 0,
"min": 0,
"avg": 0
},
"wind_speedy": {
"max": 3.6,
"min": 1.5,
"avg": 2.4
},
"hourly": {
"00:01": {
"temp": 24,
"humidity": 50,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "2.06 km/h",
"wind_direction": 130,
"condition_code": "27",
"condition_slug": "clear_night"
},
"01:01": {
"temp": 23,
"humidity": 53,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "1.54 km/h",
"wind_direction": 110,
"condition_code": "27",
"condition_slug": "clear_night"
},
"02:01": {
"temp": 21,
"humidity": 64,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "2.06 km/h",
"wind_direction": 60,
"condition_code": "27",
"condition_slug": "clear_night"
},
"03:01": {
"temp": 20,
"humidity": 68,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "2.06 km/h",
"wind_direction": 90,
"condition_code": "27",
"condition_slug": "clear_night"
},
"04:01": {
"temp": 20,
"humidity": 68,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "2.57 km/h",
"wind_direction": 100,
"condition_code": "27",
"condition_slug": "clear_night"
},
"05:01": {
"temp": 19,
"humidity": 72,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "1.54 km/h",
"wind_direction": 40,
"condition_code": "27",
"condition_slug": "clear_night"
},
"06:01": {
"temp": 19,
"humidity": 72,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "2.57 km/h",
"wind_direction": 110,
"condition_code": "27",
"condition_slug": "clear_day"
},
"07:01": {
"temp": 24,
"humidity": 53,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "2.06 km/h",
"wind_direction": 90,
"condition_code": "27",
"condition_slug": "clear_day"
},
"08:01": {
"temp": 25,
"humidity": 50,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "3.09 km/h",
"wind_direction": 100,
"condition_code": "27",
"condition_slug": "clear_day"
},
"09:01": {
"temp": 28,
"humidity": 46,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "3.6 km/h",
"wind_direction": 120,
"condition_code": "27",
"condition_slug": "clear_day"
},
"10:01": {
"temp": 30,
"humidity": 39,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "3.09 km/h",
"wind_direction": 100,
"condition_code": "27",
"condition_slug": "clear_day"
},
"11:01": {
"temp": 32,
"humidity": 34,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "3.09 km/h",
"wind_direction": 80,
"condition_code": "27",
"condition_slug": "clear_day"
},
"12:01": {
"temp": 34,
"humidity": 29,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "2.57 km/h",
"wind_direction": 50,
"condition_code": "27",
"condition_slug": "clear_day"
},
"13:01": {
"temp": 35,
"humidity": 28,
"cloudiness": 20,
"rain": 0,
"wind_speedy": "2.06 km/h",
"wind_direction": 360,
"condition_code": "29",
"condition_slug": "cloudly_day"
},
"14:01": {
"temp": 37,
"humidity": 25,
"cloudiness": 40,
"rain": 0,
"wind_speedy": "2.57 km/h",
"wind_direction": 360,
"condition_code": "29",
"condition_slug": "cloudly_day"
},
"15:01": {
"temp": 34,
"humidity": 29,
"cloudiness": 40,
"rain": 0,
"wind_speedy": "2.57 km/h",
"wind_direction": 200,
"condition_code": "29",
"condition_slug": "cloudly_day"
},
"16:01": {
"temp": 34,
"humidity": 29,
"cloudiness": 75,
"rain": 0,
"wind_speedy": "2.57 km/h",
"wind_direction": 60,
"condition_code": "28",
"condition_slug": "cloud"
},
"17:01": {
"temp": 33,
"humidity": 32,
"cloudiness": 75,
"rain": 0,
"wind_speedy": "2.06 km/h",
"wind_direction": 110,
"condition_code": "28",
"condition_slug": "cloud"
},
"18:01": {
"temp": 33,
"humidity": 34,
"cloudiness": 40,
"rain": 0,
"wind_speedy": "3.09 km/h",
"wind_direction": 110,
"condition_code": "29",
"condition_slug": "cloudly_day"
},
"19:01": {
"temp": 31,
"humidity": 37,
"cloudiness": 20,
"rain": 0,
"wind_speedy": "2.57 km/h",
"wind_direction": 110,
"condition_code": "29",
"condition_slug": "cloudly_night"
},
"20:01": {
"temp": 30,
"humidity": 37,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "3.09 km/h",
"wind_direction": 120,
"condition_code": "27",
"condition_slug": "clear_night"
},
"21:01": {
"temp": 28,
"humidity": 44,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "2.06 km/h",
"wind_direction": 100,
"condition_code": "27",
"condition_slug": "clear_night"
},
"22:01": {
"temp": 27,
"humidity": 47,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "2.57 km/h",
"wind_direction": 130,
"condition_code": "27",
"condition_slug": "clear_night"
},
"23:01": {
"temp": 26,
"humidity": 50,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "1.54 km/h",
"wind_direction": 90,
"condition_code": "27",
"condition_slug": "clear_night"
}
}
},
"2025-11-11": {
"city": "Ribeirão Preto, SP",
"sunrise": "05:23 am",
"sunset": "06:27 pm",
"temp": {
"max": 35,
"min": 18,
"avg": 26.7
},
"humidity": {
"max": 77,
"min": 26,
"avg": 47.2
},
"cloudiness": {
"max": 75,
"min": 0,
"avg": 12.9
},
"rain": {
"max": 0,
"min": 0,
"avg": 0
},
"wind_speedy": {
"max": 5.1,
"min": 1.5,
"avg": 3.5
},
"hourly": {
"00:01": {
"temp": 22,
"humidity": 56,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "3.6 km/h",
"wind_direction": 120,
"condition_code": "27",
"condition_slug": "clear_night"
},
"01:01": {
"temp": 20,
"humidity": 64,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "4.63 km/h",
"wind_direction": 150,
"condition_code": "27",
"condition_slug": "clear_night"
},
"02:01": {
"temp": 19,
"humidity": 68,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "5.14 km/h",
"wind_direction": 140,
"condition_code": "27",
"condition_slug": "clear_night"
},
"03:01": {
"temp": 19,
"humidity": 68,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "3.6 km/h",
"wind_direction": 140,
"condition_code": "27",
"condition_slug": "clear_night"
},
"04:01": {
"temp": 18,
"humidity": 72,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "3.6 km/h",
"wind_direction": 110,
"condition_code": "27",
"condition_slug": "clear_night"
},
"05:01": {
"temp": 18,
"humidity": 77,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "2.06 km/h",
"wind_direction": 130,
"condition_code": "27",
"condition_slug": "clear_night"
},
"06:01": {
"temp": 18,
"humidity": 77,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "2.57 km/h",
"wind_direction": 120,
"condition_code": "27",
"condition_slug": "clear_day"
},
"07:01": {
"temp": 23,
"humidity": 60,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "3.09 km/h",
"wind_direction": 110,
"condition_code": "27",
"condition_slug": "clear_day"
},
"08:01": {
"temp": 24,
"humidity": 54,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "4.12 km/h",
"wind_direction": 110,
"condition_code": "27",
"condition_slug": "clear_day"
},
"09:01": {
"temp": 26,
"humidity": 51,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "5.14 km/h",
"wind_direction": 110,
"condition_code": "27",
"condition_slug": "clear_day"
},
"10:01": {
"temp": 29,
"humidity": 45,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "5.14 km/h",
"wind_direction": 100,
"condition_code": "27",
"condition_slug": "clear_day"
},
"11:01": {
"temp": 32,
"humidity": 37,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "4.12 km/h",
"wind_direction": 100,
"condition_code": "27",
"condition_slug": "clear_day"
},
"12:01": {
"temp": 33,
"humidity": 33,
"cloudiness": 20,
"rain": 0,
"wind_speedy": "4.12 km/h",
"wind_direction": 110,
"condition_code": "29",
"condition_slug": "cloudly_day"
},
"13:01": {
"temp": 34,
"humidity": 31,
"cloudiness": 75,
"rain": 0,
"wind_speedy": "3.6 km/h",
"wind_direction": 110,
"condition_code": "28",
"condition_slug": "cloud"
},
"14:01": {
"temp": 33,
"humidity": 30,
"cloudiness": 75,
"rain": 0,
"wind_speedy": "2.06 km/h",
"wind_direction": 0,
"condition_code": "28",
"condition_slug": "cloud"
},
"15:01": {
"temp": 35,
"humidity": 26,
"cloudiness": 40,
"rain": 0,
"wind_speedy": "2.57 km/h",
"wind_direction": 70,
"condition_code": "29",
"condition_slug": "cloudly_day"
},
"16:01": {
"temp": 34,
"humidity": 28,
"cloudiness": 40,
"rain": 0,
"wind_speedy": "3.09 km/h",
"wind_direction": 80,
"condition_code": "29",
"condition_slug": "cloudly_day"
},
"17:01": {
"temp": 34,
"humidity": 29,
"cloudiness": 40,
"rain": 0,
"wind_speedy": "3.09 km/h",
"wind_direction": 90,
"condition_code": "29",
"condition_slug": "cloudly_day"
},
"18:01": {
"temp": 32,
"humidity": 31,
"cloudiness": 20,
"rain": 0,
"wind_speedy": "4.63 km/h",
"wind_direction": 100,
"condition_code": "29",
"condition_slug": "cloudly_day"
},
"19:01": {
"temp": 31,
"humidity": 30,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "4.12 km/h",
"wind_direction": 110,
"condition_code": "27",
"condition_slug": "clear_night"
},
"20:01": {
"temp": 29,
"humidity": 34,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "4.12 km/h",
"wind_direction": 120,
"condition_code": "27",
"condition_slug": "clear_night"
},
"21:01": {
"temp": 27,
"humidity": 41,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "3.09 km/h",
"wind_direction": 100,
"condition_code": "27",
"condition_slug": "clear_night"
},
"22:01": {
"temp": 26,
"humidity": 44,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "1.54 km/h",
"wind_direction": 100,
"condition_code": "27",
"condition_slug": "clear_night"
},
"23:01": {
"temp": 25,
"humidity": 47,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "2.06 km/h",
"wind_direction": 110,
"condition_code": "27",
"condition_slug": "clear_night"
}
}
},
"2025-11-10": {
"city": "Ribeirão Preto, SP",
"sunrise": "05:23 am",
"sunset": "06:26 pm",
"temp": {
"max": 34,
"min": 15,
"avg": 24.9
},
"humidity": {
"max": 82,
"min": 23,
"avg": 49.9
},
"cloudiness": {
"max": 20,
"min": 0,
"avg": 2.5
},
"rain": {
"max": 0,
"min": 0,
"avg": 0
},
"wind_speedy": {
"max": 6.2,
"min": 1.5,
"avg": 4
},
"hourly": {
"00:01": {
"temp": 20,
"humidity": 64,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "5.66 km/h",
"wind_direction": 140,
"condition_code": "27",
"condition_slug": "clear_night"
},
"01:01": {
"temp": 18,
"humidity": 72,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "4.63 km/h",
"wind_direction": 120,
"condition_code": "27",
"condition_slug": "clear_night"
},
"02:01": {
"temp": 17,
"humidity": 77,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "6.17 km/h",
"wind_direction": 140,
"condition_code": "27",
"condition_slug": "clear_night"
},
"03:01": {
"temp": 16,
"humidity": 82,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "6.17 km/h",
"wind_direction": 140,
"condition_code": "27",
"condition_slug": "clear_night"
},
"04:01": {
"temp": 16,
"humidity": 77,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "4.63 km/h",
"wind_direction": 140,
"condition_code": "27",
"condition_slug": "clear_night"
},
"05:01": {
"temp": 15,
"humidity": 82,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "3.6 km/h",
"wind_direction": 130,
"condition_code": "27",
"condition_slug": "clear_night"
},
"06:01": {
"temp": 15,
"humidity": 82,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "3.6 km/h",
"wind_direction": 140,
"condition_code": "27",
"condition_slug": "clear_day"
},
"07:01": {
"temp": 20,
"humidity": 59,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "3.09 km/h",
"wind_direction": 110,
"condition_code": "27",
"condition_slug": "clear_day"
},
"08:01": {
"temp": 22,
"humidity": 56,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "3.6 km/h",
"wind_direction": 100,
"condition_code": "27",
"condition_slug": "clear_day"
},
"09:01": {
"temp": 27,
"humidity": 52,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "5.14 km/h",
"wind_direction": 110,
"condition_code": "27",
"condition_slug": "clear_day"
},
"10:01": {
"temp": 27,
"humidity": 47,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "6.17 km/h",
"wind_direction": 110,
"condition_code": "27",
"condition_slug": "clear_day"
},
"11:01": {
"temp": 29,
"humidity": 44,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "4.63 km/h",
"wind_direction": 110,
"condition_code": "27",
"condition_slug": "clear_day"
},
"12:01": {
"temp": 30,
"humidity": 36,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "2.06 km/h",
"wind_direction": 160,
"condition_code": "27",
"condition_slug": "clear_day"
},
"13:01": {
"temp": 31,
"humidity": 31,
"cloudiness": 20,
"rain": 0,
"wind_speedy": "3.09 km/h",
"wind_direction": 140,
"condition_code": "29",
"condition_slug": "cloudly_day"
},
"14:01": {
"temp": 34,
"humidity": 28,
"cloudiness": 20,
"rain": 0,
"wind_speedy": "2.06 km/h",
"wind_direction": 90,
"condition_code": "29",
"condition_slug": "cloudly_day"
},
"15:01": {
"temp": 34,
"humidity": 25,
"cloudiness": 20,
"rain": 0,
"wind_speedy": "2.57 km/h",
"wind_direction": 130,
"condition_code": "29",
"condition_slug": "cloudly_day"
},
"16:01": {
"temp": 32,
"humidity": 23,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "1.54 km/h",
"wind_direction": 260,
"condition_code": "27",
"condition_slug": "clear_day"
},
"17:01": {
"temp": 32,
"humidity": 23,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "3.6 km/h",
"wind_direction": 110,
"condition_code": "27",
"condition_slug": "clear_day"
},
"18:01": {
"temp": 31,
"humidity": 30,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "2.57 km/h",
"wind_direction": 100,
"condition_code": "27",
"condition_slug": "clear_day"
},
"19:01": {
"temp": 30,
"humidity": 30,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "3.6 km/h",
"wind_direction": 120,
"condition_code": "27",
"condition_slug": "clear_night"
},
"20:01": {
"temp": 27,
"humidity": 39,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "5.66 km/h",
"wind_direction": 150,
"condition_code": "27",
"condition_slug": "clear_night"
},
"21:01": {
"temp": 26,
"humidity": 38,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "4.63 km/h",
"wind_direction": 150,
"condition_code": "27",
"condition_slug": "clear_night"
},
"22:01": {
"temp": 25,
"humidity": 47,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "4.12 km/h",
"wind_direction": 130,
"condition_code": "27",
"condition_slug": "clear_night"
},
"23:01": {
"temp": 23,
"humidity": 53,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "3.09 km/h",
"wind_direction": 110,
"condition_code": "27",
"condition_slug": "clear_night"
}
}
}
},
"execution_time": 1.41,
"from_cache": false
}