Menú

Referencia de la API · Competidores

Tu marca

social_competitors · self · 1 operación

GET/v1/social-competitors/self

Get your own brand's latest metrics

social_competitors.self.get

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

Alcance
social_competitors:read
Permiso
Ver el módulo
Tool del MCP
social_competitors_self_getEn la superficie completa; en la compacta, mb_execute_operation con id: "social_competitors.self.get".

Costo declarado: hasta 1 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

Sin parámetros.

Respuesta

measuredboolean
namestring
profile_metaobject
metrics_by_platformobject
updated_atnumber | null
last_errorstring | null

Errores

Ejemplo

curl "https://api.mb-suite.com/v1/social-competitors/self" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl "https://api.mb-suite.com/v1/social-competitors/self" \
  -H "Authorization: Bearer $MB_TEST_KEY"