Working with the Content API¶

In this guide we explore how to use the Content API to get content items and how to moderate them.

What are content items¶

A post from Facebook, a tweet from Twitter, a video from Youtube, etc. are what we call a content item.

Contract and collection slugs¶

Most endpoints of the Content API require a contract and collection slug to access them.

More information can be found in the collection guide and the contract guide.

How to get and moderate content items¶

The Content API will automatically collect content items based on your collections which can be managed in the Control API.

The queue endpoint should be used when you want to retrieve collected content items. This will return a so called content queue which can be moderated by a user using the. moderate content queue item endpoint.

These content items can be published as a so called publication content feed. The content items in this feed are the items from the content queue that passed moderation. The published content items can be consumed by using the get published content items endpoint. This endpoint should be used if you want to display your published content in, for example, an application or website.

Convenience endpoints¶

There is a get published collections endpoint that can list all collections of a contract. This endpoint returns simple collection objects. To retrieve all information of a collection, the Control API must be used.

To get a count of the number of published content items, you can use the get published content count endpoint.