Analytics
Post and account analytics, platform-native insights and inbox analytics. Dates are UTC days (YYYY-MM-DD). History is limited by the plan (free 30 d, pro 365 d, business 730 d).
Analytics
List post analytics
/analyticsPosts (Socialit and external) with their metrics per platform, paginated, plus an overview. Defaults to the last 90 days (max 366). Dates are UTC days (YYYY-MM-DD). History is limited by the plan (free 30 d, pro 365 d, business 730 d).
Try it with MCPAsk your agent to call list-post-analytics (toolset analytics)Set up MCP
Query parameters
pageintegerdefault: 1≥ 1
limitintegerdefault: 201–100
platformstringNetwork key (x, instagram, …; aliases twitter, googlebusiness) or "all"
profile_idstringProfile id (pro_…) or "all"
account_idstringAccount id (sa_…)
1–80 characters
sourcestringall (default), socialit (published through Socialit; alias late), external (imported)
allsocialitlateexternal
from_datestringUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
tagsstringComma-separated post tags (max 20): only Socialit posts carrying every tag (exact, case-sensitive). More than 200 matching published posts in the range → 400 (narrow the dates).
≤ 2000 characters
sortstringdefault: "date"dateengagementimpressionsreachlikescommentssharessavesclicksviewsengagement_rate
orderstringdefault: "desc"ascdesc
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 17 item attributes
objectstringpost_analytics
idstringpost_idstringstatusstringsourcestringsocialitexternal
contentstring | nullprofile_idstring | nullscheduled_atstring (date-time) | nullpublished_atstring (date-time) | nullplatformstringplatform_post_urlstring | nullthumbnail_urlstring | nullFirst attached media of the post (video poster or image URL); null without media
sync_statusstringsyncedpendingpartialunavailable
calculatedbooleanmetricsobject | nullNormalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube
Show 25 child attributes
impressionsnumber | nullreachnumber | nullviewsnumber | nulllikesnumber | nullcommentsnumber | nullsharesnumber | nullsavesnumber | nullclicksnumber | nullquotesnumber | nullfollowsnumber | nullprofile_viewsnumber | nullwebsite_clicksnumber | nullwatch_time_secondsnumber | nullavg_view_duration_secondsnumber | nullavg_view_percentagenumber | nullcompletion_ratenumber | nullreplaysnumber | nullrepostsnumber | nullsendsnumber | nulloutbound_clicksnumber | nullpin_clicksnumber | nullvideo_duration_secondsnumber | nullearningsnumber | nullengagementsnumber | nullengagement_ratenumber | nullplatformsarray of objectShow 13 item attributes
objectstringposting_analytics
posting_idstringaccount_idstring | nullaccount_usernamestring | nullplatformstringstatusstringplatform_post_idstring | nullplatform_post_urlstring | nullmetricsobject | nullNormalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube
Show 25 child attributes
impressionsnumber | nullreachnumber | nullviewsnumber | nulllikesnumber | nullcommentsnumber | nullsharesnumber | nullsavesnumber | nullclicksnumber | nullquotesnumber | nullfollowsnumber | nullprofile_viewsnumber | nullwebsite_clicksnumber | nullwatch_time_secondsnumber | nullavg_view_duration_secondsnumber | nullavg_view_percentagenumber | nullcompletion_ratenumber | nullreplaysnumber | nullrepostsnumber | nullsendsnumber | nulloutbound_clicksnumber | nullpin_clicksnumber | nullvideo_duration_secondsnumber | nullearningsnumber | nullengagementsnumber | nullengagement_ratenumber | nullsync_statusstringsyncedpendingunavailable
error_codestring | nullerror_messagestring | nulllast_synced_atstring (date-time) | nulllast_synced_atstring (date-time) | nullpageintegerrequiredlimitintegerrequiredtotalinteger | nullhas_morebooleanrequirednext_page_urlstring | nullprevious_page_urlstring | nulloverviewobjectShow 5 child attributes
total_postsintegerpublished_postsintegerscheduled_postsintegerlast_synced_atstring (date-time) | nullstale_accountsintegerResponses
{
"object": "list",
"data": [
{
"object": "post_analytics",
"id": "string",
"post_id": "string",
"status": "string",
"source": "socialit",
"content": "string",
"profile_id": "string",
"scheduled_at": "2026-10-13T09:00:00.000Z",
"published_at": "2026-10-13T09:00:00.000Z",
"platform": "string",
"platform_post_url": "https://example.com",
"thumbnail_url": "https://example.com",
"sync_status": "synced",
"calculated": true,
"metrics": {
"impressions": 1.5,
"reach": 1.5,
"views": 1.5,
"likes": 1.5,
"comments": 1.5,
"shares": 1.5
},
"platforms": [
{
"object": "posting_analytics",
"posting_id": "string",
"account_id": "string",
"account_username": "string",
"platform": "string",
"status": "string"
}
],
"last_synced_at": "2026-10-13T09:00:00.000Z"
}
],
"page": 1,
"limit": 1,
"total": 1,
"has_more": true,
"next_page_url": "https://example.com",
"previous_page_url": "https://example.com",
"overview": {
"total_posts": 1,
"published_posts": 1,
"scheduled_posts": 1,
"last_synced_at": "2026-10-13T09:00:00.000Z",
"stale_accounts": 1
}
}Posts
Get analytics for one post
/analytics/posts/{postId}Accepts a post id (pst_…), a posting id (sp_…) or a platform post id. Returns 202 (same body) while a metrics sync is pending; one is queued automatically.
Try it with MCPAsk your agent to call get-post-analytics (toolset analytics)Set up MCP
Path parameters
postIdstringrequiredPost id (pst_…), posting id (sp_…) or the platform post id
1–300 characters
Returns object
objectstringpost_analytics
idstringpost_idstringstatusstringsourcestringsocialitexternal
contentstring | nullprofile_idstring | nullscheduled_atstring (date-time) | nullpublished_atstring (date-time) | nullplatformstringplatform_post_urlstring | nullthumbnail_urlstring | nullFirst attached media of the post (video poster or image URL); null without media
sync_statusstringsyncedpendingpartialunavailable
calculatedbooleanmetricsobject | nullNormalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube
Show 25 child attributes
impressionsnumber | nullreachnumber | nullviewsnumber | nulllikesnumber | nullcommentsnumber | nullsharesnumber | nullsavesnumber | nullclicksnumber | nullquotesnumber | nullfollowsnumber | nullprofile_viewsnumber | nullwebsite_clicksnumber | nullwatch_time_secondsnumber | nullavg_view_duration_secondsnumber | nullavg_view_percentagenumber | nullcompletion_ratenumber | nullreplaysnumber | nullrepostsnumber | nullsendsnumber | nulloutbound_clicksnumber | nullpin_clicksnumber | nullvideo_duration_secondsnumber | nullearningsnumber | nullengagementsnumber | nullengagement_ratenumber | nullplatformsarray of objectShow 13 item attributes
objectstringposting_analytics
posting_idstringaccount_idstring | nullaccount_usernamestring | nullplatformstringstatusstringplatform_post_idstring | nullplatform_post_urlstring | nullmetricsobject | nullNormalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube
Show 25 child attributes
impressionsnumber | nullreachnumber | nullviewsnumber | nulllikesnumber | nullcommentsnumber | nullsharesnumber | nullsavesnumber | nullclicksnumber | nullquotesnumber | nullfollowsnumber | nullprofile_viewsnumber | nullwebsite_clicksnumber | nullwatch_time_secondsnumber | nullavg_view_duration_secondsnumber | nullavg_view_percentagenumber | nullcompletion_ratenumber | nullreplaysnumber | nullrepostsnumber | nullsendsnumber | nulloutbound_clicksnumber | nullpin_clicksnumber | nullvideo_duration_secondsnumber | nullearningsnumber | nullengagementsnumber | nullengagement_ratenumber | nullsync_statusstringsyncedpendingunavailable
error_codestring | nullerror_messagestring | nulllast_synced_atstring (date-time) | nulllast_synced_atstring (date-time) | nullResponses
{
"object": "post_analytics",
"id": "string",
"post_id": "string",
"status": "string",
"source": "socialit",
"content": "string",
"profile_id": "string",
"scheduled_at": "2026-10-13T09:00:00.000Z",
"published_at": "2026-10-13T09:00:00.000Z",
"platform": "string",
"platform_post_url": "https://example.com",
"thumbnail_url": "https://example.com",
"sync_status": "synced",
"calculated": true,
"metrics": {
"impressions": 1.5,
"reach": 1.5,
"views": 1.5,
"likes": 1.5,
"comments": 1.5,
"shares": 1.5,
"saves": 1.5,
"clicks": 1.5,
"quotes": 1.5,
"follows": 1.5,
"profile_views": 1.5,
"website_clicks": 1.5,
"watch_time_seconds": 1.5,
"avg_view_duration_seconds": 1.5,
"avg_view_percentage": 1.5,
"completion_rate": 1.5,
"replays": 1.5,
"reposts": 1.5,
"sends": 1.5,
"outbound_clicks": 1.5,
"pin_clicks": 1.5,
"video_duration_seconds": 1.5,
"earnings": 1.5,
"engagements": 1.5,
"engagement_rate": 1.5
},
"platforms": [
{
"object": "posting_analytics",
"posting_id": "string",
"account_id": "string",
"account_username": "string",
"platform": "string",
"status": "string",
"platform_post_id": "string",
"platform_post_url": "https://example.com",
"metrics": {
"impressions": 1.5,
"reach": 1.5,
"views": 1.5,
"likes": 1.5,
"comments": 1.5,
"shares": 1.5
},
"sync_status": "synced",
"error_code": "string",
"error_message": "string",
"last_synced_at": "2026-10-13T09:00:00.000Z"
}
],
"last_synced_at": "2026-10-13T09:00:00.000Z"
}Sync external posts of an account now
/posts/sync-externalFetches the account's latest posts from the network (including posts published natively), imports them with their metrics and, with url or post_id, returns the matching post. Debounced per account (15 s).
Try it with MCPAsk your agent to call sync-external-posts (toolset analytics)Set up MCP
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
account_idstringrequiredAccount id (sa_…)
1–80 characters
urlstring≤ 2000 characters
post_idstringPlatform post id
≤ 300 characters
Returns object
objectstringexternal_post_sync
account_idstringsyncedobjectShow 3 child attributes
posts_foundintegerposts_syncedintegerskippedbooleanfoundboolean | nullpostobject | nullpostsarray of objectShow 10 item attributes
objectstringexternal_post
post_idstringposting_idstringaccount_idstringplatformstringplatform_post_idstringplatform_post_urlstring | nullcontentstring | nullpublished_atstring (date-time) | nullmetricsobject | nullNormalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube
Show 25 child attributes
impressionsnumber | nullreachnumber | nullviewsnumber | nulllikesnumber | nullcommentsnumber | nullsharesnumber | nullsavesnumber | nullclicksnumber | nullquotesnumber | nullfollowsnumber | nullprofile_viewsnumber | nullwebsite_clicksnumber | nullwatch_time_secondsnumber | nullavg_view_duration_secondsnumber | nullavg_view_percentagenumber | nullcompletion_ratenumber | nullreplaysnumber | nullrepostsnumber | nullsendsnumber | nulloutbound_clicksnumber | nullpin_clicksnumber | nullvideo_duration_secondsnumber | nullearningsnumber | nullengagementsnumber | nullengagement_ratenumber | nullResponses
{
"object": "external_post_sync",
"account_id": "string",
"synced": {
"posts_found": 1,
"posts_synced": 1,
"skipped": true
},
"found": true,
"post": {
"object": "external_post",
"post_id": "string",
"posting_id": "string",
"account_id": "string",
"platform": "string",
"platform_post_id": "string",
"platform_post_url": "https://example.com",
"content": "string",
"published_at": "2026-10-13T09:00:00.000Z",
"metrics": {
"impressions": 1.5,
"reach": 1.5,
"views": 1.5,
"likes": 1.5,
"comments": 1.5,
"shares": 1.5
}
},
"posts": [
{
"object": "external_post",
"post_id": "string",
"posting_id": "string",
"account_id": "string",
"platform": "string",
"platform_post_id": "string",
"platform_post_url": "https://example.com",
"content": "string",
"published_at": "2026-10-13T09:00:00.000Z",
"metrics": {
"impressions": 1.5,
"reach": 1.5,
"views": 1.5,
"likes": 1.5,
"comments": 1.5,
"shares": 1.5
}
}
]
}Delta
Analytics changed since a cursor
/analytics/deltaCursor feed of changed post metric snapshots across every account you can read (oldest first). Call without cursor first to get the current position, load your baseline from GET /analytics, then poll with next_cursor. Cursors expire after 7 days.
Try it with MCPAsk your agent to call get-analytics-delta (toolset analytics)Set up MCP
Query parameters
cursorstring≤ 200 characters
limitintegerdefault: 501–100
platformstringNetwork key (x, instagram, …; aliases twitter, googlebusiness) or "all"
profile_idstringProfile id (pro_…) or "all"
Returns object
objectstringanalytics_delta
dataarray of objectShow 12 item attributes
objectstringanalytics_change
idstringpost_idstringposting_idstringaccount_idstringprofile_idstring | nullplatformstringplatform_post_idstring | nullpublished_atstring (date-time) | nullsynced_atstring (date-time) | nullis_deletedbooleanmetricsobject | nullNormalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube
Show 25 child attributes
impressionsnumber | nullreachnumber | nullviewsnumber | nulllikesnumber | nullcommentsnumber | nullsharesnumber | nullsavesnumber | nullclicksnumber | nullquotesnumber | nullfollowsnumber | nullprofile_viewsnumber | nullwebsite_clicksnumber | nullwatch_time_secondsnumber | nullavg_view_duration_secondsnumber | nullavg_view_percentagenumber | nullcompletion_ratenumber | nullreplaysnumber | nullrepostsnumber | nullsendsnumber | nulloutbound_clicksnumber | nullpin_clicksnumber | nullvideo_duration_secondsnumber | nullearningsnumber | nullengagementsnumber | nullengagement_ratenumber | nullnext_cursorstringhas_morebooleanResponses
{
"object": "analytics_delta",
"data": [
{
"object": "analytics_change",
"id": "string",
"post_id": "string",
"posting_id": "string",
"account_id": "string",
"profile_id": "string",
"platform": "string",
"platform_post_id": "string",
"published_at": "2026-10-13T09:00:00.000Z",
"synced_at": "2026-10-13T09:00:00.000Z",
"is_deleted": true,
"metrics": {
"impressions": 1.5,
"reach": 1.5,
"views": 1.5,
"likes": 1.5,
"comments": 1.5,
"shares": 1.5
}
}
],
"next_cursor": "string",
"has_more": true
}Post timeline
Get the daily metric history of a post
/analytics/post-timelineOne row per day and platform (last snapshot of the day). Defaults to the last 90 days.
Try it with MCPAsk your agent to call get-post-timeline (toolset analytics)Set up MCP
Query parameters
post_idstringrequired1–300 characters
from_datestringUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
Returns object
objectstringpost_timeline
post_idstringfrom_datestringto_datestringtimelinearray of objectShow 6 item attributes
datestringposting_idstringaccount_idstringplatformstringplatform_post_idstring | nullmetricsobject | nullNormalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube
Show 25 child attributes
impressionsnumber | nullreachnumber | nullviewsnumber | nulllikesnumber | nullcommentsnumber | nullsharesnumber | nullsavesnumber | nullclicksnumber | nullquotesnumber | nullfollowsnumber | nullprofile_viewsnumber | nullwebsite_clicksnumber | nullwatch_time_secondsnumber | nullavg_view_duration_secondsnumber | nullavg_view_percentagenumber | nullcompletion_ratenumber | nullreplaysnumber | nullrepostsnumber | nullsendsnumber | nulloutbound_clicksnumber | nullpin_clicksnumber | nullvideo_duration_secondsnumber | nullearningsnumber | nullengagementsnumber | nullengagement_ratenumber | nullResponses
{
"object": "post_timeline",
"post_id": "string",
"from_date": "string",
"to_date": "string",
"timeline": [
{
"date": "string",
"posting_id": "string",
"account_id": "string",
"platform": "string",
"platform_post_id": "string",
"metrics": {
"impressions": 1.5,
"reach": 1.5,
"views": 1.5,
"likes": 1.5,
"comments": 1.5,
"shares": 1.5
}
}
]
}Dashboard
Get an analytics dashboard
/analytics/dashboardTotals, follower growth, a daily series, top and recent posts in one call. Daily and total metrics use received attribution. Cross-network totals are Socialit-calculated (calculated: true) and come with a per-platform breakdown; YouTube numbers are never folded into derived rates. Pinterest analytics are never stored and are absent from stored aggregates.
Try it with MCPAsk your agent to call get-analytics-dashboard (toolset analytics)Set up MCP
Query parameters
platformstringNetwork key (x, instagram, …; aliases twitter, googlebusiness) or "all"
profile_idstringProfile id (pro_…) or "all"
account_idstringAccount id (sa_…)
1–80 characters
from_datestringrequiredUTC day (YYYY-MM-DD)
to_datestringrequiredUTC day (YYYY-MM-DD)
comparestringprevious_period
top_postsintegerdefault: 50–25
recent_postsintegerdefault: 100–25
Returns object
objectstringanalytics_dashboard
date_rangeobjectShow 2 child attributes
from_datestringto_datestringcalculatedbooleantotalsobject | nullShow 10 child attributes
impressionsnumber | nullreachnumber | nulllikesnumber | nullcommentsnumber | nullsharesnumber | nullsavesnumber | nullclicksnumber | nullviewsnumber | nullengagementnumber | nullengagement_ratenumber | nullprevious_totalsobject | nullShow 10 child attributes
impressionsnumber | nullreachnumber | nulllikesnumber | nullcommentsnumber | nullsharesnumber | nullsavesnumber | nullclicksnumber | nullviewsnumber | nullengagementnumber | nullengagement_ratenumber | nullfollowersobject | nullShow 3 child attributes
currentnumber | nullgainednumber | nullby_accountarray of objectShow 4 item attributes
account_idstringplatformstringcurrentnumber | nullgainednumber | nullprevious_followersobject | nullShow 3 child attributes
currentnumber | nullgainednumber | nullby_accountarray of objectShow 4 item attributes
account_idstringplatformstringcurrentnumber | nullgainednumber | nulldailyarray of objectShow 6 item attributes
datestringimpressionsnumber | nullreachnumber | nullengagementnumber | nullviewsnumber | nullfollowers_gainednumber | nullplatform_breakdownarray of objectShow 12 item attributes
platformstringpostsnumber | nullimpressionsnumber | nullreachnumber | nulllikesnumber | nullcommentsnumber | nullsharesnumber | nullsavesnumber | nullclicksnumber | nullviewsnumber | nullengagementnumber | nullfollowersnumber | nulltop_postsarray of objectShow 9 item attributes
post_idstringposting_idstringaccount_idstringplatformstringcontentstring | nullplatform_post_urlstring | nullthumbnail_urlstring | nullpublished_atstring (date-time) | nullmetricsobjectShow 9 child attributes
impressionsnumber | nullreachnumber | nulllikesnumber | nullcommentsnumber | nullsharesnumber | nullsavesnumber | nullclicksnumber | nullviewsnumber | nullengagement_ratenumber | nullrecent_postsarray of objectShow 9 item attributes
post_idstringposting_idstringaccount_idstringplatformstringcontentstring | nullplatform_post_urlstring | nullthumbnail_urlstring | nullpublished_atstring (date-time) | nullmetricsobjectShow 9 child attributes
impressionsnumber | nullreachnumber | nulllikesnumber | nullcommentsnumber | nullsharesnumber | nullsavesnumber | nullclicksnumber | nullviewsnumber | nullengagement_ratenumber | nulldata_as_ofstring (date-time) | nullResponses
{
"object": "analytics_dashboard",
"date_range": {
"from_date": "string",
"to_date": "string"
},
"calculated": true,
"totals": {
"impressions": 1.5,
"reach": 1.5,
"likes": 1.5,
"comments": 1.5,
"shares": 1.5,
"saves": 1.5,
"clicks": 1.5,
"views": 1.5,
"engagement": 1.5,
"engagement_rate": 1.5
},
"previous_totals": {
"impressions": 1.5,
"reach": 1.5,
"likes": 1.5,
"comments": 1.5,
"shares": 1.5,
"saves": 1.5,
"clicks": 1.5,
"views": 1.5,
"engagement": 1.5,
"engagement_rate": 1.5
},
"followers": {
"current": 1.5,
"gained": 1.5,
"by_account": [
{
"account_id": "string",
"platform": "string",
"current": 1.5,
"gained": 1.5
}
]
},
"previous_followers": {
"current": 1.5,
"gained": 1.5,
"by_account": [
{
"account_id": "string",
"platform": "string",
"current": 1.5,
"gained": 1.5
}
]
},
"daily": [
{
"date": "string",
"impressions": 1.5,
"reach": 1.5,
"engagement": 1.5,
"views": 1.5,
"followers_gained": 1.5
}
],
"platform_breakdown": [
{
"platform": "string",
"posts": 1.5,
"impressions": 1.5,
"reach": 1.5,
"likes": 1.5,
"comments": 1.5,
"shares": 1.5,
"saves": 1.5,
"clicks": 1.5,
"views": 1.5,
"engagement": 1.5,
"followers": 1.5
}
],
"top_posts": [
{
"post_id": "string",
"posting_id": "string",
"account_id": "string",
"platform": "string",
"content": "string",
"platform_post_url": "https://example.com",
"thumbnail_url": "https://example.com",
"published_at": "2026-10-13T09:00:00.000Z",
"metrics": {
"impressions": 1.5,
"reach": 1.5,
"likes": 1.5,
"comments": 1.5,
"shares": 1.5,
"saves": 1.5
}
}
],
"recent_posts": [
{
"post_id": "string",
"posting_id": "string",
"account_id": "string",
"platform": "string",
"content": "string",
"platform_post_url": "https://example.com",
"thumbnail_url": "https://example.com",
"published_at": "2026-10-13T09:00:00.000Z",
"metrics": {
"impressions": 1.5,
"reach": 1.5,
"likes": 1.5,
"comments": 1.5,
"shares": 1.5,
"saves": 1.5
}
}
],
"data_as_of": "2026-10-13T09:00:00.000Z"
}Daily metrics
Get daily aggregated metrics
/analytics/daily-metricsPer-day post counts and summed metrics plus a platform breakdown. Defaults to the last 180 days. Cross-network totals are Socialit-calculated (calculated: true) and come with a per-platform breakdown; YouTube numbers are never folded into derived rates. Pinterest analytics are never stored and are absent from stored aggregates.
Try it with MCPAsk your agent to call get-daily-metrics (toolset analytics)Set up MCP
Query parameters
platformstringNetwork key (x, instagram, …; aliases twitter, googlebusiness) or "all"
profile_idstringProfile id (pro_…) or "all"
account_idstringAccount id (sa_…)
1–80 characters
from_datestringUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
sourcestringall (default), socialit (published through Socialit; alias late), external (imported)
allsocialitlateexternal
attributionstringdefault: "publish"publishreceived
Returns object
objectstringdaily_metrics
from_datestringto_datestringattributionstringpublishreceived
calculatedbooleandailyarray of objectShow 4 item attributes
datestringpost_countintegerplatformsmap of numbermetricsobjectShow 8 child attributes
impressionsnumber | nullreachnumber | nulllikesnumber | nullcommentsnumber | nullsharesnumber | nullsavesnumber | nullclicksnumber | nullviewsnumber | nullplatform_breakdownarray of objectShow 10 item attributes
platformstringpost_countintegerimpressionsnumber | nullreachnumber | nulllikesnumber | nullcommentsnumber | nullsharesnumber | nullsavesnumber | nullclicksnumber | nullviewsnumber | nullResponses
{
"object": "daily_metrics",
"from_date": "string",
"to_date": "string",
"attribution": "publish",
"calculated": true,
"daily": [
{
"date": "string",
"post_count": 1,
"platforms": {},
"metrics": {
"impressions": 1.5,
"reach": 1.5,
"likes": 1.5,
"comments": 1.5,
"shares": 1.5,
"saves": 1.5
}
}
],
"platform_breakdown": [
{
"platform": "string",
"post_count": 1,
"impressions": 1.5,
"reach": 1.5,
"likes": 1.5,
"comments": 1.5,
"shares": 1.5,
"saves": 1.5,
"clicks": 1.5,
"views": 1.5
}
]
}Best time
Get the best times to post
/analytics/best-timeAverage engagement of published posts by UTC weekday (0 = Sunday) and hour, best slots first.
Try it with MCPAsk your agent to call get-best-time-to-post (toolset analytics)Set up MCP
Query parameters
platformstringNetwork key (x, instagram, …; aliases twitter, googlebusiness) or "all"
profile_idstringProfile id (pro_…) or "all"
account_idstringAccount id (sa_…)
1–80 characters
from_datestringUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
sourcestringall (default), socialit (published through Socialit; alias late), external (imported)
allsocialitlateexternal
Returns object
objectstringbest_time
timezonestringslotsarray of objectShow 4 item attributes
day_of_weekintegerhourintegeravg_engagementnumber | nullpost_countintegerResponses
{
"object": "best_time",
"timezone": "Europe/Prague",
"slots": [
{
"day_of_week": 1,
"hour": 1,
"avg_engagement": 1.5,
"post_count": 1
}
]
}Content decay
Get content performance decay
/analytics/content-decayAverage share of a post's final engagement reached 1h, 6h, 24h, 3d, 7d and 30d after publishing.
Try it with MCPAsk your agent to call get-content-decay (toolset analytics)Set up MCP
Query parameters
platformstringNetwork key (x, instagram, …; aliases twitter, googlebusiness) or "all"
profile_idstringProfile id (pro_…) or "all"
account_idstringAccount id (sa_…)
1–80 characters
from_datestringUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
sourcestringall (default), socialit (published through Socialit; alias late), external (imported)
allsocialitlateexternal
Returns object
objectstringcontent_decay
bucketsarray of objectShow 4 item attributes
bucket_orderintegerbucket_labelstringavg_pct_of_finalnumber | nullpost_countintegerResponses
{
"object": "content_decay",
"buckets": [
{
"bucket_order": 1,
"bucket_label": "string",
"avg_pct_of_final": 1.5,
"post_count": 1
}
]
}Posting frequency
Get posting frequency vs engagement
/analytics/posting-frequencyAverage engagement rate and engagement per platform for each observed posts-per-week cadence.
Try it with MCPAsk your agent to call get-posting-frequency (toolset analytics)Set up MCP
Query parameters
platformstringNetwork key (x, instagram, …; aliases twitter, googlebusiness) or "all"
profile_idstringProfile id (pro_…) or "all"
account_idstringAccount id (sa_…)
1–80 characters
from_datestringUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
sourcestringall (default), socialit (published through Socialit; alias late), external (imported)
allsocialitlateexternal
Returns object
objectstringposting_frequency
frequencyarray of objectShow 5 item attributes
platformstringposts_per_weekintegeravg_engagement_ratenumber | nullavg_engagementnumber | nullweeks_countintegerResponses
{
"object": "posting_frequency",
"frequency": [
{
"platform": "string",
"posts_per_week": 1,
"avg_engagement_rate": 1.5,
"avg_engagement": 1.5,
"weeks_count": 1
}
]
}Accounts
Get stored analytics of an account
/analytics/accounts/{accountId}Daily follower snapshots and normalized daily insights collected by the analytics sync (Pinterest: live, cached for an hour).
Try it with MCPAsk your agent to call get-account-analytics (toolset analytics)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Query parameters
from_datestringUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
Returns object
objectstringaccount_analytics
account_idstringplatformstringusernamestring | nulldate_rangeobjectShow 2 child attributes
from_datestringto_datestringcurrentobject | nullShow 4 child attributes
followersinteger | nullfollowinginteger | nullposts_countinteger | nulldatestring | nullUTC day (YYYY-MM-DD)
snapshotsarray of objectShow 4 item attributes
datestringfollowersinteger | nullfollowinginteger | nullposts_countinteger | nullinsightsarray of objectShow 2 item attributes
datestringmetricsmap of numbertotalsmap of numberlast_synced_atstring (date-time) | nullcachedbooleanResponses
{
"object": "account_analytics",
"account_id": "string",
"platform": "string",
"username": "string",
"date_range": {
"from_date": "string",
"to_date": "string"
},
"current": {
"followers": 1,
"following": 1,
"posts_count": 1,
"date": "string"
},
"snapshots": [
{
"date": "string",
"followers": 1,
"following": 1,
"posts_count": 1
}
],
"insights": [
{
"date": "string",
"metrics": {}
}
],
"totals": {
"key": 1.5
},
"last_synced_at": "2026-10-13T09:00:00.000Z",
"cached": true
}Demographics
Get audience demographics of an account
/analytics/accounts/{accountId}/demographicsLive audience demographics from the network (age, gender, country, city, locale where available).
Try it with MCPAsk your agent to call get-account-demographics (toolset analytics)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Query parameters
from_datestringUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
Returns object
objectstringdemographics
account_idstringplatformstringmetricstring | nulltimeframestring | nullvideo_idstring | nulltitlestring | nullpublished_atstring (date-time) | nullsnapshot_datestring | nullUTC day (YYYY-MM-DD)
date_rangeobject | nullShow 2 child attributes
sincestring | nullUTC day (YYYY-MM-DD)
untilstring | nullUTC day (YYYY-MM-DD)
demographicsmap of array of objectnotestring | nullResponses
{
"object": "demographics",
"account_id": "string",
"platform": "string",
"metric": "string",
"timeframe": "string",
"video_id": "string",
"title": "string",
"published_at": "2026-10-13T09:00:00.000Z",
"snapshot_date": "string",
"date_range": {
"since": "string",
"until": "string"
},
"demographics": {
"key": [
{
"dimension": "string",
"value": 1.5
}
]
},
"note": "string"
}Reports
Run a network analytics report
/analytics/accounts/{accountId}/reports/{report}Live network-specific report (e.g. YouTube traffic sources, Pinterest top pins, Threads benchmarks). Extra query parameters are passed to the report.
Try it with MCPAsk your agent to call get-account-report (toolset analytics)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
reportstringrequired1–80 characters
Query parameters
from_datestringUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
Returns object
objectstringplatform_report
account_idstringplatformstringreportstringdataobject | nullProvider report as returned (arrays are wrapped as { rows })
Responses
{
"object": "platform_report",
"account_id": "string",
"platform": "string",
"report": "string",
"data": {}
}Sync
Queue an analytics sync for an account
/analytics/accounts/{accountId}/syncRefreshes stats, insights and post metrics in the background (202). analytics.synced fires when it completes.
Try it with MCPAsk your agent to call sync-account-analytics (toolset analytics)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object | null
scopearray of string≥ 1 items · unique
Returns object
objectstringanalytics_sync
account_idstringstatusstringqueued
scopearray of stringqueued_atstring (date-time) | nullResponses
{
"object": "analytics_sync",
"account_id": "string",
"status": "queued",
"scope": [
"string"
],
"queued_at": "2026-10-13T09:00:00.000Z"
}YouTube
Get YouTube channel insights
/analytics/youtube/channel-insightsChannel metrics from YouTube Analytics (2-3 day delay, max 89 days). Requires the yt-analytics.readonly scope.
Try it with MCPAsk your agent to call get-youtube-channel-insights (toolset analytics)Set up MCP
Query parameters
account_idstringrequiredAccount id (sa_…)
1–80 characters
metricsstringComma-separated metric names (network vocabulary)
from_datestringUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
metric_typestringdefault: "total_value"total_valuetime_series
Returns object
objectstringaccount_insights
account_idstringplatformstringdate_rangeobjectShow 2 child attributes
sincestring | nullUTC day (YYYY-MM-DD)
untilstring | nullUTC day (YYYY-MM-DD)
metric_typestringtotal_valuetime_series
breakdownstring | nullmetricsmap of objectunavailable_metricsarray of objectShow 3 item attributes
metricstringreasonstringmessagestring | nulldata_delaystring | nullResponses
{
"object": "account_insights",
"account_id": "string",
"platform": "string",
"date_range": {
"since": "string",
"until": "string"
},
"metric_type": "total_value",
"breakdown": "string",
"metrics": {
"key": {
"total": 1.5,
"values": [
{
"date": "string",
"value": 1.5
}
],
"breakdowns": [
{
"dimension": "string",
"value": 1.5
}
],
"unit": "string",
"currency": "USD"
}
},
"unavailable_metrics": [
{
"metric": "string",
"reason": "string",
"message": "string"
}
],
"data_delay": "string"
}Get YouTube daily views of a video
/analytics/youtube/daily-viewsDaily views, watch time and subscriber changes of one video (max 90 days; default ends 3 days ago).
Try it with MCPAsk your agent to call get-youtube-daily-views (toolset analytics)Set up MCP
Query parameters
account_idstringrequiredAccount id (sa_…)
1–80 characters
video_idstringrequired1–64 characters
from_datestringUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
Returns object
objectstringyoutube_daily_views
account_idstringvideo_idstringtitlestring | nullduration_secondsinteger | nulldate_rangeobjectShow 2 child attributes
sincestring | nullUTC day (YYYY-MM-DD)
untilstring | nullUTC day (YYYY-MM-DD)
provisional_sincestring | nullUTC day (YYYY-MM-DD)
total_viewsnumber | nulldaily_viewsarray of objectShow 10 item attributes
datestringviewsnumber | nullestimated_minutes_watchednumber | nullaverage_view_durationnumber | nullaverage_view_percentagenumber | nullsubscribers_gainednumber | nullsubscribers_lostnumber | nulllikesnumber | nullcommentsnumber | nullsharesnumber | nulllast_synced_atstring (date-time) | nullResponses
{
"object": "youtube_daily_views",
"account_id": "string",
"video_id": "string",
"title": "string",
"duration_seconds": 1,
"date_range": {
"since": "string",
"until": "string"
},
"provisional_since": "string",
"total_views": 1.5,
"daily_views": [
{
"date": "string",
"views": 1.5,
"estimated_minutes_watched": 1.5,
"average_view_duration": 1.5,
"average_view_percentage": 1.5,
"subscribers_gained": 1.5,
"subscribers_lost": 1.5,
"likes": 1.5,
"comments": 1.5,
"shares": 1.5
}
],
"last_synced_at": "2026-10-13T09:00:00.000Z"
}Get the YouTube audience retention curve of a video
/analytics/youtube/video-retentionTry it with MCPAsk your agent to call get-youtube-video-retention (toolset analytics)Set up MCP
Query parameters
account_idstringrequiredAccount id (sa_…)
1–80 characters
video_idstringrequired1–64 characters
from_datestringUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
Returns object
objectstringyoutube_video_retention
account_idstringvideo_idstringtitlestring | nullpublished_atstring (date-time) | nullduration_secondsinteger | nulldate_rangeobjectShow 2 child attributes
sincestring | nullUTC day (YYYY-MM-DD)
untilstring | nullUTC day (YYYY-MM-DD)
provisional_sincestring | nullUTC day (YYYY-MM-DD)
retention_curvearray of objectShow 6 item attributes
elapsed_video_time_rationumber | nullaudience_watch_rationumber | nullrelative_retention_performancenumber | nullstarted_watchingnumber | nullstopped_watchingnumber | nulltotal_segment_impressionsnumber | nullnotestring | nullResponses
{
"object": "youtube_video_retention",
"account_id": "string",
"video_id": "string",
"title": "string",
"published_at": "2026-10-13T09:00:00.000Z",
"duration_seconds": 1,
"date_range": {
"since": "string",
"until": "string"
},
"provisional_since": "string",
"retention_curve": [
{
"elapsed_video_time_ratio": 1.5,
"audience_watch_ratio": 1.5,
"relative_retention_performance": 1.5,
"started_watching": 1.5,
"stopped_watching": 1.5,
"total_segment_impressions": 1.5
}
],
"note": "string"
}Get YouTube audience demographics
/analytics/youtube/demographicsAge and gender are viewer percentages; country values are views. Channel-wide or one video with video_id.
Try it with MCPAsk your agent to call get-youtube-demographics (toolset analytics)Set up MCP
Query parameters
account_idstringrequiredAccount id (sa_…)
1–80 characters
video_idstring≤ 64 characters
breakdownstringage,gender,country
from_datestringUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
Returns object
objectstringdemographics
account_idstringplatformstringmetricstring | nulltimeframestring | nullvideo_idstring | nulltitlestring | nullpublished_atstring (date-time) | nullsnapshot_datestring | nullUTC day (YYYY-MM-DD)
date_rangeobject | nullShow 2 child attributes
sincestring | nullUTC day (YYYY-MM-DD)
untilstring | nullUTC day (YYYY-MM-DD)
demographicsmap of array of objectnotestring | nullResponses
{
"object": "demographics",
"account_id": "string",
"platform": "string",
"metric": "string",
"timeframe": "string",
"video_id": "string",
"title": "string",
"published_at": "2026-10-13T09:00:00.000Z",
"snapshot_date": "string",
"date_range": {
"since": "string",
"until": "string"
},
"demographics": {
"key": [
{
"dimension": "string",
"value": 1.5
}
]
},
"note": "string"
}Get LinkedIn organization analytics
/analytics/linkedin/org-aggregate-analyticsShare, follower and page statistics of a LinkedIn organization page (max 89 days).
Try it with MCPAsk your agent to call get-linkedin-org-analytics (toolset analytics)Set up MCP
Query parameters
account_idstringrequiredAccount id (sa_…)
1–80 characters
metricsstringComma-separated metric names (network vocabulary)
from_datestringUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
metric_typestringdefault: "total_value"total_valuetime_series
Returns object
objectstringaccount_insights
account_idstringplatformstringdate_rangeobjectShow 2 child attributes
sincestring | nullUTC day (YYYY-MM-DD)
untilstring | nullUTC day (YYYY-MM-DD)
metric_typestringtotal_valuetime_series
breakdownstring | nullmetricsmap of objectunavailable_metricsarray of objectShow 3 item attributes
metricstringreasonstringmessagestring | nulldata_delaystring | nullResponses
{
"object": "account_insights",
"account_id": "string",
"platform": "string",
"date_range": {
"since": "string",
"until": "string"
},
"metric_type": "total_value",
"breakdown": "string",
"metrics": {
"key": {
"total": 1.5,
"values": [
{
"date": "string",
"value": 1.5
}
],
"breakdowns": [
{
"dimension": "string",
"value": 1.5
}
],
"unit": "string",
"currency": "USD"
}
},
"unavailable_metrics": [
{
"metric": "string",
"reason": "string",
"message": "string"
}
],
"data_delay": "string"
}Get LinkedIn personal account aggregate stats
/accounts/{accountId}/linkedin/aggregate-analyticsTotals or daily series across the member's posts (posts published through Socialit; LinkedIn API limitation).
Try it with MCPAsk your agent to call get-linkedin-aggregate-analytics (toolset analytics)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Query parameters
aggregationstringdefault: "TOTAL"TOTALDAILY
from_datestringUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
metricsstringIMPRESSION,MEMBERS_REACHED,REACTION,COMMENT,RESHARE,POST_SAVE,POST_SEND
Returns object
objectstringlinkedin_aggregate_analytics
account_idstringplatformstringaccount_typestringusernamestring | nullaggregationstringTOTALDAILY
date_rangeobjectShow 2 child attributes
sincestring | nullUTC day (YYYY-MM-DD)
untilstring | nullUTC day (YYYY-MM-DD)
analyticsmap of number | array of object | nullTOTAL: numbers per metric; DAILY: [{ date, count }] per metric
skipped_metricsarray of stringnotestring | nulllast_updatedstring (date-time) | nullResponses
{
"object": "linkedin_aggregate_analytics",
"account_id": "string",
"platform": "string",
"account_type": "string",
"username": "string",
"aggregation": "TOTAL",
"date_range": {
"since": "string",
"until": "string"
},
"analytics": {
"key": 1.5
},
"skipped_metrics": [
"string"
],
"note": "string",
"last_updated": "2026-10-13T09:00:00.000Z"
}Get LinkedIn post stats
/accounts/{accountId}/linkedin/post-analyticsTry it with MCPAsk your agent to call get-linkedin-post-analytics (toolset analytics)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Query parameters
urnstringrequired1–300 characters
Returns object
objectstringlinkedin_post_analytics
account_idstringplatformstringaccount_typestringusernamestring | nullpost_urnstringanalyticsobjectShow 10 child attributes
impressionsnumber | nullreachnumber | nulllikesnumber | nullcommentsnumber | nullsharesnumber | nullsavesnumber | nullsendsnumber | nullclicksnumber | nullviewsnumber | nullengagement_ratenumber | nulllast_updatedstring (date-time) | nullResponses
{
"object": "linkedin_post_analytics",
"account_id": "string",
"platform": "string",
"account_type": "string",
"username": "string",
"post_urn": "string",
"analytics": {
"impressions": 1.5,
"reach": 1.5,
"likes": 1.5,
"comments": 1.5,
"shares": 1.5,
"saves": 1.5,
"sends": 1.5,
"clicks": 1.5,
"views": 1.5,
"engagement_rate": 1.5
},
"last_updated": "2026-10-13T09:00:00.000Z"
}Get LinkedIn post reactions
/accounts/{accountId}/linkedin/post-reactionsIndividual reactions on an organization post (offset cursor).
Try it with MCPAsk your agent to call get-linkedin-post-reactions (toolset analytics)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Query parameters
urnstringrequired1–300 characters
limitintegerdefault: 251–100
cursorintegerdefault: 0Returns object
objectstringlinkedin_post_reactions
account_idstringpost_urnstringdataarray of objectShow 4 item attributes
reaction_typestring | nullreaction_labelstring | nullreacted_atstring (date-time) | nullfromobjectShow 6 child attributes
urnstring | nullnamestring | nullheadlinestring | nullusernamestring | nullprofile_picturestring | nullprofile_urlstring | nullhas_morebooleannext_cursorstring | nulltotalinteger | nulllast_updatedstring (date-time) | nullResponses
{
"object": "linkedin_post_reactions",
"account_id": "string",
"post_urn": "string",
"data": [
{
"reaction_type": "string",
"reaction_label": "string",
"reacted_at": "2026-10-13T09:00:00.000Z",
"from": {
"urn": "string",
"name": "string",
"headline": "string",
"username": "string",
"profile_picture": "string",
"profile_url": "https://example.com"
}
}
],
"has_more": true,
"next_cursor": "string",
"total": 1,
"last_updated": "2026-10-13T09:00:00.000Z"
}TikTok
Get TikTok account insights
/analytics/tiktok/account-insightsLive counters plus daily history joined from Socialit snapshots (max 89 days).
Try it with MCPAsk your agent to call get-tiktok-account-insights (toolset analytics)Set up MCP
Query parameters
account_idstringrequiredAccount id (sa_…)
1–80 characters
metricsstringComma-separated metric names (network vocabulary)
from_datestringUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
metric_typestringdefault: "total_value"total_valuetime_series
Returns object
objectstringaccount_insights
account_idstringplatformstringdate_rangeobjectShow 2 child attributes
sincestring | nullUTC day (YYYY-MM-DD)
untilstring | nullUTC day (YYYY-MM-DD)
metric_typestringtotal_valuetime_series
breakdownstring | nullmetricsmap of objectunavailable_metricsarray of objectShow 3 item attributes
metricstringreasonstringmessagestring | nulldata_delaystring | nullResponses
{
"object": "account_insights",
"account_id": "string",
"platform": "string",
"date_range": {
"since": "string",
"until": "string"
},
"metric_type": "total_value",
"breakdown": "string",
"metrics": {
"key": {
"total": 1.5,
"values": [
{
"date": "string",
"value": 1.5
}
],
"breakdowns": [
{
"dimension": "string",
"value": 1.5
}
],
"unit": "string",
"currency": "USD"
}
},
"unavailable_metrics": [
{
"metric": "string",
"reason": "string",
"message": "string"
}
],
"data_delay": "string"
}Get Facebook Page insights
/analytics/facebook/page-insightsCurrent (post-November 2025) Page metrics; followers_gained / followers_lost are synthesized from daily follows/unfollows (max 89 days).
Try it with MCPAsk your agent to call get-facebook-page-insights (toolset analytics)Set up MCP
Query parameters
account_idstringrequiredAccount id (sa_…)
1–80 characters
metricsstringComma-separated metric names (network vocabulary)
from_datestringUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
metric_typestringdefault: "total_value"total_valuetime_series
Returns object
objectstringaccount_insights
account_idstringplatformstringdate_rangeobjectShow 2 child attributes
sincestring | nullUTC day (YYYY-MM-DD)
untilstring | nullUTC day (YYYY-MM-DD)
metric_typestringtotal_valuetime_series
breakdownstring | nullmetricsmap of objectunavailable_metricsarray of objectShow 3 item attributes
metricstringreasonstringmessagestring | nulldata_delaystring | nullResponses
{
"object": "account_insights",
"account_id": "string",
"platform": "string",
"date_range": {
"since": "string",
"until": "string"
},
"metric_type": "total_value",
"breakdown": "string",
"metrics": {
"key": {
"total": 1.5,
"values": [
{
"date": "string",
"value": 1.5
}
],
"breakdowns": [
{
"dimension": "string",
"value": 1.5
}
],
"unit": "string",
"currency": "USD"
}
},
"unavailable_metrics": [
{
"metric": "string",
"reason": "string",
"message": "string"
}
],
"data_delay": "string"
}Get lifetime monetization earnings of a Facebook post
/analytics/facebook/post-earningsLifetime (cumulative) values in the platform's raw unit; never sum across posts or dates.
Try it with MCPAsk your agent to call get-facebook-post-earnings (toolset analytics)Set up MCP
Query parameters
account_idstringrequiredAccount id (sa_…)
1–80 characters
post_idstringrequired1–200 characters
metricsstringComma-separated metric names (network vocabulary)
Returns object
objectstringpost_earnings
account_idstringplatformstringpost_idstringperiodstringlifetime
metricsmap of objectunavailable_metricsarray of objectShow 3 item attributes
metricstringreasonstringmessagestring | nulldata_delaystring | nullResponses
{
"object": "post_earnings",
"account_id": "string",
"platform": "string",
"post_id": "string",
"period": "lifetime",
"metrics": {
"key": {
"total": 1.5,
"unit": "string",
"currency": "USD"
}
},
"unavailable_metrics": [
{
"metric": "string",
"reason": "string",
"message": "string"
}
],
"data_delay": "string"
}Get Facebook Page follower demographics
/analytics/facebook/demographicsFollowers by country and city (Meta removed age and gender for Pages in November 2025).
Try it with MCPAsk your agent to call get-facebook-demographics (toolset analytics)Set up MCP
Query parameters
account_idstringrequiredAccount id (sa_…)
1–80 characters
breakdownstringcountry,city
Returns object
objectstringdemographics
account_idstringplatformstringmetricstring | nulltimeframestring | nullvideo_idstring | nulltitlestring | nullpublished_atstring (date-time) | nullsnapshot_datestring | nullUTC day (YYYY-MM-DD)
date_rangeobject | nullShow 2 child attributes
sincestring | nullUTC day (YYYY-MM-DD)
untilstring | nullUTC day (YYYY-MM-DD)
demographicsmap of array of objectnotestring | nullResponses
{
"object": "demographics",
"account_id": "string",
"platform": "string",
"metric": "string",
"timeframe": "string",
"video_id": "string",
"title": "string",
"published_at": "2026-10-13T09:00:00.000Z",
"snapshot_date": "string",
"date_range": {
"since": "string",
"until": "string"
},
"demographics": {
"key": [
{
"dimension": "string",
"value": 1.5
}
]
},
"note": "string"
}Get the reaction breakdown of a Facebook post
/accounts/{accountId}/facebook/post-reactionsTry it with MCPAsk your agent to call get-facebook-post-reactions (toolset analytics)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Query parameters
post_idstringrequired1–200 characters
Returns object
objectstringfacebook_post_reactions
account_idstringplatformstringusernamestring | nullpost_idstringtotalnumber | nullbreakdownobjectShow 7 child attributes
likenumber | nulllovenumber | nullhahanumber | nullwownumber | nullsadnumber | nullangrynumber | nullcarenumber | nulllast_updatedstring (date-time) | nullResponses
{
"object": "facebook_post_reactions",
"account_id": "string",
"platform": "string",
"username": "string",
"post_id": "string",
"total": 1.5,
"breakdown": {
"like": 1.5,
"love": 1.5,
"haha": 1.5,
"wow": 1.5,
"sad": 1.5,
"angry": 1.5,
"care": 1.5
},
"last_updated": "2026-10-13T09:00:00.000Z"
}Get Instagram account insights
/analytics/instagram/account-insightsOnly reach supports metric_type=time_series (Instagram API limitation). Breakdowns need metric_type=total_value.
Try it with MCPAsk your agent to call get-instagram-account-insights (toolset analytics)Set up MCP
Query parameters
account_idstringrequiredAccount id (sa_…)
1–80 characters
metricsstringComma-separated metric names (network vocabulary)
from_datestringUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
metric_typestringdefault: "total_value"total_valuetime_series
breakdownstringmedia_product_typefollow_typefollower_typecontact_button_type
Returns object
objectstringaccount_insights
account_idstringplatformstringdate_rangeobjectShow 2 child attributes
sincestring | nullUTC day (YYYY-MM-DD)
untilstring | nullUTC day (YYYY-MM-DD)
metric_typestringtotal_valuetime_series
breakdownstring | nullmetricsmap of objectunavailable_metricsarray of objectShow 3 item attributes
metricstringreasonstringmessagestring | nulldata_delaystring | nullResponses
{
"object": "account_insights",
"account_id": "string",
"platform": "string",
"date_range": {
"since": "string",
"until": "string"
},
"metric_type": "total_value",
"breakdown": "string",
"metrics": {
"key": {
"total": 1.5,
"values": [
{
"date": "string",
"value": 1.5
}
],
"breakdowns": [
{
"dimension": "string",
"value": 1.5
}
],
"unit": "string",
"currency": "USD"
}
},
"unavailable_metrics": [
{
"metric": "string",
"reason": "string",
"message": "string"
}
],
"data_delay": "string"
}Get Instagram follower history
/analytics/instagram/follower-historyDaily follower count from Socialit snapshots joined with Instagram's new-follower series (max 89 days).
Try it with MCPAsk your agent to call get-instagram-follower-history (toolset analytics)Set up MCP
Query parameters
account_idstringrequiredAccount id (sa_…)
1–80 characters
metricsstringComma-separated metric names (network vocabulary)
from_datestringUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
metric_typestringdefault: "total_value"total_valuetime_series
Returns object
objectstringaccount_insights
account_idstringplatformstringdate_rangeobjectShow 2 child attributes
sincestring | nullUTC day (YYYY-MM-DD)
untilstring | nullUTC day (YYYY-MM-DD)
metric_typestringtotal_valuetime_series
breakdownstring | nullmetricsmap of objectunavailable_metricsarray of objectShow 3 item attributes
metricstringreasonstringmessagestring | nulldata_delaystring | nullResponses
{
"object": "account_insights",
"account_id": "string",
"platform": "string",
"date_range": {
"since": "string",
"until": "string"
},
"metric_type": "total_value",
"breakdown": "string",
"metrics": {
"key": {
"total": 1.5,
"values": [
{
"date": "string",
"value": 1.5
}
],
"breakdowns": [
{
"dimension": "string",
"value": 1.5
}
],
"unit": "string",
"currency": "USD"
}
},
"unavailable_metrics": [
{
"metric": "string",
"reason": "string",
"message": "string"
}
],
"data_delay": "string"
}Get Instagram audience demographics
/analytics/instagram/demographicsTop 45 entries per dimension; requires at least 100 followers.
Try it with MCPAsk your agent to call get-instagram-demographics (toolset analytics)Set up MCP
Query parameters
account_idstringrequiredAccount id (sa_…)
1–80 characters
metricstringdefault: "follower_demographics"follower_demographicsengaged_audience_demographics
breakdownstringage,city,country,gender
timeframestringdefault: "this_month"this_weekthis_month
Returns object
objectstringdemographics
account_idstringplatformstringmetricstring | nulltimeframestring | nullvideo_idstring | nulltitlestring | nullpublished_atstring (date-time) | nullsnapshot_datestring | nullUTC day (YYYY-MM-DD)
date_rangeobject | nullShow 2 child attributes
sincestring | nullUTC day (YYYY-MM-DD)
untilstring | nullUTC day (YYYY-MM-DD)
demographicsmap of array of objectnotestring | nullResponses
{
"object": "demographics",
"account_id": "string",
"platform": "string",
"metric": "string",
"timeframe": "string",
"video_id": "string",
"title": "string",
"published_at": "2026-10-13T09:00:00.000Z",
"snapshot_date": "string",
"date_range": {
"since": "string",
"until": "string"
},
"demographics": {
"key": [
{
"dimension": "string",
"value": 1.5
}
]
},
"note": "string"
}Get Instagram followers online per hour
/analytics/instagram/online-followersTry it with MCPAsk your agent to call get-instagram-online-followers (toolset analytics)Set up MCP
Query parameters
account_idstringrequiredAccount id (sa_…)
1–80 characters
Returns object
objectstringonline_followers
account_idstringplatformstringmetricstringdaysarray of objectShow 2 item attributes
end_timestringhoursmap of numbernotestring | nullResponses
{
"object": "online_followers",
"account_id": "string",
"platform": "string",
"metric": "string",
"days": [
{
"end_time": "string",
"hours": {}
}
],
"note": "string"
}Google Business
Get Google Business Profile performance metrics
/analytics/googlebusiness/performanceDaily impressions, clicks, calls, directions, conversations, bookings and food orders (2-3 day delay, up to 18 months back).
Try it with MCPAsk your agent to call get-google-business-performance (toolset analytics)Set up MCP
Query parameters
account_idstringrequiredAccount id (sa_…)
1–80 characters
metricsstringComma-separated metric names (network vocabulary)
from_datestringUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
Returns object
objectstringaccount_insights
account_idstringplatformstringdate_rangeobjectShow 2 child attributes
sincestring | nullUTC day (YYYY-MM-DD)
untilstring | nullUTC day (YYYY-MM-DD)
metric_typestringtotal_valuetime_series
breakdownstring | nullmetricsmap of objectunavailable_metricsarray of objectShow 3 item attributes
metricstringreasonstringmessagestring | nulldata_delaystring | nullResponses
{
"object": "account_insights",
"account_id": "string",
"platform": "string",
"date_range": {
"since": "string",
"until": "string"
},
"metric_type": "total_value",
"breakdown": "string",
"metrics": {
"key": {
"total": 1.5,
"values": [
{
"date": "string",
"value": 1.5
}
],
"breakdowns": [
{
"dimension": "string",
"value": 1.5
}
],
"unit": "string",
"currency": "USD"
}
},
"unavailable_metrics": [
{
"metric": "string",
"reason": "string",
"message": "string"
}
],
"data_delay": "string"
}Get Google Business Profile search keywords
/analytics/googlebusiness/search-keywordsTry it with MCPAsk your agent to call get-google-business-search-keywords (toolset analytics)Set up MCP
Query parameters
account_idstringrequiredAccount id (sa_…)
1–80 characters
start_monthstringpattern ^\d{4}-\d{2}$
end_monthstringpattern ^\d{4}-\d{2}$
Returns object
objectstringsearch_keywords
account_idstringplatformstringmonth_rangeobjectShow 2 child attributes
start_monthstringend_monthstringkeywordsarray of objectShow 2 item attributes
keywordstringimpressionsnumber | nullnotestring | nullResponses
{
"object": "search_keywords",
"account_id": "string",
"platform": "string",
"month_range": {
"start_month": "string",
"end_month": "string"
},
"keywords": [
{
"keyword": "string",
"impressions": 1.5
}
],
"note": "string"
}Inbox
Get inbox messaging volume
/analytics/inbox/volumeTry it with MCPAsk your agent to call get-inbox-volume (toolset analytics)Set up MCP
Query parameters
from_datestringrequiredUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
platformstringNetwork key (x, instagram, …; aliases twitter, googlebusiness) or "all"
profile_idstringProfile id (pro_…) or "all"
account_idstringAccount id (sa_…)
1–80 characters
sourcestringhumanapiworkflowsequencebroadcastcomment_automationautomationcontactplatform
Returns object
objectstringinbox_volume
from_datestringto_datestringsummaryobjectShow 5 child attributes
receivedintegersentintegerreadintegerfailedintegerunique_conversationsintegertimeseriesarray of objectShow 5 item attributes
datestringreceivedintegersentintegerreadintegerfailedintegerby_platformarray of objectShow 5 item attributes
platformstringreceivedintegersentintegerreadintegerfailedintegerResponses
{
"object": "inbox_volume",
"from_date": "string",
"to_date": "string",
"summary": {
"received": 1,
"sent": 1,
"read": 1,
"failed": 1,
"unique_conversations": 1
},
"timeseries": [
{
"date": "string",
"received": 1,
"sent": 1,
"read": 1,
"failed": 1
}
],
"by_platform": [
{
"platform": "string",
"received": 1,
"sent": 1,
"read": 1,
"failed": 1
}
]
}Get the inbox day × hour heatmap
/analytics/inbox/heatmapSparse buckets; dow is ISO (1 = Monday … 7 = Sunday), hours in UTC.
Try it with MCPAsk your agent to call get-inbox-heatmap (toolset analytics)Set up MCP
Query parameters
from_datestringrequiredUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
platformstringNetwork key (x, instagram, …; aliases twitter, googlebusiness) or "all"
profile_idstringProfile id (pro_…) or "all"
account_idstringAccount id (sa_…)
1–80 characters
sourcestringhumanapiworkflowsequencebroadcastcomment_automationautomationcontactplatform
actionstringmessage.receivedmessage.sentmessage.readall
Returns object
objectstringinbox_heatmap
from_datestringto_datestringbucketsarray of objectShow 5 item attributes
dowintegerhourintegerreceivedintegersentintegerreadintegerResponses
{
"object": "inbox_heatmap",
"from_date": "string",
"to_date": "string",
"buckets": [
{
"dow": 1,
"hour": 1,
"received": 1,
"sent": 1,
"read": 1
}
]
}Get inbox messages by source
/analytics/inbox/source-breakdownTry it with MCPAsk your agent to call get-inbox-source-breakdown (toolset analytics)Set up MCP
Query parameters
from_datestringrequiredUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
platformstringNetwork key (x, instagram, …; aliases twitter, googlebusiness) or "all"
profile_idstringProfile id (pro_…) or "all"
account_idstringAccount id (sa_…)
1–80 characters
Returns object
objectstringinbox_source_breakdown
from_datestringto_datestringsourcesarray of objectShow 5 item attributes
sourcestringreceivedintegersentintegerreadintegerby_platformarray of objectShow 4 item attributes
platformstringreceivedintegersentintegerreadintegerResponses
{
"object": "inbox_source_breakdown",
"from_date": "string",
"to_date": "string",
"sources": [
{
"source": "string",
"received": 1,
"sent": 1,
"read": 1,
"by_platform": [
{
"platform": "string",
"received": 1,
"sent": 1,
"read": 1
}
]
}
]
}Get inbox response-time stats
/analytics/inbox/response-timeTime to first response (each inbound streak paired with the next outbound message), summary and histogram.
Try it with MCPAsk your agent to call get-inbox-response-time (toolset analytics)Set up MCP
Query parameters
from_datestringrequiredUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
platformstringNetwork key (x, instagram, …; aliases twitter, googlebusiness) or "all"
profile_idstringProfile id (pro_…) or "all"
account_idstringAccount id (sa_…)
1–80 characters
Returns object
objectstringinbox_response_time
from_datestringto_datestringsummaryobjectShow 7 child attributes
sample_sizeintegermedian_secondsinteger | nullp90_secondsinteger | nullp99_secondsinteger | nullmean_secondsinteger | nullfastest_secondsinteger | nullslowest_secondsinteger | nullhistogramarray of objectShow 4 item attributes
bucketstringlower_secondsintegerupper_secondsinteger | nullcountintegerResponses
{
"object": "inbox_response_time",
"from_date": "string",
"to_date": "string",
"summary": {
"sample_size": 1,
"median_seconds": 1,
"p90_seconds": 1,
"p99_seconds": 1,
"mean_seconds": 1,
"fastest_seconds": 1,
"slowest_seconds": 1
},
"histogram": [
{
"bucket": "string",
"lower_seconds": 1,
"upper_seconds": 1,
"count": 1
}
]
}Get top accounts by inbox volume
/analytics/inbox/top-accountsTry it with MCPAsk your agent to call get-inbox-top-accounts (toolset analytics)Set up MCP
Query parameters
from_datestringrequiredUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
platformstringNetwork key (x, instagram, …; aliases twitter, googlebusiness) or "all"
profile_idstringProfile id (pro_…) or "all"
account_idstringAccount id (sa_…)
1–80 characters
sourcestringhumanapiworkflowsequencebroadcastcomment_automationautomationcontactplatform
limitintegerdefault: 101–50
Returns object
objectstringinbox_top_accounts
from_datestringto_datestringaccountsarray of objectShow 10 item attributes
account_idstringplatformstringdisplay_namestring | nullusernamestring | nullreceivedintegersentintegertotalintegerconversationsintegermedian_response_secondsinteger | nullreplied_countintegerResponses
{
"object": "inbox_top_accounts",
"from_date": "string",
"to_date": "string",
"accounts": [
{
"account_id": "string",
"platform": "string",
"display_name": "string",
"username": "string",
"received": 1,
"sent": 1,
"total": 1,
"conversations": 1,
"median_response_seconds": 1,
"replied_count": 1
}
]
}List conversation analytics
/analytics/inbox/conversationsTry it with MCPAsk your agent to call list-conversation-analytics (toolset analytics)Set up MCP
Query parameters
from_datestringrequiredUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
platformstringNetwork key (x, instagram, …; aliases twitter, googlebusiness) or "all"
profile_idstringProfile id (pro_…) or "all"
account_idstringAccount id (sa_…)
1–80 characters
sourcestringhumanapiworkflowsequencebroadcastcomment_automationautomationcontactplatform
pageintegerdefault: 1≥ 1
limitintegerdefault: 201–100
sortstringdefault: "last_message_at"last_message_atfirst_message_attotal_messagesreceivedsentreadfailed
orderstringdefault: "desc"ascdesc
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 16 item attributes
objectstringconversation_analytics
conversation_idstringplatform_conversation_idstring | nullaccount_idstringplatformstringparticipant_namestring | nullparticipant_usernamestring | nullparticipant_picturestring | nulllast_messagestring | nulltotal_messagesintegerreceivedintegersentintegerreadintegerfailedintegerfirst_message_atstring (date-time) | nulllast_message_atstring (date-time) | nullpageintegerrequiredlimitintegerrequiredtotalinteger | nullhas_morebooleanrequirednext_page_urlstring | nullprevious_page_urlstring | nullfrom_datestringto_datestringResponses
{
"object": "list",
"data": [
{
"object": "conversation_analytics",
"conversation_id": "string",
"platform_conversation_id": "string",
"account_id": "string",
"platform": "string",
"participant_name": "string",
"participant_username": "string",
"participant_picture": "string",
"last_message": "string",
"total_messages": 1,
"received": 1,
"sent": 1,
"read": 1,
"failed": 1,
"first_message_at": "2026-10-13T09:00:00.000Z",
"last_message_at": "2026-10-13T09:00:00.000Z"
}
],
"page": 1,
"limit": 1,
"total": 1,
"has_more": true,
"next_page_url": "https://example.com",
"previous_page_url": "https://example.com",
"from_date": "string",
"to_date": "string"
}Get analytics of one conversation
/analytics/inbox/conversations/{conversationId}Try it with MCPAsk your agent to call get-conversation-analytics (toolset analytics)Set up MCP
Path parameters
conversationIdstringrequiredConversation id (conv_…) or the platform conversation id
1–300 characters
Query parameters
from_datestringrequiredUTC day (YYYY-MM-DD)
to_datestringUTC day (YYYY-MM-DD)
Returns object
objectstringconversation_analytics_detail
conversation_idstringplatform_conversation_idstring | nullplatformstring | nullfrom_datestringto_datestringsummaryobjectShow 7 child attributes
receivedintegersentintegerreadintegerfailedintegertotal_messagesintegerfirst_message_atstring (date-time) | nulllast_message_atstring (date-time) | nulltimeseriesarray of objectShow 5 item attributes
datestringreceivedintegersentintegerreadintegerfailedintegerby_sourcearray of objectShow 2 item attributes
sourcestringcountintegerResponses
{
"object": "conversation_analytics_detail",
"conversation_id": "string",
"platform_conversation_id": "string",
"platform": "string",
"from_date": "string",
"to_date": "string",
"summary": {
"received": 1,
"sent": 1,
"read": 1,
"failed": 1,
"total_messages": 1,
"first_message_at": "2026-10-13T09:00:00.000Z",
"last_message_at": "2026-10-13T09:00:00.000Z"
},
"timeseries": [
{
"date": "string",
"received": 1,
"sent": 1,
"read": 1,
"failed": 1
}
],
"by_source": [
{
"source": "string",
"count": 1
}
]
}