Collect new ratings for media previously recommended in NPR Listening
A documented NPR Listening operation that changes something in your account. Describe the outcome you want in plain words — HumDay writes the program, proves it, and runs it.
What this operation does
Collect new ratings for media previously recommended to the logged-in user
- POSTChanges data
listening.api.npr.org/v2/ratings
How HumDay uses it
- You describe the outcome. Not this operation by name — what you want to happen. HumDay works out which operations it needs.
- The contract names it. Before anything is built, you see exactly which NPR Listening operations the program may use, and this is one of them.
- You approve access. Because this one changes data, it cannot run until you have explicitly granted it.
Other NPR Listening operations
- Get a list of recent audio and aggregation items associatedGET · reads data
- Get the list of available channelsGET · reads data
- Get a list of media for the logged-in user from NPR'sGET · reads data
- Get recent ratings the logged-in user has submittedGET · reads data
- Retrieve the most recent promo audio heard by the logged-in userGET · reads data
- Get a set of recommendationsGET · reads data
- Get a variety of details about an organization including variousGET · reads data
- Get a list of recommendations from a category of content from anGET · reads data
Questions
- Can HumDay collect new ratings for media previously recommended in NPR Listening?
- Yes. This operation is published in NPR Listening's own API description, so HumDay can use it without a hand-built connector — once you have approved it for your automation.
- Will this change my NPR Listening data?
- Yes — this is a POST operation, so it changes something in NPR Listening. HumDay holds anything that writes behind an approval you grant explicitly, and the contract you approve says what it may touch.
- Do I need to write code?
- No. You describe the outcome you want in plain words. HumDay agrees a contract with you, writes the program, and shows you a proof run before anything touches your NPR Listening account.
Where this came from
Read from a published API description for NPR Listening at listening.api.npr.org/v2/swagger.json. The description above is the provider’s own wording, not ours. Last published 2023-03-06.