Social Media Analytics API - Posts, Metrics, Listening, Emplifi

Export the social media analytics your Emplifi account already collects (posts with engagement and insights, daily profile metrics, Listening mentions, the Community inbox and Care cases) into a dataset, a spreadsheet or a warehouse, one row per post, mention, message or metric value. Uses your own Emplifi API credentials, never changes anything in your account, and charges only for rows that carry data.

What it collects

• Posts and videos for Facebook, Instagram, YouTube, X (Twitter), LinkedIn, Pinterest, TikTok and Snapchat profiles in your account: ID, publish time, URL, author, text, content and media type, interactions, reactions, likes, comments, shares, sentiment and content labels, plus any insights field (reach, impressions, media views, video views, saves, clicks, view time) for profiles with insights connected. Lifetime post metrics, sorted and filtered the way the API documents.
• Daily profile metrics: followers, fans, subscribers and their change, reach, impressions, media views, profile views, engagements, per day, week or month, split by profile, profile label, country, gender and age, post attribution and the other documented dimensions.
• Aggregated post metrics across profiles and networks: interactions, engagement rate, page posts, shares, comments, sentiment, response rates and times, video and story metrics, split by profile, platform, date, content type, media type or label.
• Listening: mentions matched by your Listening queries across Facebook, Instagram, X, YouTube, blogs, forums and news, with author, site, language, country, sentiment, interactions and potential impressions; and Listening metrics (mentions, authors, interactions, comments, shares, potential impressions) by platform, country, language, sentiment, topic, hashtag, keyword, person, organization and more.
• Community: comments, direct messages, mentions, reviews and wall posts from the Community inbox with author, message, sentiment, labels and first response; and Community metrics (content and message counts, median response times, Salesforce escalations).
• Care: Care cases with status, priority, sentiment, platform, languages, assignees and custom fields, and the messages of any case.
• Account setup: connected profiles (with insights and Community status), content labels and label groups, profile labels, Listening queries and ad accounts.
• Read only, pay per result, bring your own API token.

Input

Field	What it does
What to read	Connected profiles (default), posts, profile metrics, aggregated post metrics, Listening mentions or metrics, Community content or metrics, Care cases or case messages, Listening queries, content labels, label groups, profile labels or ad accounts.
Network	Facebook, Instagram, X, YouTube, LinkedIn, Pinterest, TikTok, Snapchat, WhatsApp or Google Business, for the profiles, posts and profile metrics modes.
Profile IDs	Up to 100, as the connected profiles mode lists them. Use instagram:1784... to mix networks in aggregated metrics, Community and Care.
Listening query IDs	For Listening modes, or Community instead of profiles.
Start date / End date	YYYY-MM-DD; Community, Care and Listening metrics also take YYYY-MM-DDTHH:MM:SS.
Profile metrics / Aggregated metric / Community metric / Listening metric	The metric names from the provider's tables.
Dimensions, Buckets per dimension	How to split metric values, such as profile and date.day.
Fields	The post, mention, message or case fields to return; empty means a basic set.
Sort by / Sort order	Any field the endpoint allows for sorting, such as interactions or insights_reach.
Content label IDs, Profile label IDs, Content types, Media types, Origin, Post attribution, Post grades, Community types, Platforms, Sentiment, Languages, Countries	The documented filters, applied only where the endpoint supports them.
Advanced filter	Raw match_all / match_any clauses as the provider documents them.
Care case IDs / Care case ID / Include internal notes	Care modes.
Maximum results	Row cap for the run.
Requests per minute	Pacing.
API token / API secret	Your own Emplifi credentials, as secret inputs.

Run the connected profiles mode first, then posts or profile metrics with the profile IDs it lists.

Credentials

Emplifi documents two ways in, and this actor takes both:

• Token and secret (Basic authorization): put the token in API token and the secret in API secret, or paste token:secret into API token alone. Emplifi support issues the pair for a user of your Emplifi suite account.
• OAuth 2.0 access token: paste the access token from your Emplifi custom integration into API token and leave the secret empty. It is sent as a Bearer token; access tokens last 30 days.

The DATA_API_KEY and DATA_API_SECRET environment secrets work instead of the inputs.

Limits on the Emplifi side

• API access is an add-on for Emplifi clients; your plan decides which modules (Listening, Community, Care, Ads) and how much history you can read.
• 1000 requests an hour per account and 500 per user, shared with your other integrations. Each content page holds up to 100 records, so 1000 posts take about 10 requests.
• Each metrics request: at most 100 profiles, 25 metrics and 12 months.
• Community data is kept for 90 days, Care messages for 24 months. Reddit is not available in Community or Care.
• Metrics starting with insights_, and all LinkedIn, Pinterest, TikTok and Snapchat metrics, need profiles with insights enabled (the connected profiles mode shows insightsEnabled).
• X (Twitter) posts return only the post ID, author ID and labels, under X's developer policy.

FAQ

What is a social media analytics API used for?

Moving the numbers out of the Emplifi dashboard into your own tools. A social team exports every post of the last quarter with reach, interactions and labels into a spreadsheet to find the formats that work. An agency pulls daily follower growth for all client profiles into a BI dashboard. A brand feeds Listening mentions with sentiment into a warehouse to join with sales data. A support lead tracks Community response times and Care case volumes per week.

Which data source does this actor read?

The Emplifi API v3 at api.emplifi.io (Emplifi was formerly Socialbakers), through the read routes documented at https://api.emplifi.io/: connected profiles, labels, Listening queries and ad accounts; profile metrics; posts for eight networks; aggregated post metrics; Community content and metrics; Listening content and metrics; and Care cases and messages. The documentation and its changelog (v3.75, 2026-09-21) were checked on 2026-10-03, and the host was probed live the same day.

Do I need an Emplifi API token?

Yes. This actor is bring-your-own-credentials and never ships any. Emplifi gives API access to its clients on request: ask Emplifi support (support@emplifi.io) or your account team for a token and secret for your user, or create a custom integration in Emplifi settings for OAuth 2.0. Missing, wrong or expired credentials, and a module your user cannot access, each end the run cleanly with a message saying which it was.

Can it read competitor profiles?

It reads every profile your Emplifi account can see. Basic metrics and posts (followers, fans, interactions, reactions, comments, shares) are public data, so profiles you track in Emplifi without owning them work; insights metrics such as reach and impressions exist only for profiles connected with insights. A profile that is not in your account is refused with "Profiles not allowed for user", and the run ends cleanly.

How do I get daily follower growth for several profiles?

Choose profile metrics, pick the network, add the profile IDs, set the metrics to fans_change and fans_lifetime (Facebook) or followers_change and followers_lifetime (Instagram, X, LinkedIn, Pinterest), and keep the default dimensions profile and date.day. Each row is one profile, one day and one metric, with the number in value.

How many posts can one run export?

Up to 100,000 rows per run. The API pages 100 posts at a time with a cursor, so a run reads until the date range is exhausted or the row cap is reached. With the hourly limit of 500 requests per user, that is about 50,000 posts an hour.

Can this actor change anything in my Emplifi account?

No. The GET routes only list; the POST routes are the read queries Emplifi defines for metrics and content. The routes that create, edit, archive, restore or delete collections and assets, and the one that labels Community content, are not used. Credentials go only in the Authorization header and are stripped from any log or error text.

How is it priced?

Pay per result: one price per post, mention, message or case, and a lower price per metric value and per account record (profile, label, query, ad account). Requests that find nothing, and metric cells with no value, are free. Your Emplifi subscription applies separately.

Example output

{
  "mode": "posts",
  "modeLabel": "Posts",
  "recordType": "post",
  "network": "facebook",
  "found": true,
  "id": "164929129743_10155892118379744",
  "name": "Example Brand",
  "date": "2026-09-25T16:06:00+00:00",
  "platform": "facebook",
  "profileId": "164929129743",
  "author": "Example Brand",
  "url": "https://www.facebook.com/164929129743/posts/10155892118379744",
  "message": "Our autumn collection is here.",
  "contentType": "post",
  "mediaType": "photo",
  "sentiment": "positive",
  "interactions": 1840,
  "comments": 96,
  "shares": 41,
  "created_time": "2026-09-25T16:06:00+00:00",
  "content": "Our autumn collection is here.",
  "content_type": "post",
  "media_type": "photo",
  "reactions": 1703,
  "post_labels": [{ "id": "5d879004a44a4cbcb13e", "name": "Campaign: Autumn" }],
  "metric": null,
  "dimension1": null,
  "dimension2": null,
  "dimension3": null,
  "value": null,
  "retrievedAt": "2026-10-03T09:14:52.118Z",
  "note": null
}

Values are illustrative; every field is one the provider documents. Metric rows carry metric, value, date, profileId, and dimension1 to dimension3 as type=value (for example profile=facebook:164929129743 and date.day=2026-09-25), plus a dimensions object.

Keyword map

social media analytics API, social media reporting API, Instagram analytics export, Facebook page insights export, TikTok analytics API, LinkedIn page analytics, YouTube channel analytics, post engagement data, follower growth data, social listening API, brand mentions export, community management data, customer care case export, competitor social benchmarking, Emplifi API, Emplifi export, Socialbakers API.