Can NPR's APIs support smart speakers and connected cars?

Yes. The Authorization Service provides an OAuth 2.0 device flow built for limited-input devices such as smart speakers, set-top boxes, and car head units. The device displays a short user code, the listener approves it on their phone, and the device polls for an access token that then unlocks the Listening, Identity, and Station Finder services.

Are the NPR APIs suitable for third-party audio apps outside NPR One?

Apps licensed to play NPR audio outside NPR One use the Station Finder to resolve a local station and the Sponsorship Service to fetch sponsor spots with impression-tracking pixels. Sponsorship access requires an NPR One Enterprise licensing agreement and adherence to NPR's sponsor-insertion compliance terms.

Do these APIs handle general music or podcast streaming?

No. The APIs are scoped to NPR's curated public-radio content and the NPR One experience. They do not cover general music streaming rights or third-party podcast hosting; for broad music or creator content you would use a general streaming or discovery platform instead.

How does an agent discover the right NPR operation for a task?

Once Jentic One is installed, an agent searches the Jentic directory by intent, such as finding a local NPR station or fetching the next recommendation, and Jentic returns the matching NPR operation with its input schema so the agent calls the correct endpoint without reading the reference docs.

NPR APIs for AI Agents

MediaAudio ProcessingDirectory ServicesMixed Provenanceoauth2,bearerOAuth 2.0Agent Ready

www.npr.org·Developer portal → dev.npr.org

NPR API Catalog

6 APIs across 2 product groups.

Media4

NPR One APIBuild NPR One listening experiences end-to-end: authenticate, fetch personalised recommendations, search audio, rate playback, and manage stations and profile.~10 endpoints NPR Listening ServiceFetch personalized NPR audio recommendations, search for episodes, list channels, and submit listener ratings to shape future recommendations.~9 endpoints NPR Sponsorship ServiceFetch NPR sponsorship audio spots and impression-tracking metadata for insertion between NPR audio segments.~2 endpoints NPR Station Finder ServiceLook up NPR member station metadata by geography or station ID, including stream URLs and donation pages.~2 endpoints

Identity Auth2

NPR Identity ServiceRead and update the logged-in NPR One listener's profile, station preferences, and follow list, plus inherit listening data from temporary accounts.~5 endpoints NPR Authorization ServiceIssue and revoke OAuth 2.0 access tokens for the NPR One platform, including device-flow login for smart speakers and connected cars.~3 endpoints

Which NPR API should I use?

I want to...	Use	Why
Obtain or revoke an access token, including device-flow login for smart speakers and cars	NPR Authorization Service	The Authorization Service is the OAuth 2.0 issuer; every other NPR service requires a token from it.
Fetch personalised audio recommendations, search episodes, and submit ratings	NPR Listening Service	The Listening Service is the standalone recommendation, search, ratings, and history surface.
The same listening capabilities plus identity, stations, and OAuth in one unified spec	NPR One API	The NPR One API bundles Listening, Identity, Stations, and Authorization behind a single cross-service surface for full client apps.
Read or update the listener's profile, follows, and favorite station	NPR Identity Service	The Identity Service is the standalone profile, follows, and station-preference surface.
Look up NPR member stations by geography or station ID with stream and donation URLs	NPR Station Finder Service	The Station Finder Service is the dedicated member-station lookup surface.
Fetch sponsor audio spots and impression-tracking metadata for licensed audio apps	NPR Sponsorship Service	The Sponsorship Service is the only surface that returns sponsor creative and tracking pixels for NPR-licensed playback.

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring NPR's services by hand means carrying an OAuth 2.0 token across separate hosts for authorization, identity, listening, stations, and sponsorship, and hand-mapping each operation. With Jentic you install once, add the NPR APIs you need from the Jentic directory, store the credentials once, and your agent calls them.

Permission scoping

You choose which NPR operations an agent may call, so read-only work such as fetching recommendations or looking up a station can be allowed while writes such as updating a profile, deleting an account, or revoking a token stay excluded unless you add them. Path-scoped services like the Station Finder and organisation-scoped recommendations let a rule pin the agent to a single station or organisation.

Credential isolation

FAQs

Specific to using NPR APIs through Jentic.

What can an agent do across NPR's APIs?

An agent can run the full NPR One listener loop: authenticate a listener with OAuth 2.0, fetch and rate personalised audio recommendations, search NPR audio, read and update the listener's profile and follows, look up member stations by location, and retrieve sponsor spots for licensed audio apps. The services are designed to chain together, so an agent can move from login to a personalised, locally scoped listening session in a single flow.

Do all of NPR's services share one authentication model?

Yes. Every service uses OAuth 2.0. The Authorization Service is the token issuer, and the tokens it produces are accepted by the Identity, Listening, and Sponsorship services. The Authorization Service itself is called with a registered client ID and secret rather than an existing access token.

Which API should I use for a full NPR One client versus a single capability?

The NPR One API is a unified surface that bundles listening, identity, station search, and OAuth behind one spec, which suits a complete client app. If you only need one capability, use the standalone service: Listening for recommendations, Identity for profiles, Authorization for tokens, or the Station Finder for station lookup.

BOOK A DEMO

Start Connecting APIs to Your AI Agents

Browse thousands of APIs and connect them all to your agent with Jentic One. One layer, one credential — every API your agent needs.

Book a Demo

For Agents

APIs6 in catalogue

Endpoints31 indexed

Authoauth2,bearer / OAuth 2.0

ProvenanceMixed provenance

An agent can authenticate a listener with OAuth 2.0 (including device flow for smart speakers), fetch and rate personalised NPR audio recommendations, search episodes, read and update the listener's profile, follows, and favorite stations, look up member stations by location, and pull sponsor spots for licensed audio apps.

NPR's APIs are the authoritative source for the NPR One personalised public-radio experience, spanning token issuance, recommendations, listener identity, member-station lookup, and sponsorship compliance rather than general music streaming. The Authorization Service issues one OAuth 2.0 token that the Identity, Listening, and Sponsorship services all accept, so the services are designed to work as one connected surface.

Use for: Building NPR One public-radio experiences: OAuth 2.0 login, personalised audio recommendations and ratings, listener profile and follows, NPR member station lookup, and sponsor-spot insertion for licensed audio apps

Not supported: music streaming rights, third-party podcast hosting, general advertising inventory, audio file playback, non-NPR user identity

Credentials: All NPR services use OAuth 2.0: the Authorization Service issues a single access token that the Identity, Listening, and Sponsorship services all accept, while the Authorization Service itself is called with a registered client ID and secret.

Install Jentic One Beta

Connect the NPR APIs to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the NPR APIs, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fnpr.org" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fnpr.org" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Once connected, ask your agent something like: “authenticate and play a personalised NPR One recommendation”.

What AI Agents Can Do with NPR

Each workflow spans multiple NPR APIs. Jentic routes each operation to the right API automatically.

Authenticate then start a personalised listening session

An agent obtains an access token through the device flow, then fetches the listener's recommendation queue and submits ratings as each item finishes, refining future recommendations.

Example prompt:

Call POST /v2/device and poll POST /v2/token on the Authorization Service to obtain a token, then call GET /v2/recommendations on the Listening Service and POST /v2/ratings after each item plays.

APIs used

NPR Authorization Service + NPR Listening Service

Set a home station and get local recommendations

An agent looks up the listener's local member station, saves it as their favorite in the profile, and then requests station-scoped recommendations so the feed reflects the new home station.

Example prompt:

Call GET /v3/stations on the Station Finder with the listener's ZIP, PUT /v2/stations on the Identity Service to save the favorite, then GET /v2/organizations/{orgId}/recommendations on the Listening Service.

APIs used

NPR Station Finder Service + NPR Identity Service + NPR Listening Service

Resolve a station and insert a sponsor spot

An agent building a licensed third-party audio app resolves the listener's local station, then fetches the next sponsor spot and its tracking pixels to play compliantly before NPR content.

Example prompt:

Call GET /v3/stations on the Station Finder to identify the active station, then GET /v2/ads on the Sponsorship Service and fire the returned impression pixels at playback start.

APIs used

NPR Station Finder Service + NPR Sponsorship Service

Onboard a guest listener into a signed-in profile

After a guest signs in, an agent issues an access token, copies the guest listening history into the permanent account, and confirms the profile so recommendations do not reset.

Example prompt:

Obtain a token via POST /v2/token on the Authorization Service, call POST /v2/user/inherit on the Identity Service with the guest identifier, then GET /v2/user to confirm the profile.

APIs used

NPR Authorization Service + NPR Identity Service

NPR APIs for AI Agents

NPR API Catalog

Media4

Identity Auth2

Which NPR API should I use?

Why Jentic?

FAQs

Start Connecting APIs to Your AI Agents

Connect the NPR APIs to your agent

What AI Agents Can Do with NPR

If you need a different Media vendor