Historial de métricas

List the metrics history of competitors

social_competitors.snapshots.list

Lists metric snapshots, newest day first, paginated by cursor: one per platform every time the data was read (weekly, on demand, or when the screen refreshes stale data), so a day can have several. Filter by competitor_id (or __self__ for the organization's own brand), platform (instagram, facebook, youtube) and a date range (since/until, YYYY-MM-DD, inclusive). Each snapshot has followers, follows_count, total_posts, total_views, avg_likes, avg_comments, avg_views, engagement_rate (a decimal: 0.012 = 1.2%), posts_per_week, reels_share, talking_about (Facebook) and format_mix. Use it for growth over time or a benchmark between competitors. Filtering by platform without competitor_id is applied reading on until the page is full (up to 400 read per call), so a page brings fewer than limit only with has_more true at that limit: keep following next_cursor. 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 records 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_snapshots_listEn la superficie completa; en la compacta, mb_execute_operation con id: "social_competitors.snapshots.list".

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

Parámetros

Respuesta

Errores

Ejemplo

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