QWeather API

Weather / API Key Intermediate HTTPS CORS
Varies by plan (check documentation)

Overview

QWeather delivers accurate location-based weather data including real-time conditions, hourly and daily forecasts, air quality index, and severe weather warnings across global locations. It is especially strong for Asian regions and integrates seamlessly into mobile and web apps. Beginners can retrieve current weather by city name or geographic coordinates after registering for a free developer key.

💡

Beginner Tip

Create a free account at dev.qweather.com to get an API key. Use the location parameter with a city name like "london" or coordinate pair like "116.41,39.92" to query any location.

Available Data

temperature
weather conditions
humidity
wind speed
forecast data
Use case: Integrate location-based weather data data into web and mobile applications

Example Response

JSON 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

now.temp Current temperature in Celsius
now.text Weather condition description in the requested language
now.humidity Current relative humidity as a percentage
now.windDir Wind direction as a compass direction string such as NW or SE
now.windSpeed Wind speed in kilometers per hour
updateTime ISO 8601 timestamp of when this weather data was last updated

Implementation Example

const url = "https://dev.qweather.com/en/";
// 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

code: 401 API key is missing or incorrectly passed
Include your key as a query parameter named key=YOUR_API_KEY in every request
code: 404 Location not found or misspelled
Use the GeoAPI endpoint first to look up the location ID, then pass that ID as the location parameter
code: 429 Request rate exceeded for your subscription plan
The free tier has limits per minute; cache results locally and avoid redundant requests within the same minute

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 15/20
🔒 Security 15/15
🛠 Developer XP 17/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS YES
Category Weather
Difficulty Intermediate
Verified: 2026-04-04

Similar APIs

View All →