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).
- Escopo
social_competitors:read- Permissão
- Ver o módulo
- Tool do MCP
social_competitors_self_getNa superfície completa; na compacta,mb_execute_operationcomid: "social_competitors.self.get".
Custo declarado: até 1 leituras e 0 escritas por chamada (contam na cota diária).
Parâmetros
Sem parâmetros.
Resposta
measuredbooleannamestringprofile_metaobjectmetrics_by_platformobjectupdated_atnumber | nulllast_errorstring | nullErros
Exemplo
curl "https://api.mb-suite.com/v1/social-competitors/self" \
-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.
curl "https://api.mb-suite.com/v1/social-competitors/self" \
-H "Authorization: Bearer $MB_TEST_KEY"