O HG Weather é uma API que fornece dados de previsão do tempo e condições climáticas atuais para uma cidade. É possível obter a cidade desejada de várias formas diferentes, como geolocalização, IP do usuário, busca por nome ou código.
locale. Estão disponíveis: pt (português, por padrão) e en (inglês).Todas as requisições tem como base o seguinte endpoint:
GEThttps://api.hgbrasil.com/weather?key=suachave
Veja como é fácil obter dados de previsão do tempo para uma cidade ou região específica. Você pode fazer isso de várias maneiras, como:
Exemplo de resposta no formato JSON.
{
"by": "default",
"valid_key": true,
"results": {
"temp": 17,
"date": "13/11/2025",
"time": "07:01",
"condition_code": "27",
"description": "Tempo limpo",
"currently": "dia",
"woeid": 455827,
"city": "São Paulo, SP",
"img_id": "27",
"humidity": 85,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "1.54 km/h",
"wind_direction": 90,
"wind_cardinal": "L",
"sunrise": "05:14 am",
"sunset": "06:27 pm",
"moon_phase": "last_quarter",
"condition_slug": "clear_day",
"city_name": "São Paulo",
"timezone": "-03:00",
"forecast": [
{
"date": "13/11",
"full_date": "13/11/2025",
"weekday": "Qui",
"max": 25,
"min": 19,
"humidity": 46,
"cloudiness": 100,
"rain": 0,
"rain_probability": 16,
"wind_speedy": "4.5 km/h",
"sunrise": "05:14 am",
"sunset": "06:27 pm",
"moon_phase": "last_quarter",
"description": "Tempo nublado",
"condition": "cloud"
},
{
"date": "14/11",
"full_date": "14/11/2025",
"weekday": "Sex",
"max": 27,
"min": 17,
"humidity": 50,
"cloudiness": 100,
"rain": 3.14,
"rain_probability": 100,
"wind_speedy": "6.15 km/h",
"sunrise": "05:14 am",
"sunset": "06:28 pm",
"moon_phase": "last_quarter",
"description": "Chuvas esparsas",
"condition": "rain"
},
{
"date": "15/11",
"full_date": "15/11/2025",
"weekday": "Sáb",
"max": 18,
"min": 17,
"humidity": 92,
"cloudiness": 100,
"rain": 14.12,
"rain_probability": 100,
"wind_speedy": "4.21 km/h",
"sunrise": "05:13 am",
"sunset": "06:28 pm",
"moon_phase": "last_quarter",
"description": "Chuva",
"condition": "rain"
},
{
"date": "16/11",
"full_date": "16/11/2025",
"weekday": "Dom",
"max": 24,
"min": 18,
"humidity": 81,
"cloudiness": 91,
"rain": 5.24,
"rain_probability": 100,
"wind_speedy": "6.38 km/h",
"sunrise": "05:13 am",
"sunset": "06:29 pm",
"moon_phase": "waning_crescent",
"description": "Chuvas esparsas",
"condition": "rain"
},
{
"date": "17/11",
"full_date": "17/11/2025",
"weekday": "Seg",
"max": 22,
"min": 19,
"humidity": 88,
"cloudiness": 100,
"rain": 12.17,
"rain_probability": 100,
"wind_speedy": "6.86 km/h",
"sunrise": "05:13 am",
"sunset": "06:30 pm",
"moon_phase": "waning_crescent",
"description": "Chuva",
"condition": "rain"
},
{
"date": "18/11",
"full_date": "18/11/2025",
"weekday": "Ter",
"max": 18,
"min": 14,
"humidity": 77,
"cloudiness": 100,
"rain": 4.83,
"rain_probability": 100,
"wind_speedy": "5.47 km/h",
"sunrise": "05:12 am",
"sunset": "06:30 pm",
"moon_phase": "waning_crescent",
"description": "Chuvas esparsas",
"condition": "rain"
},
{
"date": "19/11",
"full_date": "19/11/2025",
"weekday": "Qua",
"max": 26,
"min": 12,
"humidity": 46,
"cloudiness": 0,
"rain": 0,
"rain_probability": 0,
"wind_speedy": "5.28 km/h",
"sunrise": "05:12 am",
"sunset": "06:31 pm",
"moon_phase": "waning_crescent",
"description": "Tempo limpo",
"condition": "clear_day"
},
{
"date": "20/11",
"full_date": "20/11/2025",
"weekday": "Qui",
"max": 30,
"min": 16,
"humidity": 36,
"cloudiness": 29,
"rain": 0,
"rain_probability": 0,
"wind_speedy": "5.59 km/h",
"sunrise": "05:12 am",
"sunset": "06:32 pm",
"moon_phase": "new",
"description": "Parcialmente nublado",
"condition": "cloudly_day"
},
{
"date": "21/11",
"full_date": "21/11/2025",
"weekday": "Sex",
"max": 18,
"min": 16,
"humidity": 82,
"cloudiness": 100,
"rain": 1.23,
"rain_probability": 76,
"wind_speedy": "5.56 km/h",
"sunrise": "05:12 am",
"sunset": "06:33 pm",
"moon_phase": "waxing_crescent",
"description": "Chuvas esparsas",
"condition": "rain"
},
{
"date": "22/11",
"full_date": "22/11/2025",
"weekday": "Sáb",
"max": 19,
"min": 16,
"humidity": 77,
"cloudiness": 82,
"rain": 0,
"rain_probability": 5,
"wind_speedy": "5.74 km/h",
"sunrise": "05:12 am",
"sunset": "06:33 pm",
"moon_phase": "waxing_crescent",
"description": "Tempo nublado",
"condition": "cloud"
},
{
"date": "23/11",
"full_date": "23/11/2025",
"weekday": "Dom",
"max": 23,
"min": 17,
"humidity": 62,
"cloudiness": 83,
"rain": 0.9,
"rain_probability": 30,
"wind_speedy": "5.33 km/h",
"sunrise": "05:11 am",
"sunset": "06:34 pm",
"moon_phase": "waxing_crescent",
"description": "Chuvas esparsas",
"condition": "rain"
},
{
"date": "24/11",
"full_date": "24/11/2025",
"weekday": "Seg",
"max": 27,
"min": 17,
"humidity": 50,
"cloudiness": 32,
"rain": 4.02,
"rain_probability": 100,
"wind_speedy": "4.89 km/h",
"sunrise": "05:11 am",
"sunset": "06:35 pm",
"moon_phase": "waxing_crescent",
"description": "Chuvas esparsas",
"condition": "rain"
},
{
"date": "25/11",
"full_date": "25/11/2025",
"weekday": "Ter",
"max": 28,
"min": 17,
"humidity": 44,
"cloudiness": 100,
"rain": 10.89,
"rain_probability": 100,
"wind_speedy": "4.35 km/h",
"sunrise": "05:11 am",
"sunset": "06:35 pm",
"moon_phase": "waxing_crescent",
"description": "Chuva",
"condition": "rain"
},
{
"date": "26/11",
"full_date": "26/11/2025",
"weekday": "Qua",
"max": 25,
"min": 19,
"humidity": 66,
"cloudiness": 92,
"rain": 0,
"rain_probability": 0,
"wind_speedy": "7.97 km/h",
"sunrise": "05:11 am",
"sunset": "06:36 pm",
"moon_phase": "waxing_crescent",
"description": "Tempo nublado",
"condition": "cloud"
},
{
"date": "27/11",
"full_date": "27/11/2025",
"weekday": "Qui",
"max": 28,
"min": 20,
"humidity": 59,
"cloudiness": 99,
"rain": 0.69,
"rain_probability": 46,
"wind_speedy": "8.1 km/h",
"sunrise": "05:11 am",
"sunset": "06:37 pm",
"moon_phase": "first_quarter",
"description": "Chuvas esparsas",
"condition": "rain"
}
],
"cref": "f2f1a0",
"latitude": -23.5329,
"longitude": -46.6395
},
"execution_time": 0,
"from_cache": true
}
Os dados referentes à consulta chegam no parâmetro results, você também pode conferir a autenticação de sua chave no parâmetro de retorno valid_key.