npr.org

Audio recommendations tailored to a user's preferences

🔑 oauth2 9 endpoints entertainment

📄 Docs 📋 OpenAPI spec 🔬 Try in Swagger UI

SDKs by language (5 total)

npr-one-api-js-sdk

npm install npr-one-api-js-sdk

GitHub integration →

npr-one-test

npm install npr-one-test

GitHub integration →

RAD-Android ✓ Official

# Maven: see https://github.com/npr/RAD-Android

GitHub integration →

npr-pmpsdk

composer require npr-pmpsdk

GitHub integration →

RAD-iOS ✓ Official

# See https://github.com/npr/RAD-iOS

GitHub integration →

curl examples

Get recent ratings the logged-in user has submitted

curl \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  /v2/history

Get the list of available channels

curl \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  /v2/channels

Get a list of media for the logged-in user from NPR's recommendation engine

curl \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  /v2/recommendations

Endpoints (9 total)

GET

/v2/history

Get recent ratings the logged-in user has submitted

GET

/v2/channels

Get the list of available channels

GET

/v2/recommendations

Get a list of media for the logged-in user from NPR's recommendation engine

GET

/v2/promo/recommendations

Retrieve the most recent promo audio heard by the logged-in user

GET

/v2/search/recommendations

Get a list of recent audio and aggregation items associated with search terms

GET

/v2/aggregation/{aggId}/recommendations

Get a set of recommendations for an aggregation independent of the user's lis…

GET

/v2/organizations/{orgId}/recommendations

Get a variety of details about an organization including various lists of rec…

GET

/v2/organizations/{orgId}/categories/{category}/recommendations

Get a list of recommendations from a category of content from an organization

POST

/v2/ratings

Collect new ratings for media previously recommended to the logged-in user

Related APIs in same category

jokes.one vimeo.com npr.org npr.org npr.org