https://github.com/sebasa/homeassistant-wunderground-api
A Home Assistant custom integration that automatically discovers your Weather Underground API key and pulls real-time data from any Weather Station
https://github.com/sebasa/homeassistant-wunderground-api
Last synced: 3 months ago
JSON representation
A Home Assistant custom integration that automatically discovers your Weather Underground API key and pulls real-time data from any Weather Station
- Host: GitHub
- URL: https://github.com/sebasa/homeassistant-wunderground-api
- Owner: sebasa
- Created: 2026-03-06T16:40:43.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-06T16:59:17.000Z (3 months ago)
- Last Synced: 2026-03-06T20:00:01.015Z (3 months ago)
- Language: Python
- Size: 15.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Weather Underground External API - Home Assistant Integration
[](https://github.com/hacs/integration)
A Home Assistant custom integration that automatically discovers your Weather Underground API key and pulls real-time data from your Personal Weather Station (PWS).
---
## Features
- ✅ **Automatic API key discovery** — No need to find or enter your API key manually. The integration scrapes it from the Wunderground dashboard.
- 📊 **15 sensor entities** — Temperature, Humidity, Dew Point, Wind Speed, Wind Gust, Wind Direction, Pressure, Precipitation Rate, Precipitation Total, Heat Index, Wind Chill, Elevation, Solar Radiation, UV Index.
- 🌤️ **Weather entity** — A standard HA weather card entity with current conditions.
- 🔄 **Auto-refresh** — Data updates every 5 minutes.
- 🔑 **Re-auth flow** — If the API key changes, HA will prompt you to refresh it with one click.
- 🌍 **Spanish & English UI**
---
## Installation via HACS
1. In HACS, go to **Integrations → ⋮ → Custom repositories**
2. Add `https://github.com/sebasa/HomeAssistant-Wunderground-API` with category **Dashboard**
3. Search for **Weather Underground API** and install
4. Restart Home Assistant
### Manual Installation
Copy the `custom_components/wunderground_pws` folder into your HA `config/custom_components/` directory, then restart.
---
## Configuration
1. Go to **Settings → Devices & Services → + Add Integration**
2. Search for **Weather Underground API**
3. Enter your station ID (e.g. `IPUNIL11`)
4. The integration will automatically find the API key and validate your station
> **Where do I find my Station ID?**
> Visit `https://www.wunderground.com/dashboard/pws/YOURSTATION` — the station ID is the part after `/pws/`.
---
## Sensors Created
| Sensor | Unit | Device Class |
|--------|------|-------------|
| Temperature | °C | temperature |
| Humidity | % | humidity |
| Dew Point | °C | temperature |
| Heat Index | °C | temperature |
| Wind Chill | °C | temperature |
| Wind Speed | km/h | wind_speed |
| Wind Gust | km/h | wind_speed |
| Wind Direction | ° | — |
| Pressure | hPa | pressure |
| Precipitation Rate | mm/h | precipitation_intensity |
| Precipitation Today | mm | precipitation |
| Elevation | m | — |
| Solar Radiation | W/m² | irradiance |
| UV Index | UV index | — |
---
## Troubleshooting
**"Could not find API key"**
The integration scrapes the API key from your Wunderground dashboard page. If this fails:
- Make sure your station ID is correct and public
- Wunderground may have changed their page structure — please open an issue
**Data not updating**
Check the HA logs for errors from `custom_components.wunderground_pws`. The API key may have expired — go to **Settings → Devices & Services**, find the integration, and click **Re-authenticate**.
---
## License
MIT License