With the Engage API, you can use a third-party software tool to generate and receive data exports from your team’s conversations in Engage.
This article offers an introduction to the Social Media Management Engage API. For more information, please visit Social Media Management's API Technical Documentation here. Don’t yet have access to Social Media Management APIs? Find out how to get access here.
In this article:
What Features Are Available?
There are two endpoints available in the Engage API:
- Create an Export
- Get an Export
Create an Export
Using the create an export endpoint, you can define the data your Engage export should contain. You must specify your search beginning and end dates, networks (Facebook, Instagram, or Twitter), and types of content (posts, comments, replies, and DMs), though you can also choose to limit your results by Channel using a Channel UUID.
Your results will provide you with a UUID to be used with the Get an Export endpoint below.
For help finding your Channel UUID, please follow the guide below.
In order to remain compliant with LinkedIn’s terms of service, it will not be possible to include LinkedIn data in your Engage export.
Get an Export
Once you have used the create an export endpoint to define the data (above) and retrieved a UUID for your export, you can use the get an export endpoint to retrieve the export data.
You will receive a link to the CSV export of your specified Engage data. To find out more about what an Engage export will contain, please see the full guide here.
How Can I Get My Channel UUID?
When you are creating and defining your export (above), you will have the option of clarifying which Channels you would like to include in the export. For this, you will need each Channel’s UUID.
To obtain this, you will need to use the Get Channels endpoint from Social Media Management's Channel API. The Get Channels endpoint will return a list of all Channels in your organization, along with data such as the Channel name, connected status, network, and the UUID.
How Can I Use the Engage API?
Social Media Management's Engage API is an ideal solution for any department which is collecting and analyzing customer service and sales communications inquiries which are being handled via different formats, such as social media, web chat, and email.
In this case, it may be necessary to use a Business Integration tool to access and collect data from various customer service tools via an API. Using the Engage API, you can access all conversations on social media for the Business Integration tool.
Where Can I Find the Technical Documentation?
For general information and descriptions of the available APIs, check out the Help Center guides here. To view the Social Media Management API Technical Documentation, please visit: falconio.docs.apiary.io