The Weather Channel API: Get hourly forecast
Gets the next 1 to 48 hourly forecasts for a city, address, ZIP code or postcode from The Weather Channel, with times local to the matched place.
Unofficial. Not affiliated with or endorsed by The Weather Channel.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Hours optional
hours Number of upcoming hourly forecasts, for example 24. Maximum 48.
48
Whole number from 1 to 48. Default
24.- Units optional
units Temperature and wind units, for example imperial or metric.
metric
One of
imperial,metric. Defaultimperial.- Location, required
location City, street address, ZIP code or postcode, for example Denver.
80209
Input as JSON
{ "hours": 48, "units": "metric", "location": "80209"}Output
{ "location_key": "postcode.278023916", "matched_place": "Denver, 80209, Colorado, United States", "hourly_forecast": [ { "time": "2026-09-28T19:00:00-06:00", "page_url": "https://weather.com/weather/hourbyhour/l/postcode.278023916" , "conditions": "Mostly Cloudy", "wind_speed": 17, "temperature": 20, "wind_direction": "S", "humidity_percent": 50, "feels_like_temperature": 20, "precipitation_chance_percent": 15 }, { "time": "2026-09-28T20:00:00-06:00", "page_url": "https://weather.com/weather/hourbyhour/l/postcode.278023916" , "conditions": "Mostly Cloudy", "wind_speed": 16, "temperature": 19, "wind_direction": "SSW", "humidity_percent": 55, "feels_like_temperature": 19, "precipitation_chance_percent": 15 }, { "time": "2026-09-28T21:00:00-06:00", "page_url": "https://weather.com/weather/hourbyhour/l/postcode.278023916" , "conditions": "Cloudy", "wind_speed": 11, "temperature": 18, "wind_direction": "SW", "humidity_percent": 55, "feels_like_temperature": 18, "precipitation_chance_percent": 15 } ], "wind_speed_unit": "km/h" , "temperature_unit": "°C"}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"weather.com/get_hourly_forecast","input":{"hours":48,"units":"metric","location":"80209"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "weather.com/get_hourly_forecast" , "input": { "hours": 48, "units": "metric", "location": "80209" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "weather.com/get_hourly_forecast" , "input": { "hours": 48, "units": "metric", "location": "80209" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run weather.com/get_hourly_forecast# with {"hours":48,"units":"metric","location":"80209"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "location" ], "properties": { "hours": { "type": "integer", "default": 24, "maximum": 48, "minimum": 1, "description": "Number of upcoming hourly forecasts, for example 24. Maximum 48." }, "units": { "enum": [ "imperial", "metric" ], "type": "string", "default": "imperial", "description": "Temperature and wind units, for example imperial or metric." }, "location": { "type": "string", "minLength": 1, "description": "City, street address, ZIP code or postcode, for example Denver." } }}Output schema
{ "type": "object", "required": [ "matched_place", "location_key", "temperature_unit", "wind_speed_unit", "hourly_forecast" ], "properties": { "location_key": { "type": "string", "description": "Weather.com location key.", "x-fous-developer": true }, "matched_place": { "type": "string", "description": "Name of the matched place." }, "hourly_forecast": { "type": "array", "items": { "type": "object", "required": [ "time", "temperature", "feels_like_temperature", "conditions", "precipitation_chance_percent", "wind_speed", "wind_direction", "humidity_percent", "page_url" ], "properties": { "time": { "type": "string", "description": "Local time in ISO 8601 with offset." }, "page_url": { "type": "string", "description": "Hourly forecast page for this place." }, "conditions": { "type": [ "string", "null" ] }, "wind_speed": { "type": [ "number", "null" ] }, "temperature": { "type": [ "number", "null" ] }, "wind_direction": { "type": [ "string", "null" ] }, "humidity_percent": { "type": [ "number", "null" ] }, "feels_like_temperature": { "type": [ "number", "null" ] }, "precipitation_chance_percent": { "type": [ "number", "null" ] } }, "additionalProperties": false }, "description": "Upcoming hourly forecast, in time order." }, "wind_speed_unit": { "type": "string", "description": "Unit used for wind speed." }, "temperature_unit": { "type": "string", "description": "Unit used for temperature and feels-like temperature." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
weather.com/get_hourly_forecast- Returns
- matched place, location key, units, hourly time, temperature, feels-like, conditions, precipitation chance, wind, humidity
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method weather.com/get_hourly_forecast with the inputs above.
Ask your agent
- What's the hour-by-hour forecast for Chicago over the next 12 hours?
- Pull the next 48 hours of hourly weather for ZIP 30309 from weather.com
- I'm biking around SW1A 1AA this afternoon — give me hourly temps in Celsius and rain chances for the next 6 hours
- Check The Weather Channel for hourly conditions at 1600 Amphitheatre Parkway, Mountain View for the next day, in Fahrenheit
- Hourly wind, humidity and feels-like temperature for Melbourne, Australia, metric units, next 36 hours
See more
All The Weather Channel methodsGets The Weather Channel's daily forecast for a city, address, ZIP code or postcode: up to 15 upcoming days with highs, lows, conditions, rain chance, wind, humidity, UV and sun times.
weather.com/get_daily_forecastGets current conditions and today's high and low from The Weather Channel for a city, postcode, ZIP code or street address worldwide. Street addresses are geocoded exactly first; some observations omit gusts or other measurements.
weather.com/get_current_weatherLists active severe weather alerts for a city, address, ZIP or postcode on The Weather Channel, most severe first. An empty list means no active alerts.
weather.com/list_weather_alertsLooks up a US city, street address or ZIP code and returns up to 156 hourly National Weather Service forecasts for it.
weather.gov/get_hourly_forecastGets up to 10 days of MSN Weather forecasts for a city, address, or ZIP code, with optional hourly forecasts for the next 24 hours.
msn.com/get_forecastGets current conditions and RealFeel for a city or postal code on AccuWeather. The UV level follows standard UV-index ranges. Air quality is null unless it is shown with the current conditions.
accuweather.com/get_current_weatherLooks up the National Weather Service seven-day day and night forecast for a U.S. city, address, or ZIP code. Forecast availability depends on NWS land-grid coverage.
weather.gov/get_forecastGets current MSN Weather conditions for a city, address or ZIP code. The place is found through OpenStreetMap Nominatim. Matches for broad searches are approximate.
msn.com/get_current_weather