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 têm 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": 14,
    "date": "13/09/2026",
    "time": "22:01",
    "condition_code": "28",
    "description": "Tempo nublado",
    "currently": "noite",
    "woeid": 455827,
    "city": "São Paulo, SP",
    "img_id": "28n",
    "humidity": 95,
    "cloudiness": 100,
    "rain": 0,
    "wind_speedy": "5.14 km/h",
    "wind_direction": 160,
    "wind_cardinal": "SE",
    "sunrise": "06:05 am",
    "sunset": "05:59 pm",
    "moon_phase": "waxing_crescent",
    "condition_slug": "cloud",
    "city_name": "São Paulo",
    "timezone": "-03:00",
    "forecast": [
      {
        "date": "13/09",
        "full_date": "13/09/2026",
        "weekday": "Dom",
        "max": 16,
        "min": 11,
        "humidity": 90,
        "cloudiness": 100,
        "rain": 2.72,
        "rain_probability": 100,
        "wind_speedy": "4.23 km/h",
        "sunrise": "06:05 am",
        "sunset": "05:59 pm",
        "moon_phase": "waxing_crescent",
        "description": "Chuva",
        "condition": "rain"
      },
      {
        "date": "14/09",
        "full_date": "14/09/2026",
        "weekday": "Seg",
        "max": 18,
        "min": 11,
        "humidity": 82,
        "cloudiness": 100,
        "rain": 18,
        "rain_probability": 100,
        "wind_speedy": "4.92 km/h",
        "sunrise": "06:04 am",
        "sunset": "05:59 pm",
        "moon_phase": "waxing_crescent",
        "description": "Chuva",
        "condition": "rain"
      },
      {
        "date": "15/09",
        "full_date": "15/09/2026",
        "weekday": "Ter",
        "max": 20,
        "min": 14,
        "humidity": 68,
        "cloudiness": 68,
        "rain": 8.08,
        "rain_probability": 100,
        "wind_speedy": "2.92 km/h",
        "sunrise": "06:03 am",
        "sunset": "06:00 pm",
        "moon_phase": "waxing_crescent",
        "description": "Chuva",
        "condition": "rain"
      },
      {
        "date": "16/09",
        "full_date": "16/09/2026",
        "weekday": "Qua",
        "max": 17,
        "min": 13,
        "humidity": 70,
        "cloudiness": 97,
        "rain": 0.54,
        "rain_probability": 100,
        "wind_speedy": "5.78 km/h",
        "sunrise": "06:02 am",
        "sunset": "06:00 pm",
        "moon_phase": "waxing_crescent",
        "description": "Chuvas esparsas",
        "condition": "rain"
      },
      {
        "date": "17/09",
        "full_date": "17/09/2026",
        "weekday": "Qui",
        "max": 17,
        "min": 11,
        "humidity": 67,
        "cloudiness": 82,
        "rain": 0,
        "rain_probability": 0,
        "wind_speedy": "5.24 km/h",
        "sunrise": "06:01 am",
        "sunset": "06:00 pm",
        "moon_phase": "waxing_crescent",
        "description": "Tempo nublado",
        "condition": "cloud"
      },
      {
        "date": "18/09",
        "full_date": "18/09/2026",
        "weekday": "Sex",
        "max": 25,
        "min": 14,
        "humidity": 58,
        "cloudiness": 20,
        "rain": 4.92,
        "rain_probability": 100,
        "wind_speedy": "4.69 km/h",
        "sunrise": "06:00 am",
        "sunset": "06:01 pm",
        "moon_phase": "waxing_crescent",
        "description": "Chuvas esparsas",
        "condition": "rain"
      },
      {
        "date": "19/09",
        "full_date": "19/09/2026",
        "weekday": "Sáb",
        "max": 19,
        "min": 17,
        "humidity": 87,
        "cloudiness": 100,
        "rain": 23.22,
        "rain_probability": 100,
        "wind_speedy": "2.81 km/h",
        "sunrise": "05:59 am",
        "sunset": "06:01 pm",
        "moon_phase": "first_quarter",
        "description": "Chuva",
        "condition": "rain"
      },
      {
        "date": "20/09",
        "full_date": "20/09/2026",
        "weekday": "Dom",
        "max": 25,
        "min": 17,
        "humidity": 76,
        "cloudiness": 95,
        "rain": 2.13,
        "rain_probability": 100,
        "wind_speedy": "4.72 km/h",
        "sunrise": "05:58 am",
        "sunset": "06:01 pm",
        "moon_phase": "first_quarter",
        "description": "Chuvas esparsas",
        "condition": "rain"
      },
      {
        "date": "21/09",
        "full_date": "21/09/2026",
        "weekday": "Seg",
        "max": 28,
        "min": 19,
        "humidity": 50,
        "cloudiness": 88,
        "rain": 0.3,
        "rain_probability": 37,
        "wind_speedy": "7.22 km/h",
        "sunrise": "05:57 am",
        "sunset": "06:02 pm",
        "moon_phase": "first_quarter",
        "description": "Chuvas esparsas",
        "condition": "rain"
      },
      {
        "date": "22/09",
        "full_date": "22/09/2026",
        "weekday": "Ter",
        "max": 29,
        "min": 20,
        "humidity": 46,
        "cloudiness": 100,
        "rain": 0.69,
        "rain_probability": 53,
        "wind_speedy": "7.74 km/h",
        "sunrise": "05:56 am",
        "sunset": "06:02 pm",
        "moon_phase": "waxing_gibbous",
        "description": "Chuvas esparsas",
        "condition": "rain"
      },
      {
        "date": "23/09",
        "full_date": "23/09/2026",
        "weekday": "Qua",
        "max": 25,
        "min": 16,
        "humidity": 57,
        "cloudiness": 85,
        "rain": 12.45,
        "rain_probability": 100,
        "wind_speedy": "8.27 km/h",
        "sunrise": "05:55 am",
        "sunset": "06:02 pm",
        "moon_phase": "waxing_gibbous",
        "description": "Chuva",
        "condition": "rain"
      },
      {
        "date": "24/09",
        "full_date": "24/09/2026",
        "weekday": "Qui",
        "max": 16,
        "min": 12,
        "humidity": 95,
        "cloudiness": 100,
        "rain": 63.42,
        "rain_probability": 100,
        "wind_speedy": "5.85 km/h",
        "sunrise": "05:54 am",
        "sunset": "06:03 pm",
        "moon_phase": "waxing_gibbous",
        "description": "Chuva",
        "condition": "rain"
      },
      {
        "date": "25/09",
        "full_date": "25/09/2026",
        "weekday": "Sex",
        "max": 13,
        "min": 12,
        "humidity": 91,
        "cloudiness": 100,
        "rain": 1.5,
        "rain_probability": 87,
        "wind_speedy": "5.58 km/h",
        "sunrise": "05:53 am",
        "sunset": "06:03 pm",
        "moon_phase": "full",
        "description": "Chuvas esparsas",
        "condition": "rain"
      },
      {
        "date": "26/09",
        "full_date": "26/09/2026",
        "weekday": "Sáb",
        "max": 18,
        "min": 12,
        "humidity": 76,
        "cloudiness": 100,
        "rain": 0,
        "rain_probability": 0,
        "wind_speedy": "4.3 km/h",
        "sunrise": "05:52 am",
        "sunset": "06:03 pm",
        "moon_phase": "full",
        "description": "Tempo nublado",
        "condition": "cloud"
      },
      {
        "date": "27/09",
        "full_date": "27/09/2026",
        "weekday": "Dom",
        "max": 24,
        "min": 15,
        "humidity": 58,
        "cloudiness": 38,
        "rain": 0.9,
        "rain_probability": 90,
        "wind_speedy": "4.92 km/h",
        "sunrise": "05:51 am",
        "sunset": "06:04 pm",
        "moon_phase": "full",
        "description": "Chuvas esparsas",
        "condition": "rain"
      }
    ],
    "cref": "8f444c",
    "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.

Localização

Campo	Tipo	Descrição	Exemplo
`city`	`string`	Nome da cidade com a sigla do estado.	São Paulo, SP
`city_name`	`string`	Nome da cidade sem a sigla do estado.	São Paulo
`woeid`	`number`	Código WOEID (Where On Earth IDentifier) da localidade.	455827
`latitude`	`number`	Latitude da localidade.	-23.5329
`longitude`	`number`	Longitude da localidade.	-46.6395
`timezone`	`string`	Fuso horário da localidade em relação ao UTC.	-03:00
`cref`	`string`	Código interno de referência da consulta.	d722f0

Condições atuais

Campo	Tipo	Descrição	Exemplo
`date`	`string`	Data da medição no formato `dd/mm/yyyy`.	09/09/2026
`time`	`string`	Horário da medição no formato `HH:mm`, no fuso da localidade.	08:01
`temp`	`number`	Temperatura atual em graus Celsius.	16
`description`	`string`	Descrição da condição climática no idioma do parâmetro `locale`.	Chuvas esparsas
`condition_code`	`string`	Código numérico da condição climática (veja ícones).	40
`condition_slug`	`string`	Identificador textual da condição, usado no nome do arquivo de ícone.	rain
`img_id`	`string`	Identificador da imagem da condição. Igual ao `condition_code`.	40
`currently`	`string`	Período do dia na localidade: `dia` ou `noite`.	dia
`humidity`	`number`	Umidade relativa do ar em percentual.	96
`cloudiness`	`number`	Cobertura de nuvens em percentual.	97
`rain`	`number`	Precipitação acumulada em milímetros (mm).	0.12
`wind_speedy`	`string`	Velocidade do vento com a unidade de medida.	1.54 km/h
`wind_direction`	`number`	Direção do vento em graus (0 a 360).	70
`wind_cardinal`	`string`	Direção do vento em ponto cardeal.	NE
`sunrise`	`string`	Horário do nascer do sol.	06:09 am
`sunset`	`string`	Horário do pôr do sol.	05:58 pm
`moon_phase`	`string`	Fase da lua (veja fases da lua).	waning_crescent

Previsão

Cada item do array forecast representa a previsão de um dia:

Campo	Tipo	Descrição	Exemplo
`date`	`string`	Data da previsão no formato `dd/mm`.	09/09
`full_date`	`string`	Data da previsão no formato `dd/mm/yyyy`.	09/09/2026
`weekday`	`string`	Dia da semana abreviado, no idioma do parâmetro `locale`.	Qua
`max`	`number`	Temperatura máxima prevista em graus Celsius.	24
`min`	`number`	Temperatura mínima prevista em graus Celsius.	16
`humidity`	`number`	Umidade relativa do ar em percentual.	86
`cloudiness`	`number`	Cobertura de nuvens em percentual.	92
`rain`	`number`	Precipitação prevista em milímetros (mm).	17.63
`rain_probability`	`number`	Probabilidade de chuva em percentual.	100
`wind_speedy`	`string`	Velocidade do vento com a unidade de medida.	3.17 km/h
`sunrise`	`string`	Horário do nascer do sol.	06:09 am
`sunset`	`string`	Horário do pôr do sol.	05:58 pm
`moon_phase`	`string`	Fase da lua (veja fases da lua).	waning_crescent
`description`	`string`	Descrição da condição prevista, no idioma do parâmetro `locale`.	Chuva
`condition`	`string`	Identificador textual da condição prevista, equivalente ao `condition_slug`.	rain

A quantidade de dias retornados no forecast varia conforme o plano contratado.

Fases da lua

Os campos moon_phase retornam um dos seguintes valores:

Valor	Fase
`new`	Lua nova
`waxing_crescent`	Lua crescente côncava
`first_quarter`	Quarto crescente
`waxing_gibbous`	Lua crescente convexa
`full`	Lua cheia
`waning_gibbous`	Lua minguante convexa
`last_quarter`	Quarto minguante
`waning_crescent`	Lua minguante côncava

Dados Fundamentalistas

Consulte uma visão consolidada de ações e outros ativos listados na B3, com cotação, indicadores fundamentalistas, dividendos e muito mais.

Localização

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