Publicaciones

List competitors' collected posts

social_competitors.posts.list

Lists the public posts collected from competitors (and from the organization's own brand, competitor_id __self__), newest published first, paginated by cursor. Only Instagram and YouTube bring posts (the 12 most recent per platform on each data read; Facebook brings page data only). Filter by competitor_id and platform (instagram, youtube). Each post has its text (content), media_type (image, video, carousel, shorts), media_product_type (feed, reels, video, shorts), media and thumbnail URLs, published_at, permalink and metrics (views, likes, comments) as of its last read. 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. 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_posts_listEn la superficie completa; en la compacta, mb_execute_operation con id: "social_competitors.posts.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/posts" \
  -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/posts" \
  -H "Authorization: Bearer $MB_TEST_KEY"