Weatherstack API
Overview
Weatherstack is a real-time and historical weather data API that covers over 200,000 locations worldwide. It returns current conditions, temperature, humidity, wind speed, and more in a simple JSON format. Beginners will find it easy to integrate into weather dashboards, travel apps, or any location-aware project.
Beginner Tip
On the free plan you can only use HTTP, not HTTPS; upgrade to a paid plan if your app requires secure connections. Always pass the query parameter as a city name or coordinates like "New York" or "48.8566,2.3522".
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
location.name The resolved city or place name for the queried location. location.country The country where the queried location is situated. current.temperature Current temperature in Celsius (or Fahrenheit if unit=f is set). current.weather_descriptions Text descriptions of the current weather conditions, e.g., Partly cloudy. current.humidity Current relative humidity expressed as a percentage. current.wind_speed Wind speed in kilometers per hour at the queried location. Implementation Example
const url = "https://weatherstack.com/";
// 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
Alternatives to Weatherstack
Technical alternatives for different use cases.
Much larger community and more feature-rich API
Weather alerts, forecasts, and air pollution data
Quick historical weather lookups
More generous free tier with astronomy data
Free tier with more API calls per month
Apilayer ecosystem compatibility
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.