Posts

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

Scope

social_competitors:read

Permission

View the module

MCP tool

social_competitors_posts_listOn the full surface; on the compact one, mb_execute_operation with id: "social_competitors.posts.list".

Declared cost: up to 401 reads and 0 writes per call (they count against the daily quota).

Parameters

Response

Errors

Example

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

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

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