Menu

Referência da API · Concorrentes

Sua marca

social_competitors · self · 1 operação

GET/v1/social-competitors/self

Get your own brand's latest metrics

social_competitors.self.get

LeituraIdempotenteDesde 2026-11-01

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_operation com id: "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

measuredboolean
namestring
profile_metaobject
metrics_by_platformobject
updated_atnumber | null
last_errorstring | null

Erros

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"