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

NPR Stationfinder API

The Stationfinder API from NPR — 2 operation(s) for stationfinder.

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

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

This API exposes 2 operations across 2 paths, and defines 23 schemas. It is described by OpenAPI 3.0.1, at version 2.

Requests are made against a single base URL, https://identity.api.npr.org/.

2 operations 2 paths 23 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
2
Base URL
https://listening.api.npr.org/
Authentication
OAuth 2.0
Terms of Service
Resource Areas
1

Authentication & Security 1

NPR Stationfinder API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oauth2) using the authorizationCode flow, exposing 5 scopes.

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.

Stationfinder 2
GET
/v3/stations
NPR List stations close to you or filter by search criteria
searchStations 6 params → 200400401429500503
GET
/v3/stations/{stationId}
NPR Retrieve metadata for the station with the given numeric ID
getStationById 2 params → 200400401404429500503

Schemas 23

The contract defines 23 schemas that model the data the API accepts and returns. The most detailed are StationBrandData (7 properties), StationData (6 properties), StationSearchMetaData (6 properties), CollectionDocument (6 properties). Each schema is shown below with its type and property counts.

StationNetworkTierTwoData
object
Metadata about a tier 2 organization in the network, if this station is part of a network
4 properties 3 required
StationListDocument
A collection of stations close to you or filtered by search criteria
StationBrandData
object
An associative array of brand-related metadata for this station
7 properties 4 required
StationLinks
object
5 properties 1 required
StationRelatedLink
A link to miscellaneous related content for the station; these typically are not present, and clients should generally not need to use these
StationNetworkData
object
Metadata about the network, if this station is part of a network
3 properties 2 required
CollectionDocument
object
Base Collection.Doc+JSON output
6 properties 6 required
StationSearchMetaData
object
6 properties
StationDonationLink
A link to a pledge page for the station
StationBrandLink
A link to a web page, logo, or audio file related to the branding of the station
AbstractCDocLink
StationStreamsLink
A link to an audio stream related to the station
StationLink
A link related to the station
StationNetworkTierThreeData
object
Metadata about a tier 3 organization in the network, if this station is part of a network
3 properties 3 required
ErrorDocument
A Collection.doc+JSON representation of an error result from an API call
Error
object
A serialized version of any error encountered when processing this request
3 properties 1 required
AbstractLink
object
1 property 1 required
StationNewscastData
object
Metadata about the newscast for this station; newscasts are handled internally by other microservices such as the NPR One Listening Service, so this data shoul…
2 properties 2 required
StationEligibilityData
object
An associative array of eligibility-related metadata for this station
5 properties 4 required
StationNetworkTierOneData
object
Metadata about the top-level organization in the network, if this station is part of a network
5 properties 3 required
StationData
object
6 properties 5 required
StationPodcastsLink
A link to an audio podcast or podcast feed related to the station
StationDocument

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

npr-stationfinder-api-openapi.yml Raw ↑

Other APIs NPR publishes across the network.

NPR Listening
NPR Authorization API
NPR Identity API