Emplifi

App · 25 actions

Read your Emplifi social analytics, posts, Community messages, Care cases, Listening mentions and Facebook ads, label Community messages, manage asset collections, and start workflows on new posts, messages and mentions.

Actions

ActionWhat it does
Add labels to Community messagesLabel Community messages or posts.
Archive collectionArchive a collection.
Create collectionCreate an asset collection, private to you or shared with everyone in the account.
Delete collectionDelete an archived collection and every asset in it.
Get aggregated post metricsGet one metric, such as engagements or number of posts, totalled over the posts several profiles on any network published in a period.
Get Community metricsGet a Community metric, such as the number of messages or the median response time, for some profiles over a period.
Get Facebook ads metricsGet Facebook ads metrics, such as spend, impressions and clicks, for some ad accounts over a period.
Get Listening metricsGet Listening metrics, such as mentions, authors and interactions, for your queries over a period.
Get profile metricsGet daily metrics such as followers, reach and views for one network's profiles over a period, one row per day, week or month.
List ad accountsList the Facebook ad accounts your Emplifi user can see that were active in a period.
List Care case messagesList a Care case's messages, newest first, 50 at a time (24 months are kept), and its internal notes if you want them.
List Care casesList the Care cases created in a period, with their status, priority and who they are assigned to.
List collection assetsList the images and videos in a collection, with download links that work for an hour, or get one asset.
List collectionsList up to 500 asset collections, active and archived.
List Community messagesList the comments, direct messages, mentions, posts and reviews in Emplifi Community for some profiles (the last 90 days are kept).
List content labelsList the content labels your Emplifi user can see, with their ids.
List Facebook adsList the Facebook ads of some ad accounts that were active in a period, with the fields and results you choose.
List Listening mentionsList the posts and comments your Listening queries found in a period.
List Listening queriesList your Listening queries with their ids and whether each is running, paused or done.
List postsList the posts one network's profiles published in a period, with the fields and metrics you choose.
List profile labelsList the profile labels your Emplifi user can see, with the profiles each one is on.
List profilesList the profiles of one network connected to your Emplifi account, with their ids, handles, time zones and whether insights are on.
Remove labels from Community messagesTake labels off Community messages or posts.
Restore collectionBring an archived collection back.
Update collectionRename a collection, change its description, or share a private one with everyone in the account.

Add labels to Community messages

Label Community messages or posts. A label that doesn't exist yet is created as a global label. Needs permission to apply global labels.

Inputs

Message IDscontent_idslistRequired
The Community messages or posts, each as its network, a dash and its id, such as facebook-849715935050458_1520511894637588. Build it from a Community message's platform and id.
LabelslabelslistRequired
The label names. A label that doesn't exist yet is created as a global label.

Outputs

countnumber
How many came back
labelslist
The labels
resultslist
What happened to each message
Example output
{
  "count": 1,
  "labels": [
    "Needs reply"
  ],
  "results": [
    {
      "content_id": "facebook-849715935050458_1520511894637588",
      "status": "ok"
    }
  ]
}

Archive collection

Archive a collection. It can be restored at any time, and must be archived before it can be deleted.

Inputs

Collectioncollection_idtextRequired
The collection. Pick one, or give its id.

Outputs

collection_idtext
The collection's id
statustext
ok when Emplifi made the change
Example output
{
  "collection_id": "g11N6XQBZejoR1EGGGq8",
  "status": "ok"
}

Create collection

Create an asset collection, private to you or shared with everyone in the account. An account holds 500 collections at most.

Inputs

NamenametextRequired
The collection's name.
Descriptiondescriptiontext
What the collection is for.
Who can use itpermissiontext
Private or global. Defaults to private.One of: private (Private (only you)), global (Global (everyone in the account)).

Outputs

collection_idtext
The new collection's id
nametext
The collection's name
permissiontext
private or global
Example output
{
  "collection_id": "O1yxunQBZejoR1EGQshy",
  "name": "Winter campaign",
  "permission": "private"
}

Delete collection

Delete an archived collection and every asset in it. This can't be undone.

Inputs

Collectioncollection_idtextRequired
The collection. Pick one, or give its id.

Outputs

collection_idtext
The collection's id
statustext
ok when Emplifi made the change
Example output
{
  "collection_id": "g11N6XQBZejoR1EGGGq8",
  "status": "ok"
}

Get aggregated post metrics

Get one metric, such as engagements or number of posts, totalled over the posts several profiles on any network published in a period.

Inputs

ProfilesprofileslistRequired
The profiles to include, up to 100.
MetricmetrictextRequired
The metric. Each covers only some networks; those marked insights need insights connected.One of: engagement_rate (Engagement rate), insights_avg_time_watched (Avg time watched (insights)), insights_completion_rate (Completion rate (insights)), insights_engagements (Engagements (insights)), insights_impressions (Impressions (insights)), insights_impressions_engagement_rate (Impressions engagement rate (insights)), insights_initial_video_views (Initial video views (insights)), insights_link_clicks (Link clicks (insights)), insights_media_view_time (Media view time (insights)), insights_media_views (Media views (insights)), and 36 more.
Fromdate_startdate
The first day. Leave empty for 7 days ago.
Untildate_enddate
The last day, included. Leave empty for today.
Split bysplit_bylist
Up to two ways to break the number down. Leave empty for one total.One or more of: date.day (Day), date.week (Week), date.month (Month), date.quarter (Quarter), date.year (Year), platform (Network), profile, post_labels (Content label), profile_label (Profile label), content_type (Content type), media_type (Media type).
Content labelscontent_label_idslist
Only content carrying any of these labels.

Outputs

countnumber
How many came back
rowslist
One row per bucket: the dimensions it was split by (date, profile, platform and so on) and each metric's value under the metric's name
Example output
{
  "count": 1,
  "rows": [
    {
      "page_posts": 3,
      "profile": {
        "id": "564919357",
        "platform": "twitter"
      }
    }
  ]
}

Get Community metrics

Get a Community metric, such as the number of messages or the median response time, for some profiles over a period.

Inputs

ProfilesprofileslistRequired
The profiles to include.
MetricmetrictextRequired
The metric.One of: content_count (Number of messages and posts), message_count (Messages in conversations), response_time (Median response time), response_time_business_hours (Median response time in business hours), salesforce_lead_count (Salesforce leads escalated), salesforce_case_count (Salesforce cases escalated).
Fromdate_startdate
The first day. Leave empty for 7 days ago.
Untildate_enddate
The last day, included. Leave empty for today.
Split bysplit_bylist
How to break the number down. Response times split by period use when the answer was sent.One or more of: date.day (Day), date.week (Week), date.month (Month), profile, community_type (Message type), sentiment, resolve_status (Resolved or not), post_label (Content label), profile_label (Profile label).
Content labelscontent_label_idslist
Only content carrying any of these labels.

Outputs

countnumber
How many came back
rowslist
One row per bucket: the dimensions it was split by (date, profile, platform and so on) and each metric's value under the metric's name
Example output
{
  "count": 1,
  "rows": [
    {
      "content_count": 42,
      "date": "2026-11-10"
    }
  ]
}

Get Facebook ads metrics

Get Facebook ads metrics, such as spend, impressions and clicks, for some ad accounts over a period. Money is in US dollars.

Inputs

Ad accountsad_account_idslistRequired
The Facebook ad accounts to read. Pick them, or give their ids.
MetricsmetricslistRequired
The metrics.One or more of: impressions, spend (Amount spent (USD)), clicks, cpc (Cost per click), ctr (Click-through rate), cpm (Cost per 1,000 impressions), engagement_rate (Engagement rate), post_engagement (Post engagement), page_engagement (Page engagement), page_likes (Page likes), and 19 more.
Fromdate_startdate
The first day. Leave empty for 7 days ago.
Untildate_enddate
The last day, included. Leave empty for today.
Split bysplit_bylist
Up to two ways to break the numbers down. By day covers 31 days at most.One or more of: date.day (Day), date.week (Week), date.month (Month), ad_account (Ad account), campaign, objective, publisher_platform (Publishing platform), placement, country, age, gender.

Outputs

countnumber
How many came back
rowslist
One row per bucket: the dimensions it was split by (date, profile, platform and so on) and each metric's value under the metric's name
Example output
{
  "count": 1,
  "rows": [
    {
      "clicks": 71,
      "date": "2026-11-10",
      "spend": 125.4
    }
  ]
}

Get Listening metrics

Get Listening metrics, such as mentions, authors and interactions, for your queries over a period.

Inputs

Listening querieslistening_query_idslistRequired
The Listening queries to read. Pick them, or give their ids.
MetricsmetricslistRequired
The metrics.One or more of: authors, comments, content_count (Content count), interactions, potential_impressions (Potential impressions), shares.
Fromdate_startdate
The first day. Leave empty for 7 days ago.
Untildate_enddate
The last day, included. Leave empty for today.
Split bysplit_bylist
Up to two ways to break the numbers down. Leave empty for totals.One or more of: listening_query (Listening query), platform (Network or source), content_type (Content type), sentiment, country, language, media_type (Media type), hashtag, keyword, topic, post_label (Content label).
Sentimentsentimentslist
Only mentions with any of these sentiments.One or more of: positive, neutral, negative.
Sourcesplatformslist
Only mentions from these networks or sources.One or more of: facebook, instagram, twitter (X (Twitter)), youtube, blogs, forums, news.

Outputs

countnumber
How many came back
rowslist
One row per bucket: the dimensions it was split by (date, profile, platform and so on) and each metric's value under the metric's name
Example output
{
  "count": 1,
  "rows": [
    {
      "content_count": 21,
      "platform": "twitter"
    }
  ]
}

Get profile metrics

Get daily metrics such as followers, reach and views for one network's profiles over a period, one row per day, week or month.

Inputs

NetworknetworktextRequired
The network the profiles are on.One of: facebook, instagram, twitter (X (Twitter)), youtube, linkedin, pinterest, tiktok.
Profilesprofile_idslistRequired
The network's profiles to read, up to 100. Pick them, or give their ids.
MetricsmetricslistRequired
Up to 25 metrics. Those marked insights need the profile's insights connected in Emplifi.One or more of: fans_change (Fans change), fans_lifetime (Fans lifetime), insights_fan_adds (Fan adds (insights)), insights_fan_adds_unique (Fan adds unique (insights)), insights_fans_lifetime (Fans lifetime (insights)), insights_follows (Follows (insights)), insights_media_views (Media views (insights)), insights_net_follows (Net follows (insights)), insights_post_impressions (Post impressions (insights)), insights_reach (Reach (insights)), and 41 more.
Fromdate_startdate
The first day. Leave empty for 7 days ago.
Untildate_enddate
The last day, included. Leave empty for today.
Split bysplit_bylist
How to break the numbers down. Defaults to by day.One or more of: date.day (Day), date.week (Week), date.month (Month), profile, profile_label (Profile label).

Outputs

countnumber
How many came back
rowslist
One row per bucket: the dimensions it was split by (date, profile, platform and so on) and each metric's value under the metric's name
Example output
{
  "count": 2,
  "rows": [
    {
      "date": "2026-11-01",
      "fans_lifetime": 209119
    },
    {
      "date": "2026-11-02",
      "fans_lifetime": 209171
    }
  ]
}

List ad accounts

List the Facebook ad accounts your Emplifi user can see that were active in a period.

Inputs

Fromdate_startdate
The first day. Leave empty for 90 days ago.
Untildate_enddate
The last day. Leave empty for today.

Outputs

ad_accountslist
The ad accounts
countnumber
How many came back
Example output
{
  "ad_accounts": [
    {
      "id": "640875043123456",
      "name": "Emplifi ads"
    }
  ],
  "count": 1
}

List Care case messages

List a Care case's messages, newest first, 50 at a time (24 months are kept), and its internal notes if you want them.

Inputs

Case IDcase_idtextRequired
The case's id, from 'List Care cases' or a trigger.
Include internal notesinclude_internal_notestrue/false
Turn on to include your team's internal notes.
Fieldsfieldslist
What to get for each message. Leave empty for everything.One or more of: attachments, author, care_case (Care case), content_type (Content type), conversation_id (Conversation ID), created_by (Created by), created_time (Created time), id, languages, message, and 10 more.
Next pageaftertext
The 'next' cursor an earlier run of this step gave, to read the next page. When it is given, the other fields are ignored.

Outputs

countnumber
How many came back
messageslist
The messages
nexttext
The cursor for the next page: give it as 'Next page' to read on. Empty on the last page.
remainingnumber
How many more there are after this page
Example output
{
  "count": 1,
  "messages": [
    {
      "author": {
        "id": "164929129743",
        "name": "Emplifi",
        "url": "https://www.facebook.com/emplifi"
      },
      "created_time": "2026-11-10T20:30:57+02:00",
      "id": "facebook-1234567890",
      "message": "Hello, my order hasn't arrived",
      "message_type": "comment",
      "origin": "User-Generated Content",
      "platform": "facebook",
      "url": "https://www.facebook.com/1234567890"
    }
  ],
  "next": "eyJuZXh0IjoiZXlK",
  "remaining": 12
}

List Care cases

List the Care cases created in a period, with their status, priority and who they are assigned to. Gets one page; run it again with the next page cursor to see more.

Inputs

Fromdate_startdate and time
The start. Leave empty for 7 days ago.
Untildate_enddate and time
The end. Leave empty for now.
Profilesprofileslist
Only cases for these profiles.
Case IDscase_idslist
Only these cases, by id.
Fieldsfieldslist
What to get for each case. Leave empty for everything.One or more of: assigned_users (Assigned users), author, case_number (Case number), closed_time (Closed time), created_time (Created time), custom_fields (Custom fields), done_time (Done time), first_assigned_users (First assigned users), id, languages, and 6 more.
Ordersort_ordertext
Which come first. Defaults to newest or highest first.One of: desc (Newest or highest first), asc (Oldest or lowest first).
Page sizelimitnumber
How many to return, 1 to 100. Defaults to 100.From 1 to 100.
Next pageaftertext
The 'next' cursor an earlier run of this step gave, to read the next page. When it is given, the other fields are ignored.

Outputs

caseslist
The cases
countnumber
How many came back
nexttext
The cursor for the next page: give it as 'Next page' to read on. Empty on the last page.
remainingnumber
How many more there are after this page
Example output
{
  "cases": [
    {
      "assigned_users": [
        {
          "email": "ana@example.com",
          "id": "d123456",
          "name": "Ana Lopez"
        }
      ],
      "author": {
        "id": "164929129743",
        "name": "Emplifi",
        "url": "https://www.facebook.com/emplifi"
      },
      "case_number": 3879,
      "created_time": "2026-11-10T08:52:25.248Z",
      "id": "CCC_123456_8GWYLU3OSK2d7rxwHg_3879",
      "platform": "facebook",
      "priority": "high",
      "profile_id": "164929129743",
      "sentiment": "neutral",
      "status": "open"
    }
  ],
  "count": 1,
  "next": "eyJuZXh0IjoiZXlK",
  "remaining": 12
}

List collection assets

List the images and videos in a collection, with download links that work for an hour, or get one asset.

Inputs

Collectioncollection_idtextRequired
The collection. Pick one, or give its id.
Asset IDasset_idtext
Only this asset. Leave empty for every asset.

Outputs

assetslist
The assets
countnumber
How many came back
Example output
{
  "assets": [
    {
      "collectionId": "g11N6XQBZejoR1EGGGq8",
      "createdTime": "2026-10-03T13:48:31.206Z",
      "description": "Hero image",
      "expirationDate": "2026-12-31T23:59:59.000Z",
      "id": "NOo5u3QBrFWnaVYeCNdn",
      "note": "Approved by legal",
      "type": "image",
      "updatedTime": "2026-10-03T13:48:31.206Z",
      "url": "https://cdn-assets-sign.socialbakers.com/asset.jpg"
    }
  ],
  "count": 1
}

List collections

List up to 500 asset collections, active and archived.

Inputs

None.

Outputs

collectionslist
The collections
countnumber
How many came back
Example output
{
  "collections": [
    {
      "createdBy": {
        "email": "ana@example.com",
        "userId": "1336595"
      },
      "createdTime": "2026-10-02T12:32:57.849Z",
      "id": "g11N6XQBZejoR1EGGGq8",
      "name": "Winter campaign",
      "permission": "private",
      "status": "active",
      "updatedTime": "2026-10-02T12:32:58.603Z"
    }
  ],
  "count": 1
}

List Community messages

List the comments, direct messages, mentions, posts and reviews in Emplifi Community for some profiles (the last 90 days are kept). Gets one page; run it again with the next page cursor to see more.

Inputs

ProfilesprofileslistRequired
The profiles whose messages to list.
Fromdate_startdate and time
The start. Leave empty for 7 days ago.
Untildate_enddate and time
The end. Leave empty for now.
Message typescommunity_typeslist
Only these kinds of message.One or more of: comment, direct_message (Direct message), post, wall_post (Wall post), review, ad_comment (Comment on an ad), mention_comment (Mention in a comment), mention_post_and_media_tag (Mention or tag in a post), mention_story_mention (Mention in a story).
Content typescontent_typeslist
Only these content types.One or more of: comment, conversation, post, shared (Share), story.
Fromorigintext
Only messages from your audience, or only your brand's own.One of: User-Generated Content (From your audience), Brand's Content (From your brand).
Content labelscontent_label_idslist
Only content carrying any of these labels.
Fieldsfieldslist
What to get for each message. Leave empty for everything.One or more of: author, care_case (Care case), community_type (Community type), content_type (Content type), created_time (Created time), id, message, messages, origin, parent_post (Parent post), and 6 more.
Ordersort_ordertext
Which come first. Defaults to newest or highest first.One of: desc (Newest or highest first), asc (Oldest or lowest first).
Page sizelimitnumber
How many to return, 1 to 100. Defaults to 100.From 1 to 100.
Next pageaftertext
The 'next' cursor an earlier run of this step gave, to read the next page. When it is given, the other fields are ignored.

Outputs

countnumber
How many came back
nexttext
The cursor for the next page: give it as 'Next page' to read on. Empty on the last page.
postslist
The messages
remainingnumber
How many more there are after this page
Example output
{
  "count": 1,
  "next": "eyJuZXh0IjoiZXlK",
  "posts": [
    {
      "author": {
        "id": "17841400000000000",
        "name": "Jo Bloggs",
        "url": "https://www.instagram.com/jobloggs"
      },
      "community_type": "comment",
      "content_type": "comment",
      "created_time": "2026-11-10T16:01:57+02:00",
      "id": "17873624615551014",
      "message": "Where can I buy this?",
      "origin": "User-Generated Content",
      "platform": "instagram",
      "post_labels": [
        {
          "id": "5d879004a44a4cbcb13e",
          "name": "Campaign A"
        }
      ],
      "profileId": "17841420590000000",
      "sentiment": "neutral",
      "url": "https://www.instagram.com/p/CUKrCG1rxNi/"
    }
  ],
  "remaining": 12
}

List content labels

List the content labels your Emplifi user can see, with their ids.

Inputs

None.

Outputs

countnumber
How many came back
labelslist
The content labels
Example output
{
  "count": 1,
  "labels": [
    {
      "id": "5d879004a44a4cbcb13e",
      "name": "Campaign A"
    }
  ]
}

List Facebook ads

List the Facebook ads of some ad accounts that were active in a period, with the fields and results you choose.

Inputs

Ad accountsad_account_idslistRequired
The Facebook ad accounts to read. Pick them, or give their ids.
Fromdate_startdate
The first day. Leave empty for 7 days ago.
Untildate_enddate
The last day, included. Leave empty for today.
Fieldsfieldslist
What to get for each ad. Leave empty for everything.One or more of: ad_account_id (Ad account ID), ad_account_name (Ad account name), ad_campaign_id (Ad campaign ID), ad_campaign_name (Ad campaign name), ad_set_id (Ad set ID), ad_set_name (Ad set name), ad_type (Ad type), attachments, clicks, cost_per_post_engagement (Cost per post engagement), and 20 more.
Sort bysort_bytext
What to sort by. Leave empty for Emplifi's order.One of: clicks, cost_per_post_engagement (Cost per post engagement), cpc, cpm, ctr, engagement_rate (Engagement rate), impressions, inline_link_clicks (Inline link clicks), interaction_count (Interaction count), landing_page_view (Landing page view), and 4 more.
Ordersort_ordertext
Which come first. Defaults to newest or highest first.One of: desc (Newest or highest first), asc (Oldest or lowest first).
How manylimitnumber
How many ads to return, 1 to 500. Defaults to 100.From 1 to 500.

Outputs

adslist
The ads
countnumber
How many came back
Example output
{
  "ads": [
    {
      "ad_account_name": "Emplifi ads",
      "clicks": 71,
      "created_time": "2026-11-01T08:28:18.000Z",
      "id": "23851631725210369",
      "impressions": 20735,
      "name": "Winter launch",
      "objective": "OUTCOME_AWARENESS",
      "spend": 125.4,
      "status": "ACTIVE"
    }
  ],
  "count": 1
}

List Listening mentions

List the posts and comments your Listening queries found in a period. Gets one page; run it again with the next page cursor to see more.

Inputs

Listening querieslistening_query_idslistRequired
The Listening queries to read. Pick them, or give their ids.
Fromdate_startdate
The first day. Leave empty for 7 days ago.
Untildate_enddate
The last day, included. Leave empty for today.
Fieldsfieldslist
What to get for each mention. Leave empty for everything.One or more of: attachments, author, authorId (Author ID), comments, content_type (Content type), country, created_time (Created time), id, interactions, language, and 12 more.
Sort bysort_bytext
Highest first by this. Leave empty for Emplifi's order.One of: comments, interactions, potential_impressions (Potential impressions), shares.
Sentimentsentimentslist
Only mentions with any of these sentiments.One or more of: positive, neutral, negative.
Sourcesplatformslist
Only mentions from these networks or sources.One or more of: facebook, instagram, twitter (X (Twitter)), youtube, blogs, forums, news.
Content labelscontent_label_idslist
Only content carrying any of these labels.
Page sizelimitnumber
How many to return, 1 to 100. Defaults to 100.From 1 to 100.
Next pageaftertext
The 'next' cursor an earlier run of this step gave, to read the next page. When it is given, the other fields are ignored.

Outputs

countnumber
How many came back
nexttext
The cursor for the next page: give it as 'Next page' to read on. Empty on the last page.
postslist
The mentions
remainingnumber
How many more there are after this page
Example output
{
  "count": 1,
  "next": "eyJuZXh0IjoiZXlK",
  "posts": [
    {
      "author": {
        "id": "164929129743",
        "name": "Emplifi",
        "url": "https://www.facebook.com/emplifi"
      },
      "created_time": "2026-11-04T16:06:00+00:00",
      "id": "164929129743_10155892118379744",
      "interactions": 5628,
      "listening_queries": [
        {
          "id": "LNQ_172196_6241c597857f917a0529975d"
        }
      ],
      "message": "Loving the new Emplifi dashboards",
      "platform": "facebook",
      "sentiment": "positive",
      "url": "https://www.facebook.com/164929129743/posts/10155892118379744"
    }
  ],
  "remaining": 12
}

List Listening queries

List your Listening queries with their ids and whether each is running, paused or done.

Inputs

None.

Outputs

countnumber
How many came back
querieslist
The Listening queries
Example output
{
  "count": 1,
  "queries": [
    {
      "community_enabled": false,
      "id": "LNQ_172196_6241c597857f917a0529975d",
      "name": "Brand mentions",
      "status": "Running"
    }
  ]
}

List posts

List the posts one network's profiles published in a period, with the fields and metrics you choose. Gets one page; run it again with the next page cursor to see more.

Inputs

NetworknetworktextRequired
The network the profiles are on.One of: facebook, instagram, twitter (X (Twitter)), youtube, linkedin, pinterest, tiktok, snapchat.
Profilesprofile_idslistRequired
The network's profiles to read, up to 100. Pick them, or give their ids.
Fromdate_startdate
The first day. Leave empty for 7 days ago.
Untildate_enddate
The last day, included. Leave empty for today.
Fieldsfieldslist
What to get for each post. Leave empty for everything except insights metrics.One or more of: attachments, author, authorId (Author ID), comments, comments_sentiment (Comments sentiment), content, content_type (Content type), created_time (Created time), deleted, grade, and 105 more.
Sort bysort_bytext
What to sort by. Defaults to when it was published. X posts can't be sorted.One of: comments, created_time (Created time), interactions, interactions_per_1k_fans (Interactions per 1,000 fans), reactions, reactions_by_type.anger (Reactions by type: anger), reactions_by_type.haha (Reactions by type: haha), reactions_by_type.like (Reactions by type: like), reactions_by_type.love (Reactions by type: love), reactions_by_type.sorry (Reactions by type: sorry), and 48 more.
Ordersort_ordertext
Which come first. Defaults to newest or highest first.One of: desc (Newest or highest first), asc (Oldest or lowest first).
Content labelscontent_label_idslist
Only content carrying any of these labels.
Page sizelimitnumber
How many to return, 1 to 100. Defaults to 100.From 1 to 100.
Next pageaftertext
The 'next' cursor an earlier run of this step gave, to read the next page. When it is given, the other fields are ignored.

Outputs

countnumber
How many came back
nexttext
The cursor for the next page: give it as 'Next page' to read on. Empty on the last page.
postslist
The posts
remainingnumber
How many more there are after this page
Example output
{
  "count": 1,
  "next": "eyJuZXh0IjoiZXlK",
  "posts": [
    {
      "author": {
        "id": "164929129743",
        "name": "Emplifi",
        "url": "https://www.facebook.com/emplifi"
      },
      "content": "Join us at the summit next week",
      "created_time": "2026-11-10T16:06:00+00:00",
      "id": "164929129743_10155892118379744",
      "media_type": "link",
      "post_labels": [
        {
          "id": "5d879004a44a4cbcb13e",
          "name": "Campaign A"
        }
      ],
      "url": "https://www.facebook.com/164929129743/posts/10155892118379744"
    }
  ],
  "remaining": 12
}

List profile labels

List the profile labels your Emplifi user can see, with the profiles each one is on.

Inputs

None.

Outputs

countnumber
How many came back
labelslist
The profile labels
Example output
{
  "count": 1,
  "labels": [
    {
      "id": "ffc196eb056b42fd9b03",
      "name": "Europe",
      "profiles": [
        {
          "name": "Emplifi",
          "platform": "facebook"
        }
      ]
    }
  ]
}

List profiles

List the profiles of one network connected to your Emplifi account, with their ids, handles, time zones and whether insights are on.

Inputs

NetworknetworktextRequired
The network whose connected profiles to list.One of: facebook, instagram, twitter (X (Twitter)), youtube, linkedin, pinterest, tiktok, snapchat, whatsapp, googlebp (Google Business Profile).

Outputs

countnumber
How many came back
profileslist
The profiles
Example output
{
  "count": 1,
  "profiles": [
    {
      "community_enabled": true,
      "id": "164929129743",
      "insights_enabled": true,
      "name": "Emplifi",
      "picture": "https://example.cdn.com/picture.png",
      "platform": "facebook",
      "profile_name": "emplifi",
      "timezone": "America/Los_Angeles"
    }
  ]
}

Remove labels from Community messages

Take labels off Community messages or posts.

Inputs

Message IDscontent_idslistRequired
The Community messages or posts, each as its network, a dash and its id, such as facebook-849715935050458_1520511894637588. Build it from a Community message's platform and id.
LabelslabelslistRequired
The label names. A label that doesn't exist yet is created as a global label.

Outputs

countnumber
How many came back
labelslist
The labels
resultslist
What happened to each message
Example output
{
  "count": 1,
  "labels": [
    "Needs reply"
  ],
  "results": [
    {
      "content_id": "facebook-849715935050458_1520511894637588",
      "status": "ok"
    }
  ]
}

Restore collection

Bring an archived collection back.

Inputs

Collectioncollection_idtextRequired
The collection. Pick one, or give its id.

Outputs

collection_idtext
The collection's id
statustext
ok when Emplifi made the change
Example output
{
  "collection_id": "g11N6XQBZejoR1EGGGq8",
  "status": "ok"
}

Update collection

Rename a collection, change its description, or share a private one with everyone in the account.

Inputs

Collectioncollection_idtextRequired
The collection. Pick one, or give its id.
New namenametext
The new name. Leave empty to keep it.
New descriptiondescriptiontext
The new description. Leave empty to keep it.
Share with everyonemake_globaltrue/false
Turn on to make a private collection global. It can't be made private again.

Outputs

collection_idtext
The collection's id
statustext
ok when Emplifi made the change
Example output
{
  "collection_id": "g11N6XQBZejoR1EGGGq8",
  "status": "ok"
}

On this page