The Content API allows your third-party software tool to access information relating to all existing content in Publish, whether the content has been published, drafted, scheduled, or copied.

Content API endpoints

There are six endpoints available in the Content API:

• Get Channel Content
• Get Copied Content
• Get Instagram Content
• Get Publication Labels
• Add Publication Labels
• Remove Publication Labels

Get Channel Content

Using the Get Channel Content endpoint, you can receive information about all content within your Social Media Management organization, whether drafted, scheduled, or published. The returned data will include URLs to the media (e.g. images, videos, or link thumbnails) and caption text.

You can choose to narrow down your results by specifying a Post ID, Channel ID, network, status (e.g. drafted, scheduled, or published), promotion status, labels, or visibility. Please see the guides below for help locating the Post ID or Channel ID.

Get Copied Content

Using any existing Post ID in Social Media Management, you can use the Get Copied Content endpoint to return a list of drafted, scheduled, and published posts which were copied from that original content. Your results will include the network, media (e.g. images, videos, or links), text, labels, any applicable approvers, and more.

Find out how to locate your Post ID from the guide below.

Get Publication Labels, Add Publication Labels, and Remove Publication Labels

Using the three available endpoints for publication labels, you can discover which labels are attached to your content, or choose to add or remove labels. To get started, you will need:

1. The ID for your content. Find out how to get the Content ID below.
2. The ID for your label (only applicable when adding or removing labels). To find an existing Label ID, use the Search labels endpoint from the Labels API.

Finding a Post ID

There are two possible ways to find your Post ID:

Via the Content API

If you need the ID for your content in order to discover information relating to labels or copied posts, you can first use the Get Channel Content endpoint listed above. The results will contain the IDs for all applicable content.

Via Social Media Management

In Social Media Management, any user can easily locate the ID for your content, whether it’s a draft, scheduled post, or published post. Open any post and the ID will automatically appear in the URL, immediately following the applicable network as shown below.

Finding a Channel ID

There are two possible ways to find the ID for your Channel:

Via the Channel API

Using the Get Channels endpoint from the Channel API, results will contain information relating to all existing channels in your Social Media Management organization including the channel ID for each.

Via Social Media Management

In Social Media Management, any user with a user role of Team Leader or Admin can find the ID for your channel by navigating to Channel Admin and selecting the channel.

The Channel ID will appear beside the channel name at the top of the page as shown below.

Benefits of the Content API

There are four common uses for the Content API:

1. You may decide to produce an external dashboard which displays a feed of your most recently published posts, potentially intended to be displayed on a big screen.
2. Similarly, you could create an external dashboard which displays a feed of your Social Media Management organization’s up-coming scheduled or drafted posts.
3. You may decide to create a custom insights report to discover, for example, the number of posts broken down by Channel, group of Channels (locales), media type, or label.
4. Using the add publication labels endpoint, you may decide to build a custom logic to label specific content after it has been successfully published.

Accessing technical documentation

For general information about the features of our available APIs, check out our Introduction to APIs section. To view technical documentation for each Social Media Management API, please visit: falconio.docs.apiary.io.