Previsão do Tempo

Weather

Dados meteorológicos atualizados e precisos.

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.

Para acessar os dados da API é necessário utilizar uma chave de integração.

Os dados meteorológicos são atualizados em intervalos de até 1 hora.

É possível indicar o idioma de retorno da API através do parâmetro locale. Estão disponíveis: pt (português, por padrão) e en (inglês).

Requisição

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:

Resposta

Exemplo de resposta no formato JSON.

{
  "by": "default",
  "valid_key": true,
  "results": {
    "temp": 19,
    "date": "17/05/2026",
    "time": "00:01",
    "condition_code": "29",
    "description": "Parcialmente nublado",
    "currently": "noite",
    "woeid": 455827,
    "city": "São Paulo, SP",
    "img_id": "29n",
    "humidity": 97,
    "cloudiness": 40,
    "rain": 0,
    "wind_speedy": "2.06 km/h",
    "wind_direction": 280,
    "wind_cardinal": "O",
    "sunrise": "06:33 am",
    "sunset": "05:32 pm",
    "moon_phase": "new",
    "condition_slug": "cloudly_night",
    "city_name": "São Paulo",
    "timezone": "-03:00",
    "forecast": [
      {
        "date": "17/05",
        "full_date": "17/05/2026",
        "weekday": "Dom",
        "max": 21,
        "min": 16,
        "humidity": 83,
        "cloudiness": 100,
        "rain": 7.96,
        "rain_probability": 100,
        "wind_speedy": "6.19 km/h",
        "sunrise": "06:34 am",
        "sunset": "05:31 pm",
        "moon_phase": "new",
        "description": "Chuvas esparsas",
        "condition": "rain"
      },
      {
        "date": "18/05",
        "full_date": "18/05/2026",
        "weekday": "Seg",
        "max": 19,
        "min": 16,
        "humidity": 93,
        "cloudiness": 100,
        "rain": 23.38,
        "rain_probability": 100,
        "wind_speedy": "4.59 km/h",
        "sunrise": "06:34 am",
        "sunset": "05:31 pm",
        "moon_phase": "waxing_crescent",
        "description": "Chuva",
        "condition": "rain"
      },
      {
        "date": "19/05",
        "full_date": "19/05/2026",
        "weekday": "Ter",
        "max": 16,
        "min": 15,
        "humidity": 92,
        "cloudiness": 100,
        "rain": 1.83,
        "rain_probability": 100,
        "wind_speedy": "3.01 km/h",
        "sunrise": "06:35 am",
        "sunset": "05:30 pm",
        "moon_phase": "waxing_crescent",
        "description": "Chuvas esparsas",
        "condition": "rain"
      },
      {
        "date": "20/05",
        "full_date": "20/05/2026",
        "weekday": "Qua",
        "max": 19,
        "min": 15,
        "humidity": 79,
        "cloudiness": 100,
        "rain": 0.34,
        "rain_probability": 20,
        "wind_speedy": "3.41 km/h",
        "sunrise": "06:35 am",
        "sunset": "05:30 pm",
        "moon_phase": "waxing_crescent",
        "description": "Chuvas esparsas",
        "condition": "rain"
      },
      {
        "date": "21/05",
        "full_date": "21/05/2026",
        "weekday": "Qui",
        "max": 17,
        "min": 14,
        "humidity": 75,
        "cloudiness": 98,
        "rain": 0.13,
        "rain_probability": 21,
        "wind_speedy": "4.91 km/h",
        "sunrise": "06:36 am",
        "sunset": "05:30 pm",
        "moon_phase": "waxing_crescent",
        "description": "Chuvas esparsas",
        "condition": "rain"
      },
      {
        "date": "22/05",
        "full_date": "22/05/2026",
        "weekday": "Sex",
        "max": 14,
        "min": 14,
        "humidity": 95,
        "cloudiness": 100,
        "rain": 1.17,
        "rain_probability": 74,
        "wind_speedy": "4.11 km/h",
        "sunrise": "06:36 am",
        "sunset": "05:29 pm",
        "moon_phase": "waxing_crescent",
        "description": "Chuvas esparsas",
        "condition": "rain"
      },
      {
        "date": "23/05",
        "full_date": "23/05/2026",
        "weekday": "Sáb",
        "max": 16,
        "min": 14,
        "humidity": 94,
        "cloudiness": 100,
        "rain": 7.44,
        "rain_probability": 100,
        "wind_speedy": "2.07 km/h",
        "sunrise": "06:37 am",
        "sunset": "05:29 pm",
        "moon_phase": "waxing_crescent",
        "description": "Chuvas esparsas",
        "condition": "rain"
      },
      {
        "date": "24/05",
        "full_date": "24/05/2026",
        "weekday": "Dom",
        "max": 21,
        "min": 16,
        "humidity": 85,
        "cloudiness": 100,
        "rain": 6.15,
        "rain_probability": 100,
        "wind_speedy": "2.92 km/h",
        "sunrise": "06:37 am",
        "sunset": "05:29 pm",
        "moon_phase": "first_quarter",
        "description": "Chuvas esparsas",
        "condition": "rain"
      },
      {
        "date": "25/05",
        "full_date": "25/05/2026",
        "weekday": "Seg",
        "max": 26,
        "min": 16,
        "humidity": 64,
        "cloudiness": 0,
        "rain": 1.14,
        "rain_probability": 70,
        "wind_speedy": "2.32 km/h",
        "sunrise": "06:38 am",
        "sunset": "05:29 pm",
        "moon_phase": "first_quarter",
        "description": "Chuvas esparsas",
        "condition": "rain"
      },
      {
        "date": "26/05",
        "full_date": "26/05/2026",
        "weekday": "Ter",
        "max": 26,
        "min": 18,
        "humidity": 56,
        "cloudiness": 27,
        "rain": 15.63,
        "rain_probability": 100,
        "wind_speedy": "4.19 km/h",
        "sunrise": "06:38 am",
        "sunset": "05:28 pm",
        "moon_phase": "first_quarter",
        "description": "Chuva",
        "condition": "rain"
      },
      {
        "date": "27/05",
        "full_date": "27/05/2026",
        "weekday": "Qua",
        "max": 20,
        "min": 17,
        "humidity": 84,
        "cloudiness": 100,
        "rain": 2.4,
        "rain_probability": 100,
        "wind_speedy": "4.4 km/h",
        "sunrise": "06:39 am",
        "sunset": "05:28 pm",
        "moon_phase": "waxing_gibbous",
        "description": "Chuvas esparsas",
        "condition": "rain"
      },
      {
        "date": "28/05",
        "full_date": "28/05/2026",
        "weekday": "Qui",
        "max": 26,
        "min": 17,
        "humidity": 66,
        "cloudiness": 48,
        "rain": 4.86,
        "rain_probability": 100,
        "wind_speedy": "3.58 km/h",
        "sunrise": "06:39 am",
        "sunset": "05:28 pm",
        "moon_phase": "waxing_gibbous",
        "description": "Chuva",
        "condition": "rain"
      },
      {
        "date": "29/05",
        "full_date": "29/05/2026",
        "weekday": "Sex",
        "max": 26,
        "min": 17,
        "humidity": 68,
        "cloudiness": 100,
        "rain": 1.77,
        "rain_probability": 100,
        "wind_speedy": "2.88 km/h",
        "sunrise": "06:39 am",
        "sunset": "05:28 pm",
        "moon_phase": "waxing_gibbous",
        "description": "Chuvas esparsas",
        "condition": "rain"
      },
      {
        "date": "30/05",
        "full_date": "30/05/2026",
        "weekday": "Sáb",
        "max": 19,
        "min": 13,
        "humidity": 92,
        "cloudiness": 100,
        "rain": 2.13,
        "rain_probability": 85,
        "wind_speedy": "6.21 km/h",
        "sunrise": "06:40 am",
        "sunset": "05:28 pm",
        "moon_phase": "full",
        "description": "Chuvas esparsas",
        "condition": "rain"
      },
      {
        "date": "31/05",
        "full_date": "31/05/2026",
        "weekday": "Dom",
        "max": 16,
        "min": 12,
        "humidity": 65,
        "cloudiness": 47,
        "rain": 1.38,
        "rain_probability": 99,
        "wind_speedy": "6.33 km/h",
        "sunrise": "06:40 am",
        "sunset": "05:27 pm",
        "moon_phase": "full",
        "description": "Chuvas esparsas",
        "condition": "rain"
      }
    ],
    "cref": "27c602",
    "latitude": -23.5329,
    "longitude": -46.6395
  },
  "execution_time": 0,
  "from_cache": true
}

Campos

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.

Balanço Patrimonial

Consulte o balanço patrimonial de ações e outros ativos listados na B3, com dados anuais e trimestrais.

Localização

Obtenha dados de previsão do tempo para uma cidade ou região específica.