Analytics · Inbox · API reference

GET/v1/social-inbox/performance

Get the Social Inbox team performance

social_inbox.analytics.performance

ReadIdempotentSince 2026-11-01

Returns the inbox performance between start_date and end_date (YYYY-MM-DD, UTC days, up to 366): items received, replied and resolved, items moved to Spam by hand (spam_marked; what the inbox sends to Spam by itself when a message arrives does not count), the average first response time of people (ms; automatic replies do not count), the same per platform, replies and resolutions per agent (people and AI Community Managers, ai-<position_id>) and a daily series (spam_marked per day too). Built from daily aggregates: it does not read the items. Requires view access to the Social Inbox. With LinkedIn or TikTok, their terms limit it through the API and the MCP: what they do not allow answers 403 platform_terms_restricted, and their fields are left out of the response (the permissions guide lists what each platform allows).

Scope: social_inbox:read
Permission: View the module
MCP tool: social_inbox_analytics_performanceOn the full surface; on the compact one, mb_execute_operation with id: "social_inbox.analytics.performance".

Declared cost: up to 366 reads and 0 writes per call (they count against the daily quota).

Parameters

start_datestringqueryrequired

First day, YYYY-MM-DD (UTC days, as the daily aggregates are stored).

end_datestringqueryrequired

Last day, YYYY-MM-DD (inclusive; up to 366 days from start_date).

Response

range_startstring

First day of the range (YYYY-MM-DD, UTC).

range_endstring

Last day of the range (YYYY-MM-DD, UTC).

receivednumber

Items received.

repliednumber

Items replied.

resolvednumber

Items resolved.

spam_markednumber

Items someone moved to Spam in the range, by hand in the inbox or with social_inbox.items.mark_spam (marking a whole conversation counts each of its items), counted on the UTC day they were marked. What the inbox sends to Spam by itself when a message arrives (the AI analyst or a rule) does not count, and taking an item out of Spam does not subtract.

avg_first_response_msnumber | null

Average time to the first reply by a person (ms); null without replies in the range.

received_by_platformobject

Received per network (facebook, instagram, linkedin, tiktok).

replied_by_platformobject

Replied per network.

avg_first_response_by_platformobject

Average first reply per network (ms).

agentsarray<object>

Replies and resolutions per agent.

dailyarray<object>

One row per day of the range.

Errors

invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Example

curl "https://api.mb-suite.com/v1/social-inbox/performance?start_date=START_DATE&end_date=END_DATE" \
  -H "Authorization: Bearer $MB_API_KEY"

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl "https://api.mb-suite.com/v1/social-inbox/performance?start_date=START_DATE&end_date=END_DATE" \
  -H "Authorization: Bearer $MB_TEST_KEY"