Analysis sources · Brand Voice · API reference

GET/v1/social-brand-voice/sources

List what the brand voice analysis can learn from

social_brand_voice.sources.detect

ReadIdempotentSince 2026-11-01

Says what the Brand Voice analysis of the screen can read: how many general context documents of the organization profile are ready (Brand Voice's own documents do not count) and the connected Instagram accounts, YouTube channels, Facebook pages and LinkedIn pages, with their ids and names. It calls none of those platforms. Requires view access to Brand Voice. With LinkedIn 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_brand_voice:read
Permission: View the module
MCP tool: social_brand_voice_sources_detectOn the full surface; on the compact one, mb_execute_operation with id: "social_brand_voice.sources.detect".

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

Parameters

No parameters.

Response

context_documentsnumber

General context documents of the organization profile that are ready (Brand Voice's own documents do not count).

instagramarray<object>

youtubearray<object>

facebook_pagesarray<object>

linkedin_pagesarray<object>

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-brand-voice/sources" \
  -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-brand-voice/sources" \
  -H "Authorization: Bearer $MB_TEST_KEY"