How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
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.2.0, at version 3.

Requests are made against a single base URL, https://station.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.2.0
API Version
3
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), CollectionDocument (6 properties), StationSearchMetaData (6 properties). Each schema is shown below with its type and property counts.

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

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
Where this information came from

This is an independent, third-party profile of NPR Stationfinder API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.