MB SuiteMB Suite
Menú

Referencia de la API · Inbox

Analítica

social_inbox · analytics · 1 operación

GET/v1/social-inbox/performance
GET/v1/social-inbox/performance

Get the Social Inbox team performance

social_inbox.analytics.performance

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

Alcance
social_inbox:read
Permiso
Ver el módulo
Tool del MCP
social_inbox_analytics_performanceEn la superficie completa; en la compacta, mb_execute_operation con id: "social_inbox.analytics.performance".

Costo declarado: hasta 366 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

start_datestringqueryrequerido

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

end_datestringqueryrequerido

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

Respuesta

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.

Errores

invalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Ejemplo

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

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

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