weather-api API

⭐ Beginner's Pick Weather / No Auth Required Beginner HTTPS
Free to Use Varies (check documentation)

Overview

weather-api is a lightweight, open-source RESTful API that provides current weather data for cities around the world with no authentication required. It is built on top of open data sources and is perfect for learning how to consume a weather API without worrying about API keys or rate limits. Beginners can get started in minutes by simply querying a city name.

💡

Beginner Tip

No API key is needed. Just pass a city name as a path parameter and you will get back current temperature, humidity, and weather conditions in a simple JSON response.

Available Data

temperature
weather conditions
humidity
wind speed
forecast data

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

temperature Current temperature with degree symbol, typically in Celsius
wind Current wind speed and direction as a descriptive string
description Short weather condition description such as "Sunny" or "Overcast"
forecast Array of upcoming daily forecast objects with day, temperature, and wind fields
forecast[].day Relative day label such as "1" or "2" indicating days from today

Implementation Example

const url = "https://github.com/robertoduessmann/weather-api";
const response = await fetch(url);
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

404 Not Found City name is misspelled or not in the database
Try common English city names without special characters; the API has limited city coverage compared to commercial APIs
Empty or null temperature fields Upstream data source temporarily unavailable
Add null checks in your code before displaying weather values; retry after a short delay
Slow response or timeout The free hosting platform (Heroku free tier) can be slow on cold starts
For production apps, switch to OpenWeatherMap or another commercial API; this API is best for learning and demos

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 20/20
🔒 Security 15/15
🛠 Developer XP 12/20
✓ Reliability 7/15
Response Time 44ms

Fully tested on Apr 5, 2026

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS NO
Category Weather
Difficulty Beginner
Verified: 2026-04-04

Similar APIs

View All →