Menu

Referência da API · Social Insights

Seguidores

social_insights · followers · 1 operação

GET/v1/social-insights/followers

Get today's follower total of each connected social network

social_insights.followers.get

LeituraIdempotenteDesde 2026-11-01

Returns the follower total of each connected network right now, read live (one external quota unit per network read): Instagram followers of the account, Facebook Page followers, TikTok followers and YouTube subscribers (YouTube rounds them to three significant figures above 1,000). Each network comes with platform_id, connection_name, status and followers: ok with the number, error with the reason (an expired connection, a missing permission; the others still return) or unavailable for LinkedIn, whose follower count MB Suite's connection does not read. date is today in the organization's time zone and as_of the moment of the read. With no network connected it returns an empty list. Use it for the current audience size; the change in a period (new followers, subscribers gained) is in social_insights.insights.get. 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 or fields 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_followers_getNa superfície completa; na compacta, mb_execute_operation com id: "social_insights.followers.get".

Custo declarado: até 20 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

Sem parâmetros.

Resposta

datestring
as_ofnumber
networksarray<object>

Erros

Exemplo

curl "https://api.mb-suite.com/v1/social-insights/followers" \
  -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.