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 Observations API

Current and real-time PWS observations

Weather Underground Observations 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 Observations. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 2 operations across 2 paths, and defines 5 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.

2 operations 2 paths 5 schemas 2 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 Observations 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 2

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

Observations 2

Current and real-time PWS observations

GET
/v2/pws/observations/current
Get current observations for a PWS station
getCurrentObservations 4 params → 200401404
GET
/v2/pws/observations/all/1day
Get all observations for the current day
getAllObservations1Day 4 params → 200401404

Schemas 5

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

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
CurrentObservationsResponse
object
Response containing current PWS observations
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wunderground-observations-api-openapi.yml Raw ↑

Other APIs Weather Underground publishes across the network.

Weather Underground Forecast API
Weather Underground Historical API
Weather Underground Location API