Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Weather Underground Historical API

Historical PWS observations and daily summaries

Weather Underground Historical API is one of 4 APIs that Weather Underground publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Historical. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 4 operations across 4 paths, and defines 7 schemas. It is described by OpenAPI 3.0.3, at version 2.0.0.

Requests are made against a single base URL, https://api.weather.com.

4 operations 4 paths 7 schemas 4 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.0.0
Base URL
https://api.weather.com
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

Weather Underground Historical API declares 1 security scheme for authenticating requests. An API key is passed in the query as apiKey (apiKey). By default, every request must be authenticated.

  • apiKey — API key issued to registered PWS contributors via https://www.wunderground.com/member/api-keys

Paths & Operations 4

Across 4 paths, the API surfaces 4 operations — 4 GET. Each is listed below with its method, path, parameters, and response codes.

Historical 4

Historical PWS observations and daily summaries

GET
/v2/pws/observations/hourly/7day
Get hourly observations for the past 7 days
getHourlyObservations7Day 4 params → 200401404
GET
/v2/pws/dailysummary/7day
Get daily summary observations for the past 7 days
getDailySummary7Day 4 params → 200401404
GET
/v2/pws/history/all
Get all historical observations for a specific date
getHistoryAllForDate 5 params → 200401404
GET
/v2/pws/history/daily
Get daily historical observations for a date range
getHistoryDaily 6 params → 200401404

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are DailySummaryMeasurements (23 properties), Observation (20 properties), DailySummary (10 properties), UnitMeasurements (10 properties). Each schema is shown below with its type and property counts.

DailySummaryResponse
object
Response containing daily summary PWS observations
1 property
ObservationsListResponse
object
Response containing a list of PWS observations over a time period
1 property
Observation
object
A single weather observation record from a PWS station
20 properties
UnitMeasurements
object
Measurement values scoped to the requested unit system. The property name matches the units parameter value (e.g., "imperial", "metric", "ukhybrid", or "metric…
10 properties
ErrorResponse
object
Error response from the API
1 property
DailySummaryMeasurements
object
Daily summary measurements in the requested unit system
23 properties
DailySummary
object
A daily summary record aggregating all observations from a single calendar day for a PWS station.
10 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wunderground-historical-api-openapi.yml Raw ↑

Other APIs Weather Underground publishes across the network.

Weather Underground Forecast API
Weather Underground Location API
Weather Underground Observations API