Streamdata.io API Gallery - NPR (Report Issue)

Organization(s):

NPR Show a web-based login/signup form to a user

If the parameters passed to this endpoint are correct, it will redirect to `npr.org/oauth2/login` for the user to complete the sign-in. Currently acceptable values for `scope` are any combination of the following: - `identity.readonly` - for read...

NPR Initiate an OAuth2 login flow for limited input devices

This flow should only be used by clients who cannot show a native webview or do not have advanced input controls. It is an alternative to `GET /authorization/v2/authorize`. Third-party clients will need to use one or the other of these two endpoi...

NPR Create a new OAuth2 access token

Please be aware that the required parameters are contingent on the `grant_type` that you select. For the `authorization_code` grant type, you are **required** to pass in the `code` and `redirect_uri` parameters. `service`, `username` and `passwor...

NPR Revoke an existing OAuth2 access token

Our implementation follows the proposed IETF specification [RFC-7009](https://tools.ietf.org/html/rfc7009). If your client application offers the ability to for a logged-in user to log out, and you have access to a long-lived `client_credentials`...

NPR Update the following status of the logged-in user for a particular aggregation

After a successful call, this returns a User document with an updated list of affiliations.

NPR Update the logged-in user's favorite station(s)

Right now, only the primary station can be changed. Previously selected stations will not be deleted, but the new station will be moved to first in the array.

NPR Get the latest state information about the logged-in user

After a successful login, the client should send a `GET` call approximately once an hour to refresh the user data.

NPR Copy listening data from a temporary user account to the logged-in user's account

This can and should only be used by clients who have access to the `temporary_user` grant type. Third-party developers do not have access to this grant type by default, and will not need this endpoint.

NPR Get a set of recommendations for an aggregation

This endpoint provides a list of recent audio items associated with the aggregation along with metadata about the aggregation.

NPR Get the list of available channels

These channels allow the user to specify a focus for the content returned in the recommendations endpoint.

NPR Get recent ratings the logged-in user has submitted

This endpoint provides the list of recently-rated audio recommendations that the logged-in user has consumed. Some rated recommendations are filtered, such as sponsorship and donation.

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

This endpoint provides a list of recommendations from a category of content from an organization.

NPR Get a variety of details about an organization including various lists of recent audio items

This endpoint provides a variety of details about an organization including various lists of recent audio items.

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

Gets the most recently played promo for which the user has neither tapped through the promo or listened to the target story.

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

This endpoint is the main mechanism for providing feedback from the user to NPR about the recommendations that are obtained from `GET /listening/v2/recommendations`. A fully-populated link to this endpoint is returned with each individual recomme...

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

This endpoint returns a list of audio recommendations. It is designed to be used for an initial list of recommendations, and then `GET /listening/v2/ratings?recommend=true` should be used for subsequent requests for recommendations. A fully-popul...

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

In the schema shown below, SearchItemDocument is not an actual type of returned object; the object returned by a search will be either an AggregationAudioItemListDocument or an AudioItemDocument.

NPR Send a donation email to the logged-in user (only on request)

This will send a station-specific donation email to the logged-in user.

NPR Request DAAST sponsorship units

**Not** for use by NPR One clients (for whom sponsorship is already integrated into the Listening Service), this endpoint is designed to be used by our other client applications to request sponsorship on behalf of a user. Sponsorship units are ret...

NPR Record tracking data for DAAST sponsorship units

**Not** for use by NPR One clients (for whom sponsorship is already integrated into the Listening Service), this endpoint is designed to be used by our other client applications to submit tracking information for sponsorship units obtained from th...

NPR List stations close to you or filter by search criteria

This endpoint has two main use cases: - If no query parameters passed in, it returns a list of stations that are geographically closest to the calling client (based on GeoIP information) - If one or more query parameters are passed in, it perform...

NPR Retrieve metadata for the station with the given numeric ID

This endpoint retrieves information about a given station, based on its numeric ID, which is consistent across all of NPR's APIs. A typical use case for this data is for clients who want to create a dropdown menu, modal/pop-up or dedicated page d...

Submit Your API

Join the gallery to find out how much you can save with Streamdata.io.