HG Weather API
Overview
HG Weather is a Brazilian weather API that returns current conditions and multi-day forecasts for cities across Brazil. It is easy to use: simply pass a city name or coordinates and your API key to get structured JSON back. This API is a great starting point for developers building apps focused on the Brazilian market.
Beginner Tip
Pass the city name using the city_name parameter or use woeid (a Yahoo location ID) for precise city targeting. Keep your API key out of client-side code by routing requests through a small backend.
Available Data
Example Response
{
"location": "Tokyo",
"temperature": {
"current": 22,
"feels_like": 24,
"min": 18,
"max": 26
},
"condition": "Partly Cloudy",
"humidity": 65,
"wind": {
"speed": 12,
"direction": "NE"
},
"forecast": [
{
"date": "2025-01-16",
"high": 25,
"low": 17,
"condition": "Sunny"
}
]
} Field Reference
results.temp Current temperature in degrees Celsius. results.description Short weather description such as Chuva (rain) or Ensolarado (sunny). results.humidity Current relative humidity as a percentage. results.wind_speedy Current wind speed with unit, e.g., 15 km/h. results.forecast Array of daily forecast objects with date, max/min temperatures, and description. Implementation Example
const url = "https://hgbrasil.com/status/weather";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
headers: {
"X-API-Key": "YOUR_API_KEY"
}
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data); What Can You Build?
Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.
Common Errors & Troubleshooting
Matrix Score Breakdown
Partially tested on Apr 5, 2026
Technical Specifications
Similar APIs
View All →AccuWeather
AccuWeather's API provides highly detailed weather forecasts, current conditions, and severe weather alerts for locations around the world.
Aemet
Aemet OpenData is Spain's official meteorological agency API providing weather forecasts, observations, and climate data for Spanish territory including the Canary Islands and Balearics.
APIXU
APIXU (now rebranded as Weatherstack) is a weather data API that provides current conditions, forecasts, and historical weather for locations around the world.
AQICN
⭐ Beginner's PickAQICN (Air Quality Index CN) provides real-time air quality data for over 1,000 cities worldwide, including PM2.5, PM10, ozone, and other pollutant readings.
ColorfulClouds
ColorfulClouds (Caiyun Weather) is a Chinese weather API that delivers real-time and forecast weather data with minute-level precipitation predictions.