Our documentation has a new look! Here’s a quick guide for those of you who are used to the old layout:

If you are looking for the Story API Migration Guide: This has been absorbed into a few key places:


Content Distribution Service (CDS)

This is the official documentation for the Content Distribution Service (CDS), NPR’s system for the validation, ingestion, and distribution of content. Released initially in 2020, CDS was built as a new foundation for distributing content to the wider NPR network that would be built into Grove, a new CMS tool and publishing platform for NPR, Member Stations and PBS.


Something new! Please read our guide to restricted content in CDS


What is CDS?

NPR’s Content Distribution Service (CDS) is a proprietary platform used to house and distribute NPR content. The CDS application programming interface (API) allows authorized users to access the CDS as long as the user agrees and adheres to the CDS API Terms of Use.

CDS provides publishers with a method to create, update, and maintain content conforming to a flexible but predictable model. It also provides retrieval clients with methods of retrieving and querying published content based on a variety of use cases.

Key concepts for those new to CDS

CDS is JSON only

The CDS uses JSON as its only way to send and retrieve data. The decision to use JSON was made due to its ease of storing and validating data in our backend.

CDS uses JSON Schema profiles

We use the JSON Schema language to define profiles. The benefit of this is that users of the API can see both the documentation for any given element in the API as well as get insight into how our backend validates a given document. See the specific profile documentation here.

More questions?

See our FAQ section.

Ready to start using CDS? Read the Getting Started guide for first steps.


© 2024 npr