| NPR Shop | NPR Social Media | Sign In | Register

This Documentation Might Be Out Of Date

Thank you for your interest in NPR API services. You have found our legacy documentation site, which is no longer being updated. This API is no longer publicly available for client integrations; for documentation of current API services, please visit the NPR Developer Center.

Get started!
| Register

Terms of Use
Give Us Feedback

API Overview

An API, or Application Programming Interface, is a way for two computer applications to talk to each other in a common language that they both understand. NPR's API is a content API, which essentially provides a structured way for other computer applications to get NPR stories in a predictable, flexible and powerful way. The content that is available includes audio from most NPR programs dating back to 1995 as well as text, images and other web-only content from NPR and NPR member stations. This archive consists of over 250,000 stories that are grouped into more than 5,000 different aggregations.

Using NPR's API

After registering, you can access the API by constructing a URL with parameters indicating what stories you want the API to return. The default format of the results is NPRML, a custom XML structure specifically designed to represent all of NPR's digital content comprehensively. The API can also return results in RSS, MediaRSS, JSON, Atom and through HTML and JavaScript widgets (other formats are pending). To learn more about how to access the API, go to the Story API documentation or use our Query Generator to help you get started. To see the complete list of NPR lists that you can query against, see our Mapping Index.

Terms of Use

The API requires a registration key. Click here to register. During the registration process, you must agree to the Terms of Use for NPR's Web Sites. The main points of these terms as they relate to use of the API can be found below. The spirit of these terms is that we want you to use, enjoy and share the journalism and programming produced by NPR and participating NPR member stations, but it is also important to respect the rights and integrity of the work and of the dedicated people who created it. Distorting the journalism or not giving credit properly goes against the very premise of the API. We have great trust that the NPR community will use our API in good faith. Thank you.

See NPR's Terms of Use
NPR's Privacy Policy
NPR's Permissions Policy