Your brand

Get your own brand's latest metrics

social_competitors.self.get

Returns the organization's own brand as measured for the competitor benchmark: the latest metrics per platform (metrics_by_platform, same fields as a snapshot) and public identity (profile_meta) of its own connected Instagram, Facebook page and YouTube channel, with when they were read (updated_at) and the last error. It is refreshed together with every competitor data read. measured is false when it was never read yet (no competitor data read so far, or no own social account connected). Its history is in social_competitors.snapshots.list with competitor_id __self__. Requires view access to Competitors. With YouTube, 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).

Scope

social_competitors:read

Permission

View the module

MCP tool

social_competitors_self_getOn the full surface; on the compact one, mb_execute_operation with id: "social_competitors.self.get".

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

Parameters

No parameters.

Response

Errors

Example

curl "https://api.mb-suite.com/v1/social-competitors/self" \
  -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-competitors/self" \
  -H "Authorization: Bearer $MB_TEST_KEY"