Followers

Get today's follower total of each connected social network

social_insights.followers.get

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

Scope

social_insights:read

Permission

View the module

MCP tool

social_insights_followers_getOn the full surface; on the compact one, mb_execute_operation with id: "social_insights.followers.get".

Declared cost: up to 20 reads and 0 writes per call (they count against the daily quota). Touches an external platform (meta): it counts against the external operations quota.

Parameters

No parameters.

Response

Errors

Example

curl "https://api.mb-suite.com/v1/social-insights/followers" \
  -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. In the practice organization this operation is not simulated (it reaches another platform): it answers 409 sandbox_external_unavailable.