Insights

Get the organic performance of the connected social networks

social_insights.insights.get

Returns the organic performance of the organization's connected social networks (Instagram, Facebook Page, YouTube, LinkedIn Page, TikTok), read live from each network on every call: it can take a few seconds and each network read counts against the external quota. period is 7d, 14d or 30d (default): that many complete days ending yesterday, compared with the same number of days right before; range has the exact dates of both. For other dates send from and to together (YYYY-MM-DD, inclusive, up to 92 days so any calendar month or quarter fits, to not after today in the organization's time zone; today's data is partial): they replace period, the comparison is the same number of days right before, and period comes back as custom (400 range_incomplete, invalid_date, invalid_range, range_in_future or range_too_long otherwise). platforms: one entry per connected network with connection_name, the period's totals and the previous period's (comparison, null if it could not be read) keyed by the network's own metric ids, kept as they are (Instagram reach and total_interactions, Facebook page_post_engagements, YouTube views and estimated minutes watched, LinkedIn impressions, TikTok views and follower_count: the exact ids are the keys of totals), and a daily series with one row per day of the period (a day the network did not return comes with date only). LinkedIn brings no follower count: MB Suite cannot read it with its connection, so it is left out instead of a 0. extended=true adds more metrics to each network's totals, asked in the same requests (no extra calls): Instagram views, likes, comments, shares, saves, replies, accounts_engaged, profile_links_taps, unfollows; Facebook page_actions_post_reactions_love_total, page_actions_post_reactions_wow_total, page_actions_post_reactions_haha_total, page_actions_post_reactions_sorry_total, page_actions_post_reactions_anger_total; TikTok posts_published (videos published in the range); YouTube subscribersLost; LinkedIn adds nothing. Instagram also gets website_clicks (taps on the website link of its profile), asked apart in one more read of the period and of the comparison (one more external quota unit): Meta no longer lists it in its reference, so when Meta rejects it or does not give it the key is left out of totals (never a 0) and the rest of Instagram is not affected. Instagram's total-only metrics (all of them but reach) have no daily breakdown: read them in totals, their series values are 0. On Instagram, a range longer than 30 days is read in 30-day windows and summed: accounts_engaged (unique accounts) is then an upper bound. A network whose read failed (expired connection, missing permission, its API temporarily down) comes with error and empty totals; the others still return. aggregated: the screen's KPIs across networks, total_followers as the screen shows it (it mixes new followers on Instagram and YouTube with TikTok's total; none on Facebook), and apart new_followers (new in the period: Instagram and YouTube) and audience (total followers today: TikTok), total_reach, total_engagement and engagement_rate (engagement over reach, in %), their % change against the previous period (null without a baseline) and 7-point daily sparklines (new_followers_spark only with new followers; followers_spark as the screen draws it). published_posts: up to 20 posts the Social Planner published in the period, with the first 100 characters of their text (every post with its own metrics is social_insights.posts.list; each network's current follower total, social_insights.followers.get). With no network connected it returns empty platforms and zeroed KPIs, never an error; networks are connected in MB Suite (Settings → Integrations). Requires view access to Social Insights. With LinkedIn, TikTok or YouTube, their terms limit it through the API and the MCP: what they do not allow answers 403 platform_terms_restricted, and their records are left out of the response (the permissions guide lists what each platform allows).

Escopo

social_insights:read

Permissão

Ver o módulo

Tool do MCP

social_insights_insights_getNa superfície completa; na compacta, mb_execute_operation com id: "social_insights.insights.get".

Custo declarado: até 92 leituras e 0 escritas por chamada (contam na cota diária). Usa uma plataforma externa (meta): conta na cota de operações externas.

Parâmetros

Resposta

Erros

Exemplo

curl "https://api.mb-suite.com/v1/social-insights" \
  -H "Authorization: Bearer $MB_API_KEY"

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar. Na prática esta operação não é simulada (usa outra plataforma): responde 409 sandbox_external_unavailable.