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
curl -X GET "https://api.hgbrasil.com/weather?key=suachave"
const url = new URL("/weather", "https://api.hgbrasil.com")
url.searchParams.set("key", "suachave")
const response = await fetch(url.href)
const data = await response.json()
$url = 'https://api.hgbrasil.com/weather';
$queryString = http_build_query([
'key' => 'suachave'
]);
$response = file_get_contents($url . '?' . $queryString);
$data = json_decode($response, true);
import requests
url = 'https://api.hgbrasil.com/weather'
params = {
'key': 'suachave'
}
response = requests.get(url, params=params)
data = response.json()
require 'net/http'
require 'uri'
require 'json'
uri = URI('https://api.hgbrasil.com/weather')
uri.query = URI.encode_www_form({
key: 'suachave'
})
response = Net::HTTP.get(uri)
data = JSON.parse(response, symbolize_names: true)
import java.net.URI;
import java.net.http.*;
var url = "https://api.hgbrasil.com/weather?key=suachave";
var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
.uri(URI.create(url))
.GET()
.build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
var data = response.body();
using System.Net.Http;
using System.Text.Json;
using System.Web;
var client = new HttpClient();
var baseUrl = "https://api.hgbrasil.com/weather";
var queryParams = HttpUtility.ParseQueryString(string.Empty);
queryParams["key"] = "suachave";
var url = $"{baseUrl}?{queryParams}";
var response = await client.GetStringAsync(url);
var data = JsonSerializer.Deserialize<dynamic>(response);
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": 20,
"date": "08/12/2025",
"time": "03:01",
"condition_code": "27",
"description": "Tempo limpo",
"currently": "noite",
"woeid": 455827,
"city": "São Paulo, SP",
"img_id": "27n",
"humidity": 89,
"cloudiness": 0,
"rain": 0,
"wind_speedy": "2.06 km/h",
"wind_direction": 220,
"wind_cardinal": "SO",
"sunrise": "05:12 am",
"sunset": "06:44 pm",
"moon_phase": "waning_gibbous",
"condition_slug": "clear_night",
"city_name": "São Paulo",
"timezone": "-03:00",
"forecast": [
{
"date": "08/12",
"full_date": "08/12/2025",
"weekday": "Seg",
"max": 29,
"min": 20,
"humidity": 34,
"cloudiness": 100,
"rain": 2.53,
"rain_probability": 100,
"wind_speedy": "6.34 km/h",
"sunrise": "05:12 am",
"sunset": "06:44 pm",
"moon_phase": "waning_gibbous",
"description": "Chuva",
"condition": "rain"
},
{
"date": "09/12",
"full_date": "09/12/2025",
"weekday": "Ter",
"max": 22,
"min": 19,
"humidity": 82,
"cloudiness": 100,
"rain": 9.84,
"rain_probability": 100,
"wind_speedy": "9.04 km/h",
"sunrise": "05:12 am",
"sunset": "06:45 pm",
"moon_phase": "waning_gibbous",
"description": "Chuva",
"condition": "rain"
},
{
"date": "10/12",
"full_date": "10/12/2025",
"weekday": "Qua",
"max": 30,
"min": 19,
"humidity": 51,
"cloudiness": 92,
"rain": 0.39,
"rain_probability": 52,
"wind_speedy": "11.89 km/h",
"sunrise": "05:13 am",
"sunset": "06:46 pm",
"moon_phase": "waning_gibbous",
"description": "Chuvas esparsas",
"condition": "rain"
},
{
"date": "11/12",
"full_date": "11/12/2025",
"weekday": "Qui",
"max": 31,
"min": 20,
"humidity": 28,
"cloudiness": 0,
"rain": 0,
"rain_probability": 0,
"wind_speedy": "8.6 km/h",
"sunrise": "05:13 am",
"sunset": "06:46 pm",
"moon_phase": "last_quarter",
"description": "Tempo limpo",
"condition": "clear_day"
},
{
"date": "12/12",
"full_date": "12/12/2025",
"weekday": "Sex",
"max": 31,
"min": 22,
"humidity": 34,
"cloudiness": 100,
"rain": 7.12,
"rain_probability": 100,
"wind_speedy": "5.58 km/h",
"sunrise": "05:13 am",
"sunset": "06:47 pm",
"moon_phase": "last_quarter",
"description": "Chuva",
"condition": "rain"
},
{
"date": "13/12",
"full_date": "13/12/2025",
"weekday": "Sáb",
"max": 22,
"min": 20,
"humidity": 83,
"cloudiness": 100,
"rain": 49.89,
"rain_probability": 100,
"wind_speedy": "5.45 km/h",
"sunrise": "05:13 am",
"sunset": "06:47 pm",
"moon_phase": "last_quarter",
"description": "Chuva",
"condition": "rain"
},
{
"date": "14/12",
"full_date": "14/12/2025",
"weekday": "Dom",
"max": 24,
"min": 19,
"humidity": 93,
"cloudiness": 100,
"rain": 15.54,
"rain_probability": 100,
"wind_speedy": "5.82 km/h",
"sunrise": "05:14 am",
"sunset": "06:48 pm",
"moon_phase": "last_quarter",
"description": "Chuva",
"condition": "rain"
},
{
"date": "15/12",
"full_date": "15/12/2025",
"weekday": "Seg",
"max": 28,
"min": 20,
"humidity": 54,
"cloudiness": 99,
"rain": 2.19,
"rain_probability": 100,
"wind_speedy": "5.02 km/h",
"sunrise": "05:14 am",
"sunset": "06:49 pm",
"moon_phase": "waning_crescent",
"description": "Chuvas esparsas",
"condition": "rain"
},
{
"date": "16/12",
"full_date": "16/12/2025",
"weekday": "Ter",
"max": 30,
"min": 20,
"humidity": 51,
"cloudiness": 100,
"rain": 2.34,
"rain_probability": 100,
"wind_speedy": "4.79 km/h",
"sunrise": "05:14 am",
"sunset": "06:49 pm",
"moon_phase": "waning_crescent",
"description": "Chuvas esparsas",
"condition": "rain"
},
{
"date": "17/12",
"full_date": "17/12/2025",
"weekday": "Qua",
"max": 29,
"min": 20,
"humidity": 46,
"cloudiness": 100,
"rain": 4.5,
"rain_probability": 100,
"wind_speedy": "6.22 km/h",
"sunrise": "05:15 am",
"sunset": "06:50 pm",
"moon_phase": "waning_crescent",
"description": "Chuva",
"condition": "rain"
},
{
"date": "18/12",
"full_date": "18/12/2025",
"weekday": "Qui",
"max": 28,
"min": 18,
"humidity": 47,
"cloudiness": 94,
"rain": 14.28,
"rain_probability": 100,
"wind_speedy": "5.32 km/h",
"sunrise": "05:15 am",
"sunset": "06:50 pm",
"moon_phase": "waning_crescent",
"description": "Chuva",
"condition": "rain"
},
{
"date": "19/12",
"full_date": "19/12/2025",
"weekday": "Sex",
"max": 19,
"min": 18,
"humidity": 89,
"cloudiness": 99,
"rain": 4.83,
"rain_probability": 100,
"wind_speedy": "4.02 km/h",
"sunrise": "05:16 am",
"sunset": "06:51 pm",
"moon_phase": "new",
"description": "Chuva",
"condition": "rain"
},
{
"date": "20/12",
"full_date": "20/12/2025",
"weekday": "Sáb",
"max": 27,
"min": 18,
"humidity": 59,
"cloudiness": 43,
"rain": 0.51,
"rain_probability": 47,
"wind_speedy": "4.54 km/h",
"sunrise": "05:16 am",
"sunset": "06:51 pm",
"moon_phase": "new",
"description": "Chuvas esparsas",
"condition": "rain"
},
{
"date": "21/12",
"full_date": "21/12/2025",
"weekday": "Dom",
"max": 30,
"min": 20,
"humidity": 42,
"cloudiness": 59,
"rain": 0.36,
"rain_probability": 39,
"wind_speedy": "4.87 km/h",
"sunrise": "05:17 am",
"sunset": "06:52 pm",
"moon_phase": "waxing_crescent",
"description": "Chuvas esparsas",
"condition": "rain"
},
{
"date": "22/12",
"full_date": "22/12/2025",
"weekday": "Seg",
"max": 31,
"min": 19,
"humidity": 51,
"cloudiness": 74,
"rain": 0.57,
"rain_probability": 55,
"wind_speedy": "5.26 km/h",
"sunrise": "05:17 am",
"sunset": "06:52 pm",
"moon_phase": "waxing_crescent",
"description": "Chuvas esparsas",
"condition": "rain"
}
],
"cref": "ea8899",
"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.