ASSET MANAGEMENT & SYNDICATION
Documentation

API Reference

Dev Resources

Short URLs

Asset Management System API Reference

Audience and Overview

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

End Point

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

Resources - Data Organization

News Organization Resource

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.

Methods

Get all information for an organization
URL: http://ams.news21.com/api/v2/organization//
Format: JSON
HTTP Method: GET
Requires API Key: YES
Parameters: None
Response:

Newsroom Resource

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.

Methods

Get all information for an organization
URL: http://ams.news21.com/api/v2/organization//
Format: JSON
HTTP Method: GET
Requires API Key: YES
Parameters: None
Response:

Projects

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.

Story Packages

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".

Stories

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.

Assets/Media

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.

Categories/Tags

A category is used to tag (group) various resources.