The News21 AMS is a centralized system that allows a news organization with multiple newsrooms to house all their story packages and assets together. This API (Application Programming Interface) allows for all the content to be delivered per request in the data format JSON.
This documentation provides explanations and examples on what type of information is returned per request and how to make a request for said data.
Please Note: To access a majority of the methods, a partner API key is required. To signup for a key click here
All API request are available through the following base end-point.
http://ams.news21.com/api/v2/
Current Version: v2 - View the Change Log for recent changes
A news organization allows multiple newsrooms to be grouped together. In the News21 model each university is viewed as a news organization, and every year a new newsroom is created.
A newsroom is a group of editors and journalist that produce story packages. In the News21 model a newsroom occurs each summer and belongs to a news organization.
A project allows story packages to be grouped together. They are not directly associated to a newsroom, but both share story packages. This allows a newsroom to work on story packages in different projects. In the News21 model a project is seen a the "topic" for a given year.
A story package (aka meta-story) is a container which can hold one or more stories being developed. A story package can have more than one newsroom working together but can only belong to one project. In the News21 model a story package can include an individual or a team working on a specific angle of the "topic".
A story is a well ... a story. Multiple stories can make up a story package or one story to a package. Each story will have assets (media) tied to it including: plain text, links, audio, video, embeds, photos. In the News21 model there is generally one plain text asset (written story) per story.
An asset/media includes: plain text, links, audio, video, embeds, photos. All assets are associated with a story. In the News21 model there is generally one plain text asset (written story) per story. Each story is also required to have at least one image associated with it.
A category is used to tag (group) various resources.