Skip to content
Docs

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).

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits40 endpointsMCP toolset analytics

Analytics

List post analytics

GET/analytics

Posts (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).

Access: readZernio: GET /v1/analytics

Try it with MCPAsk your agent to call list-post-analytics (toolset analytics)Set up MCP

Query parameters

pageintegerdefault: 1

≥ 1

limitintegerdefault: 20

1–100

platformstring

Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"

profile_idstring

Profile id (pro_…) or "all"

account_idstring

Account id (sa_…)

1–80 characters

sourcestring

all (default), socialit (published through Socialit; alias late), external (imported)

allsocialitlateexternal

from_datestring

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

tagsstring

Comma-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

objectstringrequired

list

dataarray of objectrequired
Show 17 item attributes
objectstring

post_analytics

idstring
post_idstring
statusstring
sourcestring

socialitexternal

contentstring | null
profile_idstring | null
scheduled_atstring (date-time) | null
published_atstring (date-time) | null
platformstring
platform_post_urlstring | null
thumbnail_urlstring | null

First attached media of the post (video poster or image URL); null without media

sync_statusstring

syncedpendingpartialunavailable

calculatedboolean
metricsobject | null

Normalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube

Show 25 child attributes
impressionsnumber | null
reachnumber | null
viewsnumber | null
likesnumber | null
commentsnumber | null
sharesnumber | null
savesnumber | null
clicksnumber | null
quotesnumber | null
followsnumber | null
profile_viewsnumber | null
website_clicksnumber | null
watch_time_secondsnumber | null
avg_view_duration_secondsnumber | null
avg_view_percentagenumber | null
completion_ratenumber | null
replaysnumber | null
repostsnumber | null
sendsnumber | null
outbound_clicksnumber | null
pin_clicksnumber | null
video_duration_secondsnumber | null
earningsnumber | null
engagementsnumber | null
engagement_ratenumber | null
platformsarray of object
Show 13 item attributes
objectstring

posting_analytics

posting_idstring
account_idstring | null
account_usernamestring | null
platformstring
statusstring
platform_post_idstring | null
platform_post_urlstring | null
metricsobject | null

Normalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube

Show 25 child attributes
impressionsnumber | null
reachnumber | null
viewsnumber | null
likesnumber | null
commentsnumber | null
sharesnumber | null
savesnumber | null
clicksnumber | null
quotesnumber | null
followsnumber | null
profile_viewsnumber | null
website_clicksnumber | null
watch_time_secondsnumber | null
avg_view_duration_secondsnumber | null
avg_view_percentagenumber | null
completion_ratenumber | null
replaysnumber | null
repostsnumber | null
sendsnumber | null
outbound_clicksnumber | null
pin_clicksnumber | null
video_duration_secondsnumber | null
earningsnumber | null
engagementsnumber | null
engagement_ratenumber | null
sync_statusstring

syncedpendingunavailable

error_codestring | null
error_messagestring | null
last_synced_atstring (date-time) | null
last_synced_atstring (date-time) | null
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null
overviewobject
Show 5 child attributes
total_postsinteger
published_postsinteger
scheduled_postsinteger
last_synced_atstring (date-time) | null
stale_accountsinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics
curl "https://api.socialit.com/v1/analytics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/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.

Access: readZernio: GET /v1/analytics

Try it with MCPAsk your agent to call get-post-analytics (toolset analytics)Set up MCP

Path parameters

postIdstringrequired

Post id (pst_…), posting id (sp_…) or the platform post id

1–300 characters

Returns object

objectstring

post_analytics

idstring
post_idstring
statusstring
sourcestring

socialitexternal

contentstring | null
profile_idstring | null
scheduled_atstring (date-time) | null
published_atstring (date-time) | null
platformstring
platform_post_urlstring | null
thumbnail_urlstring | null

First attached media of the post (video poster or image URL); null without media

sync_statusstring

syncedpendingpartialunavailable

calculatedboolean
metricsobject | null

Normalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube

Show 25 child attributes
impressionsnumber | null
reachnumber | null
viewsnumber | null
likesnumber | null
commentsnumber | null
sharesnumber | null
savesnumber | null
clicksnumber | null
quotesnumber | null
followsnumber | null
profile_viewsnumber | null
website_clicksnumber | null
watch_time_secondsnumber | null
avg_view_duration_secondsnumber | null
avg_view_percentagenumber | null
completion_ratenumber | null
replaysnumber | null
repostsnumber | null
sendsnumber | null
outbound_clicksnumber | null
pin_clicksnumber | null
video_duration_secondsnumber | null
earningsnumber | null
engagementsnumber | null
engagement_ratenumber | null
platformsarray of object
Show 13 item attributes
objectstring

posting_analytics

posting_idstring
account_idstring | null
account_usernamestring | null
platformstring
statusstring
platform_post_idstring | null
platform_post_urlstring | null
metricsobject | null

Normalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube

Show 25 child attributes
impressionsnumber | null
reachnumber | null
viewsnumber | null
likesnumber | null
commentsnumber | null
sharesnumber | null
savesnumber | null
clicksnumber | null
quotesnumber | null
followsnumber | null
profile_viewsnumber | null
website_clicksnumber | null
watch_time_secondsnumber | null
avg_view_duration_secondsnumber | null
avg_view_percentagenumber | null
completion_ratenumber | null
replaysnumber | null
repostsnumber | null
sendsnumber | null
outbound_clicksnumber | null
pin_clicksnumber | null
video_duration_secondsnumber | null
earningsnumber | null
engagementsnumber | null
engagement_ratenumber | null
sync_statusstring

syncedpendingunavailable

error_codestring | null
error_messagestring | null
last_synced_atstring (date-time) | null
last_synced_atstring (date-time) | null

Responses

  • 200OK
  • 202Accepted
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/posts/{postId}
curl "https://api.socialit.com/v1/analytics/posts/POST_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

POST/posts/sync-external

Fetches 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).

Access: writeIdempotency-KeyZernio: POST /v1/posts/sync-external

Try it with MCPAsk your agent to call sync-external-posts (toolset analytics)Set up MCP

Headers

Idempotency-Keystring

Unique 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_idstringrequired

Account id (sa_…)

1–80 characters

urlstring

≤ 2000 characters

post_idstring

Platform post id

≤ 300 characters

Returns object

objectstring

external_post_sync

account_idstring
syncedobject
Show 3 child attributes
posts_foundinteger
posts_syncedinteger
skippedboolean
foundboolean | null
postobject | null
postsarray of object
Show 10 item attributes
objectstring

external_post

post_idstring
posting_idstring
account_idstring
platformstring
platform_post_idstring
platform_post_urlstring | null
contentstring | null
published_atstring (date-time) | null
metricsobject | null

Normalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube

Show 25 child attributes
impressionsnumber | null
reachnumber | null
viewsnumber | null
likesnumber | null
commentsnumber | null
sharesnumber | null
savesnumber | null
clicksnumber | null
quotesnumber | null
followsnumber | null
profile_viewsnumber | null
website_clicksnumber | null
watch_time_secondsnumber | null
avg_view_duration_secondsnumber | null
avg_view_percentagenumber | null
completion_ratenumber | null
replaysnumber | null
repostsnumber | null
sendsnumber | null
outbound_clicksnumber | null
pin_clicksnumber | null
video_duration_secondsnumber | null
earningsnumber | null
engagementsnumber | null
engagement_ratenumber | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/posts/sync-external
curl -X POST "https://api.socialit.com/v1/posts/sync-external" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "url": "https://example.com",
    "post_id": "string"
  }'
Response · 200
{
  "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

GET/analytics/delta

Cursor 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.

Access: readZernio: GET /v1/analytics/delta

Try it with MCPAsk your agent to call get-analytics-delta (toolset analytics)Set up MCP

Query parameters

cursorstring

≤ 200 characters

limitintegerdefault: 50

1–100

platformstring

Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"

profile_idstring

Profile id (pro_…) or "all"

Returns object

objectstring

analytics_delta

dataarray of object
Show 12 item attributes
objectstring

analytics_change

idstring
post_idstring
posting_idstring
account_idstring
profile_idstring | null
platformstring
platform_post_idstring | null
published_atstring (date-time) | null
synced_atstring (date-time) | null
is_deletedboolean
metricsobject | null

Normalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube

Show 25 child attributes
impressionsnumber | null
reachnumber | null
viewsnumber | null
likesnumber | null
commentsnumber | null
sharesnumber | null
savesnumber | null
clicksnumber | null
quotesnumber | null
followsnumber | null
profile_viewsnumber | null
website_clicksnumber | null
watch_time_secondsnumber | null
avg_view_duration_secondsnumber | null
avg_view_percentagenumber | null
completion_ratenumber | null
replaysnumber | null
repostsnumber | null
sendsnumber | null
outbound_clicksnumber | null
pin_clicksnumber | null
video_duration_secondsnumber | null
earningsnumber | null
engagementsnumber | null
engagement_ratenumber | null
next_cursorstring
has_moreboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/delta
curl "https://api.socialit.com/v1/analytics/delta" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/post-timeline

One row per day and platform (last snapshot of the day). Defaults to the last 90 days.

Access: readZernio: GET /v1/analytics/post-timeline

Try it with MCPAsk your agent to call get-post-timeline (toolset analytics)Set up MCP

Query parameters

post_idstringrequired

1–300 characters

from_datestring

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

Returns object

objectstring

post_timeline

post_idstring
from_datestring
to_datestring
timelinearray of object
Show 6 item attributes
datestring
posting_idstring
account_idstring
platformstring
platform_post_idstring | null
metricsobject | null

Normalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube

Show 25 child attributes
impressionsnumber | null
reachnumber | null
viewsnumber | null
likesnumber | null
commentsnumber | null
sharesnumber | null
savesnumber | null
clicksnumber | null
quotesnumber | null
followsnumber | null
profile_viewsnumber | null
website_clicksnumber | null
watch_time_secondsnumber | null
avg_view_duration_secondsnumber | null
avg_view_percentagenumber | null
completion_ratenumber | null
replaysnumber | null
repostsnumber | null
sendsnumber | null
outbound_clicksnumber | null
pin_clicksnumber | null
video_duration_secondsnumber | null
earningsnumber | null
engagementsnumber | null
engagement_ratenumber | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/post-timeline
curl "https://api.socialit.com/v1/analytics/post-timeline?post_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/dashboard

Totals, 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.

Access: readZernio: GET /v1/analytics/dashboard

Try it with MCPAsk your agent to call get-analytics-dashboard (toolset analytics)Set up MCP

Query parameters

platformstring

Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"

profile_idstring

Profile id (pro_…) or "all"

account_idstring

Account id (sa_…)

1–80 characters

from_datestringrequired

UTC day (YYYY-MM-DD)

to_datestringrequired

UTC day (YYYY-MM-DD)

comparestring

previous_period

top_postsintegerdefault: 5

0–25

recent_postsintegerdefault: 10

0–25

Returns object

objectstring

analytics_dashboard

date_rangeobject
Show 2 child attributes
from_datestring
to_datestring
calculatedboolean
totalsobject | null
Show 10 child attributes
impressionsnumber | null
reachnumber | null
likesnumber | null
commentsnumber | null
sharesnumber | null
savesnumber | null
clicksnumber | null
viewsnumber | null
engagementnumber | null
engagement_ratenumber | null
previous_totalsobject | null
Show 10 child attributes
impressionsnumber | null
reachnumber | null
likesnumber | null
commentsnumber | null
sharesnumber | null
savesnumber | null
clicksnumber | null
viewsnumber | null
engagementnumber | null
engagement_ratenumber | null
followersobject | null
Show 3 child attributes
currentnumber | null
gainednumber | null
by_accountarray of object
Show 4 item attributes
account_idstring
platformstring
currentnumber | null
gainednumber | null
previous_followersobject | null
Show 3 child attributes
currentnumber | null
gainednumber | null
by_accountarray of object
Show 4 item attributes
account_idstring
platformstring
currentnumber | null
gainednumber | null
dailyarray of object
Show 6 item attributes
datestring
impressionsnumber | null
reachnumber | null
engagementnumber | null
viewsnumber | null
followers_gainednumber | null
platform_breakdownarray of object
Show 12 item attributes
platformstring
postsnumber | null
impressionsnumber | null
reachnumber | null
likesnumber | null
commentsnumber | null
sharesnumber | null
savesnumber | null
clicksnumber | null
viewsnumber | null
engagementnumber | null
followersnumber | null
top_postsarray of object
Show 9 item attributes
post_idstring
posting_idstring
account_idstring
platformstring
contentstring | null
platform_post_urlstring | null
thumbnail_urlstring | null
published_atstring (date-time) | null
metricsobject
Show 9 child attributes
impressionsnumber | null
reachnumber | null
likesnumber | null
commentsnumber | null
sharesnumber | null
savesnumber | null
clicksnumber | null
viewsnumber | null
engagement_ratenumber | null
recent_postsarray of object
Show 9 item attributes
post_idstring
posting_idstring
account_idstring
platformstring
contentstring | null
platform_post_urlstring | null
thumbnail_urlstring | null
published_atstring (date-time) | null
metricsobject
Show 9 child attributes
impressionsnumber | null
reachnumber | null
likesnumber | null
commentsnumber | null
sharesnumber | null
savesnumber | null
clicksnumber | null
viewsnumber | null
engagement_ratenumber | null
data_as_ofstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/dashboard
curl "https://api.socialit.com/v1/analytics/dashboard?from_date=value&to_date=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/daily-metrics

Per-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.

Access: readZernio: GET /v1/analytics/daily-metrics

Try it with MCPAsk your agent to call get-daily-metrics (toolset analytics)Set up MCP

Query parameters

platformstring

Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"

profile_idstring

Profile id (pro_…) or "all"

account_idstring

Account id (sa_…)

1–80 characters

from_datestring

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

sourcestring

all (default), socialit (published through Socialit; alias late), external (imported)

allsocialitlateexternal

attributionstringdefault: "publish"

publishreceived

Returns object

objectstring

daily_metrics

from_datestring
to_datestring
attributionstring

publishreceived

calculatedboolean
dailyarray of object
Show 4 item attributes
datestring
post_countinteger
platformsmap of number
metricsobject
Show 8 child attributes
impressionsnumber | null
reachnumber | null
likesnumber | null
commentsnumber | null
sharesnumber | null
savesnumber | null
clicksnumber | null
viewsnumber | null
platform_breakdownarray of object
Show 10 item attributes
platformstring
post_countinteger
impressionsnumber | null
reachnumber | null
likesnumber | null
commentsnumber | null
sharesnumber | null
savesnumber | null
clicksnumber | null
viewsnumber | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/daily-metrics
curl "https://api.socialit.com/v1/analytics/daily-metrics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/best-time

Average engagement of published posts by UTC weekday (0 = Sunday) and hour, best slots first.

Access: readZernio: GET /v1/analytics/best-time

Try it with MCPAsk your agent to call get-best-time-to-post (toolset analytics)Set up MCP

Query parameters

platformstring

Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"

profile_idstring

Profile id (pro_…) or "all"

account_idstring

Account id (sa_…)

1–80 characters

from_datestring

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

sourcestring

all (default), socialit (published through Socialit; alias late), external (imported)

allsocialitlateexternal

Returns object

objectstring

best_time

timezonestring
slotsarray of object
Show 4 item attributes
day_of_weekinteger
hourinteger
avg_engagementnumber | null
post_countinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/best-time
curl "https://api.socialit.com/v1/analytics/best-time" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/content-decay

Average share of a post's final engagement reached 1h, 6h, 24h, 3d, 7d and 30d after publishing.

Access: readZernio: GET /v1/analytics/content-decay

Try it with MCPAsk your agent to call get-content-decay (toolset analytics)Set up MCP

Query parameters

platformstring

Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"

profile_idstring

Profile id (pro_…) or "all"

account_idstring

Account id (sa_…)

1–80 characters

from_datestring

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

sourcestring

all (default), socialit (published through Socialit; alias late), external (imported)

allsocialitlateexternal

Returns object

objectstring

content_decay

bucketsarray of object
Show 4 item attributes
bucket_orderinteger
bucket_labelstring
avg_pct_of_finalnumber | null
post_countinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/content-decay
curl "https://api.socialit.com/v1/analytics/content-decay" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/posting-frequency

Average engagement rate and engagement per platform for each observed posts-per-week cadence.

Access: readZernio: GET /v1/analytics/posting-frequency

Try it with MCPAsk your agent to call get-posting-frequency (toolset analytics)Set up MCP

Query parameters

platformstring

Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"

profile_idstring

Profile id (pro_…) or "all"

account_idstring

Account id (sa_…)

1–80 characters

from_datestring

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

sourcestring

all (default), socialit (published through Socialit; alias late), external (imported)

allsocialitlateexternal

Returns object

objectstring

posting_frequency

frequencyarray of object
Show 5 item attributes
platformstring
posts_per_weekinteger
avg_engagement_ratenumber | null
avg_engagementnumber | null
weeks_countinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/posting-frequency
curl "https://api.socialit.com/v1/analytics/posting-frequency" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/accounts/{accountId}

Daily follower snapshots and normalized daily insights collected by the analytics sync (Pinterest: live, cached for an hour).

Access: read

Try it with MCPAsk your agent to call get-account-analytics (toolset analytics)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Query parameters

from_datestring

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

Returns object

objectstring

account_analytics

account_idstring
platformstring
usernamestring | null
date_rangeobject
Show 2 child attributes
from_datestring
to_datestring
currentobject | null
Show 4 child attributes
followersinteger | null
followinginteger | null
posts_countinteger | null
datestring | null

UTC day (YYYY-MM-DD)

snapshotsarray of object
Show 4 item attributes
datestring
followersinteger | null
followinginteger | null
posts_countinteger | null
insightsarray of object
Show 2 item attributes
datestring
metricsmap of number
totalsmap of number
last_synced_atstring (date-time) | null
cachedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/accounts/{accountId}
curl "https://api.socialit.com/v1/analytics/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/accounts/{accountId}/demographics

Live audience demographics from the network (age, gender, country, city, locale where available).

Access: read

Try it with MCPAsk your agent to call get-account-demographics (toolset analytics)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Query parameters

from_datestring

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

Returns object

objectstring

demographics

account_idstring
platformstring
metricstring | null
timeframestring | null
video_idstring | null
titlestring | null
published_atstring (date-time) | null
snapshot_datestring | null

UTC day (YYYY-MM-DD)

date_rangeobject | null
Show 2 child attributes
sincestring | null

UTC day (YYYY-MM-DD)

untilstring | null

UTC day (YYYY-MM-DD)

demographicsmap of array of object
notestring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/accounts/{accountId}/demographics
curl "https://api.socialit.com/v1/analytics/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/demographics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/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.

Access: read

Try it with MCPAsk your agent to call get-account-report (toolset analytics)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

reportstringrequired

1–80 characters

Query parameters

from_datestring

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

Returns object

objectstring

platform_report

account_idstring
platformstring
reportstring
dataobject | null

Provider report as returned (arrays are wrapped as { rows })

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/accounts/{accountId}/reports/{report}
curl "https://api.socialit.com/v1/analytics/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reports/REPORT" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "platform_report",
  "account_id": "string",
  "platform": "string",
  "report": "string",
  "data": {}
}

Sync

Queue an analytics sync for an account

POST/analytics/accounts/{accountId}/sync

Refreshes stats, insights and post metrics in the background (202). analytics.synced fires when it completes.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call sync-account-analytics (toolset analytics)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

objectstring

analytics_sync

account_idstring
statusstring

queued

scopearray of string
queued_atstring (date-time) | null

Responses

  • 202Accepted
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/analytics/accounts/{accountId}/sync
curl -X POST "https://api.socialit.com/v1/analytics/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/sync" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "scope": [
      "stats"
    ]
  }'
Response · 202
{
  "object": "analytics_sync",
  "account_id": "string",
  "status": "queued",
  "scope": [
    "string"
  ],
  "queued_at": "2026-10-13T09:00:00.000Z"
}

YouTube

Get YouTube channel insights

GET/analytics/youtube/channel-insights

Channel metrics from YouTube Analytics (2-3 day delay, max 89 days). Requires the yt-analytics.readonly scope.

Access: readZernio: GET /v1/analytics/youtube/channel-insights

Try it with MCPAsk your agent to call get-youtube-channel-insights (toolset analytics)Set up MCP

Query parameters

account_idstringrequired

Account id (sa_…)

1–80 characters

metricsstring

Comma-separated metric names (network vocabulary)

from_datestring

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

metric_typestringdefault: "total_value"

total_valuetime_series

Returns object

objectstring

account_insights

account_idstring
platformstring
date_rangeobject
Show 2 child attributes
sincestring | null

UTC day (YYYY-MM-DD)

untilstring | null

UTC day (YYYY-MM-DD)

metric_typestring

total_valuetime_series

breakdownstring | null
metricsmap of object
unavailable_metricsarray of object
Show 3 item attributes
metricstring
reasonstring
messagestring | null
data_delaystring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/youtube/channel-insights
curl "https://api.socialit.com/v1/analytics/youtube/channel-insights?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/youtube/daily-views

Daily views, watch time and subscriber changes of one video (max 90 days; default ends 3 days ago).

Access: readZernio: GET /v1/analytics/youtube/daily-views

Try it with MCPAsk your agent to call get-youtube-daily-views (toolset analytics)Set up MCP

Query parameters

account_idstringrequired

Account id (sa_…)

1–80 characters

video_idstringrequired

1–64 characters

from_datestring

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

Returns object

objectstring

youtube_daily_views

account_idstring
video_idstring
titlestring | null
duration_secondsinteger | null
date_rangeobject
Show 2 child attributes
sincestring | null

UTC day (YYYY-MM-DD)

untilstring | null

UTC day (YYYY-MM-DD)

provisional_sincestring | null

UTC day (YYYY-MM-DD)

total_viewsnumber | null
daily_viewsarray of object
Show 10 item attributes
datestring
viewsnumber | null
estimated_minutes_watchednumber | null
average_view_durationnumber | null
average_view_percentagenumber | null
subscribers_gainednumber | null
subscribers_lostnumber | null
likesnumber | null
commentsnumber | null
sharesnumber | null
last_synced_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/youtube/daily-views
curl "https://api.socialit.com/v1/analytics/youtube/daily-views?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd&video_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/youtube/video-retention

Access: readZernio: GET /v1/analytics/youtube/video-retention

Try it with MCPAsk your agent to call get-youtube-video-retention (toolset analytics)Set up MCP

Query parameters

account_idstringrequired

Account id (sa_…)

1–80 characters

video_idstringrequired

1–64 characters

from_datestring

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

Returns object

objectstring

youtube_video_retention

account_idstring
video_idstring
titlestring | null
published_atstring (date-time) | null
duration_secondsinteger | null
date_rangeobject
Show 2 child attributes
sincestring | null

UTC day (YYYY-MM-DD)

untilstring | null

UTC day (YYYY-MM-DD)

provisional_sincestring | null

UTC day (YYYY-MM-DD)

retention_curvearray of object
Show 6 item attributes
elapsed_video_time_rationumber | null
audience_watch_rationumber | null
relative_retention_performancenumber | null
started_watchingnumber | null
stopped_watchingnumber | null
total_segment_impressionsnumber | null
notestring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/youtube/video-retention
curl "https://api.socialit.com/v1/analytics/youtube/video-retention?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd&video_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/youtube/demographics

Age and gender are viewer percentages; country values are views. Channel-wide or one video with video_id.

Access: readZernio: GET /v1/analytics/youtube/demographics

Try it with MCPAsk your agent to call get-youtube-demographics (toolset analytics)Set up MCP

Query parameters

account_idstringrequired

Account id (sa_…)

1–80 characters

video_idstring

≤ 64 characters

breakdownstring

age,gender,country

from_datestring

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

Returns object

objectstring

demographics

account_idstring
platformstring
metricstring | null
timeframestring | null
video_idstring | null
titlestring | null
published_atstring (date-time) | null
snapshot_datestring | null

UTC day (YYYY-MM-DD)

date_rangeobject | null
Show 2 child attributes
sincestring | null

UTC day (YYYY-MM-DD)

untilstring | null

UTC day (YYYY-MM-DD)

demographicsmap of array of object
notestring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/youtube/demographics
curl "https://api.socialit.com/v1/analytics/youtube/demographics?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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"
}

LinkedIn

Get LinkedIn organization analytics

GET/analytics/linkedin/org-aggregate-analytics

Share, follower and page statistics of a LinkedIn organization page (max 89 days).

Access: readZernio: GET /v1/analytics/linkedin/org-aggregate-analytics

Try it with MCPAsk your agent to call get-linkedin-org-analytics (toolset analytics)Set up MCP

Query parameters

account_idstringrequired

Account id (sa_…)

1–80 characters

metricsstring

Comma-separated metric names (network vocabulary)

from_datestring

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

metric_typestringdefault: "total_value"

total_valuetime_series

Returns object

objectstring

account_insights

account_idstring
platformstring
date_rangeobject
Show 2 child attributes
sincestring | null

UTC day (YYYY-MM-DD)

untilstring | null

UTC day (YYYY-MM-DD)

metric_typestring

total_valuetime_series

breakdownstring | null
metricsmap of object
unavailable_metricsarray of object
Show 3 item attributes
metricstring
reasonstring
messagestring | null
data_delaystring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/linkedin/org-aggregate-analytics
curl "https://api.socialit.com/v1/analytics/linkedin/org-aggregate-analytics?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/accounts/{accountId}/linkedin/aggregate-analytics

Totals or daily series across the member's posts (posts published through Socialit; LinkedIn API limitation).

Access: readZernio: GET /v1/accounts/{accountId}/linkedin-aggregate-analytics

Try it with MCPAsk your agent to call get-linkedin-aggregate-analytics (toolset analytics)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Query parameters

aggregationstringdefault: "TOTAL"

TOTALDAILY

from_datestring

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

metricsstring

IMPRESSION,MEMBERS_REACHED,REACTION,COMMENT,RESHARE,POST_SAVE,POST_SEND

Returns object

objectstring

linkedin_aggregate_analytics

account_idstring
platformstring
account_typestring
usernamestring | null
aggregationstring

TOTALDAILY

date_rangeobject
Show 2 child attributes
sincestring | null

UTC day (YYYY-MM-DD)

untilstring | null

UTC day (YYYY-MM-DD)

analyticsmap of number | array of object | null

TOTAL: numbers per metric; DAILY: [{ date, count }] per metric

skipped_metricsarray of string
notestring | null
last_updatedstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/aggregate-analytics
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/aggregate-analytics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/accounts/{accountId}/linkedin/post-analytics

Access: readZernio: GET /v1/accounts/{accountId}/linkedin-post-analytics

Try it with MCPAsk your agent to call get-linkedin-post-analytics (toolset analytics)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Query parameters

urnstringrequired

1–300 characters

Returns object

objectstring

linkedin_post_analytics

account_idstring
platformstring
account_typestring
usernamestring | null
post_urnstring
analyticsobject
Show 10 child attributes
impressionsnumber | null
reachnumber | null
likesnumber | null
commentsnumber | null
sharesnumber | null
savesnumber | null
sendsnumber | null
clicksnumber | null
viewsnumber | null
engagement_ratenumber | null
last_updatedstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/post-analytics
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/post-analytics?urn=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/accounts/{accountId}/linkedin/post-reactions

Individual reactions on an organization post (offset cursor).

Access: readZernio: GET /v1/accounts/{accountId}/linkedin-post-reactions

Try it with MCPAsk your agent to call get-linkedin-post-reactions (toolset analytics)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Query parameters

urnstringrequired

1–300 characters

limitintegerdefault: 25

1–100

cursorintegerdefault: 0

Returns object

objectstring

linkedin_post_reactions

account_idstring
post_urnstring
dataarray of object
Show 4 item attributes
reaction_typestring | null
reaction_labelstring | null
reacted_atstring (date-time) | null
fromobject
Show 6 child attributes
urnstring | null
namestring | null
headlinestring | null
usernamestring | null
profile_picturestring | null
profile_urlstring | null
has_moreboolean
next_cursorstring | null
totalinteger | null
last_updatedstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin/post-reactions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin/post-reactions?urn=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/tiktok/account-insights

Live counters plus daily history joined from Socialit snapshots (max 89 days).

Access: readZernio: GET /v1/analytics/tiktok/account-insights

Try it with MCPAsk your agent to call get-tiktok-account-insights (toolset analytics)Set up MCP

Query parameters

account_idstringrequired

Account id (sa_…)

1–80 characters

metricsstring

Comma-separated metric names (network vocabulary)

from_datestring

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

metric_typestringdefault: "total_value"

total_valuetime_series

Returns object

objectstring

account_insights

account_idstring
platformstring
date_rangeobject
Show 2 child attributes
sincestring | null

UTC day (YYYY-MM-DD)

untilstring | null

UTC day (YYYY-MM-DD)

metric_typestring

total_valuetime_series

breakdownstring | null
metricsmap of object
unavailable_metricsarray of object
Show 3 item attributes
metricstring
reasonstring
messagestring | null
data_delaystring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/tiktok/account-insights
curl "https://api.socialit.com/v1/analytics/tiktok/account-insights?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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"
}

Facebook

Get Facebook Page insights

GET/analytics/facebook/page-insights

Current (post-November 2025) Page metrics; followers_gained / followers_lost are synthesized from daily follows/unfollows (max 89 days).

Access: readZernio: GET /v1/analytics/facebook/page-insights

Try it with MCPAsk your agent to call get-facebook-page-insights (toolset analytics)Set up MCP

Query parameters

account_idstringrequired

Account id (sa_…)

1–80 characters

metricsstring

Comma-separated metric names (network vocabulary)

from_datestring

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

metric_typestringdefault: "total_value"

total_valuetime_series

Returns object

objectstring

account_insights

account_idstring
platformstring
date_rangeobject
Show 2 child attributes
sincestring | null

UTC day (YYYY-MM-DD)

untilstring | null

UTC day (YYYY-MM-DD)

metric_typestring

total_valuetime_series

breakdownstring | null
metricsmap of object
unavailable_metricsarray of object
Show 3 item attributes
metricstring
reasonstring
messagestring | null
data_delaystring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/facebook/page-insights
curl "https://api.socialit.com/v1/analytics/facebook/page-insights?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/facebook/post-earnings

Lifetime (cumulative) values in the platform's raw unit; never sum across posts or dates.

Access: readZernio: GET /v1/analytics/facebook/post-earnings

Try it with MCPAsk your agent to call get-facebook-post-earnings (toolset analytics)Set up MCP

Query parameters

account_idstringrequired

Account id (sa_…)

1–80 characters

post_idstringrequired

1–200 characters

metricsstring

Comma-separated metric names (network vocabulary)

Returns object

objectstring

post_earnings

account_idstring
platformstring
post_idstring
periodstring

lifetime

metricsmap of object
unavailable_metricsarray of object
Show 3 item attributes
metricstring
reasonstring
messagestring | null
data_delaystring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/facebook/post-earnings
curl "https://api.socialit.com/v1/analytics/facebook/post-earnings?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd&post_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/facebook/demographics

Followers by country and city (Meta removed age and gender for Pages in November 2025).

Access: readZernio: GET /v1/analytics/facebook/demographics

Try it with MCPAsk your agent to call get-facebook-demographics (toolset analytics)Set up MCP

Query parameters

account_idstringrequired

Account id (sa_…)

1–80 characters

breakdownstring

country,city

Returns object

objectstring

demographics

account_idstring
platformstring
metricstring | null
timeframestring | null
video_idstring | null
titlestring | null
published_atstring (date-time) | null
snapshot_datestring | null

UTC day (YYYY-MM-DD)

date_rangeobject | null
Show 2 child attributes
sincestring | null

UTC day (YYYY-MM-DD)

untilstring | null

UTC day (YYYY-MM-DD)

demographicsmap of array of object
notestring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/facebook/demographics
curl "https://api.socialit.com/v1/analytics/facebook/demographics?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/accounts/{accountId}/facebook/post-reactions

Access: readZernio: GET /v1/accounts/{accountId}/facebook-post-reactions

Try it with MCPAsk your agent to call get-facebook-post-reactions (toolset analytics)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Query parameters

post_idstringrequired

1–200 characters

Returns object

objectstring

facebook_post_reactions

account_idstring
platformstring
usernamestring | null
post_idstring
totalnumber | null
breakdownobject
Show 7 child attributes
likenumber | null
lovenumber | null
hahanumber | null
wownumber | null
sadnumber | null
angrynumber | null
carenumber | null
last_updatedstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/post-reactions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/post-reactions?post_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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"
}

Instagram

Get Instagram account insights

GET/analytics/instagram/account-insights

Only reach supports metric_type=time_series (Instagram API limitation). Breakdowns need metric_type=total_value.

Access: readZernio: GET /v1/analytics/instagram/account-insights

Try it with MCPAsk your agent to call get-instagram-account-insights (toolset analytics)Set up MCP

Query parameters

account_idstringrequired

Account id (sa_…)

1–80 characters

metricsstring

Comma-separated metric names (network vocabulary)

from_datestring

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

metric_typestringdefault: "total_value"

total_valuetime_series

breakdownstring

media_product_typefollow_typefollower_typecontact_button_type

Returns object

objectstring

account_insights

account_idstring
platformstring
date_rangeobject
Show 2 child attributes
sincestring | null

UTC day (YYYY-MM-DD)

untilstring | null

UTC day (YYYY-MM-DD)

metric_typestring

total_valuetime_series

breakdownstring | null
metricsmap of object
unavailable_metricsarray of object
Show 3 item attributes
metricstring
reasonstring
messagestring | null
data_delaystring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/instagram/account-insights
curl "https://api.socialit.com/v1/analytics/instagram/account-insights?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/instagram/follower-history

Daily follower count from Socialit snapshots joined with Instagram's new-follower series (max 89 days).

Access: readZernio: GET /v1/analytics/instagram/follower-history

Try it with MCPAsk your agent to call get-instagram-follower-history (toolset analytics)Set up MCP

Query parameters

account_idstringrequired

Account id (sa_…)

1–80 characters

metricsstring

Comma-separated metric names (network vocabulary)

from_datestring

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

metric_typestringdefault: "total_value"

total_valuetime_series

Returns object

objectstring

account_insights

account_idstring
platformstring
date_rangeobject
Show 2 child attributes
sincestring | null

UTC day (YYYY-MM-DD)

untilstring | null

UTC day (YYYY-MM-DD)

metric_typestring

total_valuetime_series

breakdownstring | null
metricsmap of object
unavailable_metricsarray of object
Show 3 item attributes
metricstring
reasonstring
messagestring | null
data_delaystring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/instagram/follower-history
curl "https://api.socialit.com/v1/analytics/instagram/follower-history?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/instagram/demographics

Top 45 entries per dimension; requires at least 100 followers.

Access: readZernio: GET /v1/analytics/instagram/demographics

Try it with MCPAsk your agent to call get-instagram-demographics (toolset analytics)Set up MCP

Query parameters

account_idstringrequired

Account id (sa_…)

1–80 characters

metricstringdefault: "follower_demographics"

follower_demographicsengaged_audience_demographics

breakdownstring

age,city,country,gender

timeframestringdefault: "this_month"

this_weekthis_month

Returns object

objectstring

demographics

account_idstring
platformstring
metricstring | null
timeframestring | null
video_idstring | null
titlestring | null
published_atstring (date-time) | null
snapshot_datestring | null

UTC day (YYYY-MM-DD)

date_rangeobject | null
Show 2 child attributes
sincestring | null

UTC day (YYYY-MM-DD)

untilstring | null

UTC day (YYYY-MM-DD)

demographicsmap of array of object
notestring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/instagram/demographics
curl "https://api.socialit.com/v1/analytics/instagram/demographics?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/instagram/online-followers

Access: readZernio: GET /v1/analytics/instagram/online-followers

Try it with MCPAsk your agent to call get-instagram-online-followers (toolset analytics)Set up MCP

Query parameters

account_idstringrequired

Account id (sa_…)

1–80 characters

Returns object

objectstring

online_followers

account_idstring
platformstring
metricstring
daysarray of object
Show 2 item attributes
end_timestring
hoursmap of number
notestring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/instagram/online-followers
curl "https://api.socialit.com/v1/analytics/instagram/online-followers?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/googlebusiness/performance

Daily impressions, clicks, calls, directions, conversations, bookings and food orders (2-3 day delay, up to 18 months back).

Access: readZernio: GET /v1/analytics/googlebusiness/performance

Try it with MCPAsk your agent to call get-google-business-performance (toolset analytics)Set up MCP

Query parameters

account_idstringrequired

Account id (sa_…)

1–80 characters

metricsstring

Comma-separated metric names (network vocabulary)

from_datestring

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

Returns object

objectstring

account_insights

account_idstring
platformstring
date_rangeobject
Show 2 child attributes
sincestring | null

UTC day (YYYY-MM-DD)

untilstring | null

UTC day (YYYY-MM-DD)

metric_typestring

total_valuetime_series

breakdownstring | null
metricsmap of object
unavailable_metricsarray of object
Show 3 item attributes
metricstring
reasonstring
messagestring | null
data_delaystring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/googlebusiness/performance
curl "https://api.socialit.com/v1/analytics/googlebusiness/performance?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/googlebusiness/search-keywords

Access: readZernio: GET /v1/analytics/googlebusiness/search-keywords

Try it with MCPAsk your agent to call get-google-business-search-keywords (toolset analytics)Set up MCP

Query parameters

account_idstringrequired

Account id (sa_…)

1–80 characters

start_monthstring

pattern ^\d{4}-\d{2}$

end_monthstring

pattern ^\d{4}-\d{2}$

Returns object

objectstring

search_keywords

account_idstring
platformstring
month_rangeobject
Show 2 child attributes
start_monthstring
end_monthstring
keywordsarray of object
Show 2 item attributes
keywordstring
impressionsnumber | null
notestring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/googlebusiness/search-keywords
curl "https://api.socialit.com/v1/analytics/googlebusiness/search-keywords?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/inbox/volume

Access: readZernio: GET /v1/analytics/inbox/volume

Try it with MCPAsk your agent to call get-inbox-volume (toolset analytics)Set up MCP

Query parameters

from_datestringrequired

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

platformstring

Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"

profile_idstring

Profile id (pro_…) or "all"

account_idstring

Account id (sa_…)

1–80 characters

sourcestring

humanapiworkflowsequencebroadcastcomment_automationautomationcontactplatform

Returns object

objectstring

inbox_volume

from_datestring
to_datestring
summaryobject
Show 5 child attributes
receivedinteger
sentinteger
readinteger
failedinteger
unique_conversationsinteger
timeseriesarray of object
Show 5 item attributes
datestring
receivedinteger
sentinteger
readinteger
failedinteger
by_platformarray of object
Show 5 item attributes
platformstring
receivedinteger
sentinteger
readinteger
failedinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/inbox/volume
curl "https://api.socialit.com/v1/analytics/inbox/volume?from_date=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/inbox/heatmap

Sparse buckets; dow is ISO (1 = Monday … 7 = Sunday), hours in UTC.

Access: readZernio: GET /v1/analytics/inbox/heatmap

Try it with MCPAsk your agent to call get-inbox-heatmap (toolset analytics)Set up MCP

Query parameters

from_datestringrequired

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

platformstring

Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"

profile_idstring

Profile id (pro_…) or "all"

account_idstring

Account id (sa_…)

1–80 characters

sourcestring

humanapiworkflowsequencebroadcastcomment_automationautomationcontactplatform

actionstring

message.receivedmessage.sentmessage.readall

Returns object

objectstring

inbox_heatmap

from_datestring
to_datestring
bucketsarray of object
Show 5 item attributes
dowinteger
hourinteger
receivedinteger
sentinteger
readinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/inbox/heatmap
curl "https://api.socialit.com/v1/analytics/inbox/heatmap?from_date=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/inbox/source-breakdown

Access: readZernio: GET /v1/analytics/inbox/source-breakdown

Try it with MCPAsk your agent to call get-inbox-source-breakdown (toolset analytics)Set up MCP

Query parameters

from_datestringrequired

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

platformstring

Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"

profile_idstring

Profile id (pro_…) or "all"

account_idstring

Account id (sa_…)

1–80 characters

Returns object

objectstring

inbox_source_breakdown

from_datestring
to_datestring
sourcesarray of object
Show 5 item attributes
sourcestring
receivedinteger
sentinteger
readinteger
by_platformarray of object
Show 4 item attributes
platformstring
receivedinteger
sentinteger
readinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/inbox/source-breakdown
curl "https://api.socialit.com/v1/analytics/inbox/source-breakdown?from_date=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/inbox/response-time

Time to first response (each inbound streak paired with the next outbound message), summary and histogram.

Access: readZernio: GET /v1/analytics/inbox/response-time

Try it with MCPAsk your agent to call get-inbox-response-time (toolset analytics)Set up MCP

Query parameters

from_datestringrequired

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

platformstring

Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"

profile_idstring

Profile id (pro_…) or "all"

account_idstring

Account id (sa_…)

1–80 characters

Returns object

objectstring

inbox_response_time

from_datestring
to_datestring
summaryobject
Show 7 child attributes
sample_sizeinteger
median_secondsinteger | null
p90_secondsinteger | null
p99_secondsinteger | null
mean_secondsinteger | null
fastest_secondsinteger | null
slowest_secondsinteger | null
histogramarray of object
Show 4 item attributes
bucketstring
lower_secondsinteger
upper_secondsinteger | null
countinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/inbox/response-time
curl "https://api.socialit.com/v1/analytics/inbox/response-time?from_date=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/inbox/top-accounts

Access: readZernio: GET /v1/analytics/inbox/top-accounts

Try it with MCPAsk your agent to call get-inbox-top-accounts (toolset analytics)Set up MCP

Query parameters

from_datestringrequired

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

platformstring

Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"

profile_idstring

Profile id (pro_…) or "all"

account_idstring

Account id (sa_…)

1–80 characters

sourcestring

humanapiworkflowsequencebroadcastcomment_automationautomationcontactplatform

limitintegerdefault: 10

1–50

Returns object

objectstring

inbox_top_accounts

from_datestring
to_datestring
accountsarray of object
Show 10 item attributes
account_idstring
platformstring
display_namestring | null
usernamestring | null
receivedinteger
sentinteger
totalinteger
conversationsinteger
median_response_secondsinteger | null
replied_countinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/inbox/top-accounts
curl "https://api.socialit.com/v1/analytics/inbox/top-accounts?from_date=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/inbox/conversations

Access: readZernio: GET /v1/analytics/inbox/conversations

Try it with MCPAsk your agent to call list-conversation-analytics (toolset analytics)Set up MCP

Query parameters

from_datestringrequired

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

platformstring

Network key (x, instagram, …; aliases twitter, googlebusiness) or "all"

profile_idstring

Profile id (pro_…) or "all"

account_idstring

Account id (sa_…)

1–80 characters

sourcestring

humanapiworkflowsequencebroadcastcomment_automationautomationcontactplatform

pageintegerdefault: 1

≥ 1

limitintegerdefault: 20

1–100

sortstringdefault: "last_message_at"

last_message_atfirst_message_attotal_messagesreceivedsentreadfailed

orderstringdefault: "desc"

ascdesc

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 16 item attributes
objectstring

conversation_analytics

conversation_idstring
platform_conversation_idstring | null
account_idstring
platformstring
participant_namestring | null
participant_usernamestring | null
participant_picturestring | null
last_messagestring | null
total_messagesinteger
receivedinteger
sentinteger
readinteger
failedinteger
first_message_atstring (date-time) | null
last_message_atstring (date-time) | null
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null
from_datestring
to_datestring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/inbox/conversations
curl "https://api.socialit.com/v1/analytics/inbox/conversations?from_date=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/analytics/inbox/conversations/{conversationId}

Access: readZernio: GET /v1/analytics/inbox/conversations/{conversationId}

Try it with MCPAsk your agent to call get-conversation-analytics (toolset analytics)Set up MCP

Path parameters

conversationIdstringrequired

Conversation id (conv_…) or the platform conversation id

1–300 characters

Query parameters

from_datestringrequired

UTC day (YYYY-MM-DD)

to_datestring

UTC day (YYYY-MM-DD)

Returns object

objectstring

conversation_analytics_detail

conversation_idstring
platform_conversation_idstring | null
platformstring | null
from_datestring
to_datestring
summaryobject
Show 7 child attributes
receivedinteger
sentinteger
readinteger
failedinteger
total_messagesinteger
first_message_atstring (date-time) | null
last_message_atstring (date-time) | null
timeseriesarray of object
Show 5 item attributes
datestring
receivedinteger
sentinteger
readinteger
failedinteger
by_sourcearray of object
Show 2 item attributes
sourcestring
countinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/analytics/inbox/conversations/{conversationId}
curl "https://api.socialit.com/v1/analytics/inbox/conversations/CONVERSATION_ID?from_date=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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
    }
  ]
}