# 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. - Page: https://fous.com/methods/weather.com/get-hourly-forecast - Method: `weather.com/get_hourly_forecast`, version 1 - Website: weather.com - Returns: matched place, location key, units, hourly time, temperature, feels-like, conditions, precipitation chance, wind, humidity - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `hours` | integer | no | `48` | Number of upcoming hourly forecasts, for example 24. Maximum 48. Default 24. | | `units` | string | no | `"metric"` | Temperature and wind units, for example imperial or metric. One of "imperial", "metric". Default "imperial". | | `location` | string | yes | `"80209"` | City, street address, ZIP code or postcode, for example Denver. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "hours": 48, "units": "metric", "location": "80209" } ``` Its output: ```json { "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" } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash 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"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## 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 ## Input schema ```json { "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 ```json { "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 } ``` ## See more - [The Weather Channel API: Get daily forecast](https://fous.com/methods/weather.com/get-daily-forecast.md): Gets 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. - [The Weather Channel API: Get current weather](https://fous.com/methods/weather.com/get-current-weather.md): Gets 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. - [The Weather Channel API: List weather alerts](https://fous.com/methods/weather.com/list-weather-alerts.md): Lists 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. - [NWS API: Get hourly forecast](https://fous.com/methods/weather.gov/get-hourly-forecast.md): Looks up a US city, street address or ZIP code and returns up to 156 hourly National Weather Service forecasts for it. - [MSN API: Get forecast](https://fous.com/methods/msn.com/get-forecast.md): Gets up to 10 days of MSN Weather forecasts for a city, address, or ZIP code, with optional hourly forecasts for the next 24 hours. - [AccuWeather API: Get current weather](https://fous.com/methods/accuweather.com/get-current-weather.md): Gets 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. - [NWS API: Get National Weather Service forecast](https://fous.com/methods/weather.gov/get-forecast.md): Looks 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. - [MSN API: Get current weather](https://fous.com/methods/msn.com/get-current-weather.md): Gets current MSN Weather conditions for a city, address or ZIP code. The place is found through OpenStreetMap Nominatim. Matches for broad searches are approximate. - [All The Weather Channel methods](https://fous.com/methods/weather.com.md)