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)

npm install npr-one-api-js-sdk
npm install npr-one-test
RAD-Android ✓ Official
# Maven: see https://github.com/npr/RAD-Android
composer require npr-pmpsdk
RAD-iOS ✓ Official
# See https://github.com/npr/RAD-iOS
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.onevimeo.comnpr.orgnpr.orgnpr.org
At a glance
Total SDKs5
Languages4
Endpoints9
Authoauth2
Categories1