Weather Forecast API

What it does

Fetches current weather conditions and multi-day forecasts for any location worldwide using the free Open-Meteo API. No API key required.

Features

• Current conditions: Temperature, humidity, wind speed/direction/gusts, pressure, cloud cover, precipitation, weather description
• Daily forecasts: Up to 16 days with high/low temps, precipitation probability, UV index, sunrise/sunset, wind data
• Flexible input: City names (auto-geocoded) or latitude/longitude coordinates
• Multiple locations: Process many locations in a single run
• Temperature units: Celsius or Fahrenheit output
• WMO weather codes: Decoded into human-readable descriptions

How to use

1. Set locations: Enter city names or coordinates separated by semicolons

   • City names: New York; Tokyo; London
   • Coordinates: 37.7749,-122.4194; 35.6762,139.6503
   • Mixed: New York; 48.8566,2.3522; Sydney

2. Choose forecast length: Select 1-16 days of forecast data

3. Pick temperature unit: Celsius (default) or Fahrenheit

4. Run the Actor and download results from the dataset

Input example

{
    "locations": "New York; Tokyo; London; Paris; Sydney",
    "forecast_days": 7,
    "temperature_unit": "celsius"
}

Output example

{
    "location": "New York, New York, United States",
    "latitude": 40.7143,
    "longitude": -74.006,
    "elevation_m": 10.0,
    "timezone": "America/New_York",
    "timezone_abbreviation": "EDT",
    "current_temperature_c": 22.5,
    "current_apparent_temperature_c": 23.1,
    "current_humidity_pct": 65,
    "current_weather_code": 1,
    "current_weather_description": "Mainly clear",
    "current_is_day": true,
    "current_precipitation_mm": 0.0,
    "current_cloud_cover_pct": 25,
    "current_pressure_msl_hpa": 1015.2,
    "current_wind_speed_kmh": 12.3,
    "current_wind_direction_deg": 220,
    "current_wind_gusts_kmh": 25.1,
    "forecast_days": [
        {
            "date": "2025-03-18",
            "weather_code": 2,
            "weather_description": "Partly cloudy",
            "temp_max_c": 24.5,
            "temp_min_c": 15.2,
            "sunrise": "2025-03-18T07:05",
            "sunset": "2025-03-18T19:12",
            "uv_index_max": 6.5,
            "precipitation_sum_mm": 0.0,
            "precipitation_probability_max": 10,
            "wind_speed_max_kmh": 18.5,
            "wind_gusts_max_kmh": 35.0,
            "wind_direction_dominant": 210
        }
    ],
    "forecast_count": 7,
    "fetched_at": "2025-03-18T10:30:00.000000"
}

Notes

• Free API: Open-Meteo is completely free for non-commercial use. No API key needed.
• Rate limits: The API is generous but avoid excessive concurrent requests. The Actor processes locations sequentially.
• Geocoding: City names are automatically resolved to coordinates using Open-Meteo's geocoding service. If a city name is ambiguous, the most relevant result is used.
• Data freshness: Weather data is updated every 15 minutes by Open-Meteo.
• Coordinates: Use decimal degrees format (e.g., 37.7749,-122.4194). Latitude range: -90 to 90. Longitude range: -180 to 180.