Weather Data Scraper

Get weather forecasts and historical observations from weather.com for any location worldwide. This Actor provides structured JSON data for 10-day daily forecasts, 48-hour hourly forecasts, and historical weather observations with detailed hourly readings.

Features

• 10-Day Daily Forecast - Get high/low temperatures, conditions, precipitation chance, humidity, and wind for the next 10 days
• 48-Hour Hourly Forecast - Detailed hour-by-hour forecast including feels-like temperature, UV index, and cloud cover
• Historical Weather Data - Access past weather observations with optional detailed hourly readings (every 30 minutes)
• Global Coverage - Works with any city worldwide, automatically finds the nearest weather station
• Flexible Units - Choose between metric (Celsius, km/h, hPa) or imperial (Fahrenheit, mph, inHg)

Use Cases

• Travel Planning - Check weather conditions at your destination before booking
• Event Planning - Review historical weather to choose the best date for outdoor events
• Agriculture - Analyze weather patterns for crop planning and irrigation scheduling
• Research & Analytics - Climate data analysis and trend detection
• Insurance - Weather verification for claims processing
• Energy Sector - Solar and wind power forecasting based on historical patterns
• Retail - Weather-based demand planning for seasonal products
• Construction - Project scheduling based on weather conditions
• Sports & Recreation - Plan outdoor activities with accurate forecasts
• Logistics - Route planning considering weather impacts

Input Parameters

Parameter	Type	Required	Description
dataType	string	Yes	Type of weather data: forecast-daily, forecast-hourly, or history
locations	array	Yes	List of city names (e.g., "San Francisco, CA", "Prague", "Tokyo, Japan")
startDate	string	For history	Start date in YYYY-MM-DD format (required for historical data)
endDate	string	No	End date for historical range (defaults to startDate if not provided)
historyDetail	string	No	Detail level for historical data: daily (summary only) or hourly (includes observations every 30 min). Default: hourly
units	string	No	metric or imperial (default: metric)

Location Formats

The Actor accepts city names in various formats:

• City only: Prague, Tokyo, Sydney
• City, State/Region: San Francisco, CA, Munich, Bavaria
• City, Country: London, UK, Paris, France, Tokyo, Japan

The API automatically finds the nearest weather station for your location. For major cities, it uses international airport weather stations (ICAO codes) which provide the most reliable historical data.

Output Examples

All data types output one row per day for consistency.

10-Day Daily Forecast

Returns 10 rows (one per day) with flat structure:

{
  "location": "San Francisco, CA",
  "stationCode": "KSFO",
  "stationName": "San Francisco",
  "dataType": "forecast-daily",
  "date": "2025-01-15",
  "dayOfWeek": "Wednesday",
  "units": "metric",
  "scrapedAt": "2025-01-15T10:30:00.000Z",
  "highTemp": 15,
  "lowTemp": 9,
  "conditions": "Partly Cloudy",
  "precipChance": 10,
  "humidity": 65,
  "windSpeed": 12,
  "windDirection": "W"
}

48-Hour Hourly Forecast

Returns 2-3 rows (one per day) with hourly data array:

{
  "location": "San Francisco, CA",
  "stationCode": "KSFO",
  "stationName": "San Francisco",
  "dataType": "forecast-hourly",
  "date": "2025-01-15",
  "units": "metric",
  "scrapedAt": "2025-01-15T10:30:00.000Z",
  "hourlyForecast": [
    {
      "time": "2025-01-15T11:00:00-08:00",
      "temp": 12,
      "feelsLike": 10,
      "humidity": 68,
      "windSpeed": 15,
      "windDirection": "W",
      "precipChance": 5,
      "cloudCover": 40,
      "uvIndex": 3,
      "conditions": "Partly Cloudy"
    }
  ]
}

Historical Data

Returns one row per day with summary and optional hourly observations:

{
  "location": "San Francisco, CA",
  "stationCode": "KSFO",
  "stationName": "San Francisco",
  "dataType": "history",
  "date": "2025-01-10",
  "units": "metric",
  "scrapedAt": "2025-01-15T10:30:00.000Z",
  "summary": {
    "highTemp": 14,
    "lowTemp": 8,
    "avgTemp": 11,
    "precipitation": 0,
    "dewPoint": 6,
    "maxWindSpeed": 18,
    "avgWindSpeed": 10,
    "pressure": 1015.2,
    "visibility": 16
  },
  "hourlyObservations": [
    {
      "time": "2025-01-10 00:00:00",
      "temp": 9,
      "dewPoint": 6,
      "humidity": 78,
      "windSpeed": 8,
      "windDirection": "NW",
      "windGust": null,
      "pressure": 1016.5,
      "precipRate": 0,
      "precipAccum": 0,
      "conditions": "Fair"
    }
  ]
}

Data Sources

This Actor fetches data from weather.com's API, which provides:

• Forecasts from The Weather Channel's weather prediction models
• Historical observations from official weather stations (airports, meteorological stations)
• Data available for thousands of weather stations worldwide

Limitations

• Historical Data Range: Historical observations are available from weather stations. Coverage varies by location, but most major airports have data going back several years.
• Rate Limits: The Actor includes built-in delays to respect API rate limits.
• Station Coverage: Remote areas may have limited weather station coverage; the Actor automatically finds the nearest available station.