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).
- Escopo
social_competitors:read- Permissão
- Ver o módulo
- Tool do MCP
social_competitors_posts_listNa superfície completa; na compacta,mb_execute_operationcomid: "social_competitors.posts.list".
Custo declarado: até 401 leituras e 0 escritas por chamada (contam na cota diária).
Parâmetros
limitintegerqueryopcionalHow many items this page brings at most (see the maximum and the default in the schema).
Padrão: 50
cursorstringqueryopcionalThe next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.
competitor_idstringqueryopcionalCompetitor id, or "__self__" for the organization's own brand.
platformenumqueryopcionalOnly this network: instagram, youtube.
Valores: instagram, youtube
Resposta
dataarray<object>has_morebooleannext_cursorstringErros
Exemplo
curl "https://api.mb-suite.com/v1/social-competitors/posts" \
-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/posts" \
-H "Authorization: Bearer $MB_TEST_KEY"