# The Weather Channel API: Get current weather

> 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.

Unofficial. Not affiliated with or endorsed by The Weather Channel.

- Page: https://fous.com/methods/weather.com/get-current-weather
- Method: `weather.com/get_current_weather`, version 1
- Website: weather.com
- Returns: conditions, temperature, feels like, today's high and low, humidity, wind, UV, visibility, pressure, dew point, sunrise, sunset, moon phase
- 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 |
|---|---|---|---|---|
| `units` | string | no | `"imperial"` | Measurement units, for example metric; defaults to imperial. One of "imperial", "metric". Default "imperial". |
| `location` | string | yes | `"1600 Pennsylvania Ave NW, Washington, DC"` | City, street address, ZIP code or postcode, for example Chicago or SW1A 1AA. |

## Output

From a run on Oct 31, 2026. Its input:

```json
{
  "units": "imperial",
  "location": "1600 Pennsylvania Ave NW, Washington, DC"
}
```

Its output:

```json
{
  "place": "White House, 1600, Pennsylvania Avenue Northwest, Ward 2, Washington, District of Columbia, 20500, United States",
  "sunset": "2026-09-28T18:55:25-04:00",
  "sunrise": "2026-09-28T07:01:25-04:00",
  "humidity": {
    "unit": "%",
    "value": 72
  },
  "latitude": 38.8976387,
  "pressure": {
    "unit": "inHg",
    "value": 29.95
  },
  "uv_index": {
    "unit": "index",
    "value": 0
  },
  "uv_level": "Low",
  "dew_point": {
    "unit": "°F",
    "value": 59
  },
  "longitude": -77.0365525,
  "today_low": {
    "unit": "°F",
    "value": 61
  },
  "wind_gust": {
    "unit": "mph",
    "value": null
  },
  "conditions": "Cloudy",
  "feels_like": {
    "unit": "°F",
    "value": 68
  },
  "moon_phase": "Waning Gibbous",
  "today_high": {
    "unit": "°F",
    "value": 71
  },
  "visibility": {
    "unit": "mi",
    "value": 10
  },
  "wind_speed": {
    "unit": "mph",
    "value": 6
  },
  "temperature": {
    "unit": "°F",
    "value": 68
  },
  "wind_direction": "North-northwest",
  "observation_time": "2026-09-28T20:21:47-04:00",
  "weather_com_link": "https://weather.com/weather/today/l/38.8976387,-77.0365525",
  "weather_com_location_key": "7dc1d1f0f971fb2f1015d2619d4cb577636a50fef8affa579c521a0d38d87b35"
}
```

## 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_current_weather","input":{"units":"imperial","location":"1600 Pennsylvania Ave NW, Washington, DC"}}'
```

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 weather like right now in Chicago? Need temperature, feels like, and wind.
- Check weather.com for current conditions at SW1A 1AA in metric units, including today's high and low.
- Is it humid in Miami at the moment? Also tell me the UV index and when sunset is.
- Current temperature and pressure at 1600 Pennsylvania Avenue NW, Washington DC, please.
- Using The Weather Channel, get me the conditions in Tokyo right now in Celsius, plus visibility, dew point, and moon phase.

## Input schema

```json
{
  "type": "object",
  "required": [
    "location"
  ],
  "properties": {
    "units": {
      "enum": [
        "imperial",
        "metric"
      ],
      "type": "string",
      "default": "imperial",
      "description": "Measurement units, for example metric; defaults to imperial."
    },
    "location": {
      "type": "string",
      "minLength": 1,
      "description": "City, street address, ZIP code or postcode, for example Chicago or SW1A 1AA."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "place",
    "observation_time",
    "conditions",
    "wind_direction",
    "uv_level",
    "moon_phase",
    "sunrise",
    "sunset",
    "weather_com_link",
    "weather_com_location_key",
    "latitude",
    "longitude",
    "temperature",
    "feels_like",
    "today_high",
    "today_low",
    "humidity",
    "wind_speed",
    "wind_gust",
    "uv_index",
    "visibility",
    "pressure",
    "dew_point"
  ],
  "properties": {
    "place": {
      "type": "string",
      "description": "Matched place name and region."
    },
    "sunset": {
      "type": [
        "string",
        "null"
      ],
      "description": "Local sunset time in ISO 8601 with UTC offset."
    },
    "sunrise": {
      "type": [
        "string",
        "null"
      ],
      "description": "Local sunrise time in ISO 8601 with UTC offset."
    },
    "humidity": {
      "type": "object",
      "required": [
        "value",
        "unit"
      ],
      "properties": {
        "unit": {
          "type": "string"
        },
        "value": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "description": "Relative humidity with an explicit measurement unit.",
      "additionalProperties": false
    },
    "latitude": {
      "type": "number",
      "description": "Matched latitude."
    },
    "pressure": {
      "type": "object",
      "required": [
        "value",
        "unit"
      ],
      "properties": {
        "unit": {
          "type": "string"
        },
        "value": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "description": "Barometric pressure with an explicit measurement unit.",
      "additionalProperties": false
    },
    "uv_index": {
      "type": "object",
      "required": [
        "value",
        "unit"
      ],
      "properties": {
        "unit": {
          "type": "string"
        },
        "value": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "description": "Current UV index with an explicit measurement unit.",
      "additionalProperties": false
    },
    "uv_level": {
      "type": [
        "string",
        "null"
      ],
      "description": "UV level in words."
    },
    "dew_point": {
      "type": "object",
      "required": [
        "value",
        "unit"
      ],
      "properties": {
        "unit": {
          "type": "string"
        },
        "value": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "description": "Dew point with an explicit measurement unit.",
      "additionalProperties": false
    },
    "longitude": {
      "type": "number",
      "description": "Matched longitude."
    },
    "today_low": {
      "type": "object",
      "required": [
        "value",
        "unit"
      ],
      "properties": {
        "unit": {
          "type": "string"
        },
        "value": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "description": "Today's forecast low with an explicit measurement unit.",
      "additionalProperties": false
    },
    "wind_gust": {
      "type": "object",
      "required": [
        "value",
        "unit"
      ],
      "properties": {
        "unit": {
          "type": "string"
        },
        "value": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "description": "Wind gust speed with an explicit measurement unit.",
      "additionalProperties": false
    },
    "conditions": {
      "type": [
        "string",
        "null"
      ],
      "description": "Current weather conditions in words."
    },
    "feels_like": {
      "type": "object",
      "required": [
        "value",
        "unit"
      ],
      "properties": {
        "unit": {
          "type": "string"
        },
        "value": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "description": "Feels-like temperature with an explicit measurement unit.",
      "additionalProperties": false
    },
    "moon_phase": {
      "type": [
        "string",
        "null"
      ],
      "description": "Moon phase in words."
    },
    "today_high": {
      "type": "object",
      "required": [
        "value",
        "unit"
      ],
      "properties": {
        "unit": {
          "type": "string"
        },
        "value": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "description": "Today's forecast high with an explicit measurement unit.",
      "additionalProperties": false
    },
    "visibility": {
      "type": "object",
      "required": [
        "value",
        "unit"
      ],
      "properties": {
        "unit": {
          "type": "string"
        },
        "value": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "description": "Visibility with an explicit measurement unit.",
      "additionalProperties": false
    },
    "wind_speed": {
      "type": "object",
      "required": [
        "value",
        "unit"
      ],
      "properties": {
        "unit": {
          "type": "string"
        },
        "value": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "description": "Wind speed with an explicit measurement unit.",
      "additionalProperties": false
    },
    "temperature": {
      "type": "object",
      "required": [
        "value",
        "unit"
      ],
      "properties": {
        "unit": {
          "type": "string"
        },
        "value": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "description": "Air temperature with an explicit measurement unit.",
      "additionalProperties": false
    },
    "wind_direction": {
      "type": [
        "string",
        "null"
      ],
      "description": "Compass direction in words."
    },
    "observation_time": {
      "type": [
        "string",
        "null"
      ],
      "description": "Local observation time in ISO 8601 with UTC offset."
    },
    "weather_com_link": {
      "type": "string",
      "description": "Weather page for the matched location."
    },
    "weather_com_location_key": {
      "type": [
        "string",
        "null"
      ],
      "description": "The Weather Channel place identifier."
    }
  },
  "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 hourly forecast](https://fous.com/methods/weather.com/get-hourly-forecast.md): 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.
- [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.
- [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 current conditions](https://fous.com/methods/weather.gov/get-current-conditions.md): Gets the latest observed weather from a nearby National Weather Service station for a US city, address, or ZIP code. Measurements the station does not report are null.
- [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.
- [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.
- [Weather Underground API: Get historical weather](https://fous.com/methods/wunderground.com/get-historical-weather.md): Gets daily weather and time-ordered airport observations for a past date near a city, airport, or ZIP code. Summary averages use the available observations; missing measurements are null.
- [All The Weather Channel methods](https://fous.com/methods/weather.com.md)