List posts in a collection
Requires collections:read and posts:read. Campaign ids include
posts from all nested subgroups. Defaults to completed posts
(including posts mid-resync that still have prior data).
Supports the same post filters as GET /posts (link, account,
platform, posted date range, Siftsy score, sentiment percentages).
All filters combine with AND.
Each request walks the team’s posts for a bounded time. When a
collection is sparse, a page can come back with fewer than limit
posts (even zero), hasMore: true, a nextCursor, and
meta.partialPage: true. Keep following nextCursor until
hasMore is false.
Rate class collection_posts (60 / minute, 1,000 / day per key).
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
Query parameters
Only posts with this URL. Scheme, www., query string, hash, trailing
slash and case are ignored, so tracking parameters never break a
match. Comma-separate or repeat the parameter to match several links.
Only posts from this creator. Matches the creator username or display
name, case-insensitive; a leading @ is optional. Comma-separate or
repeat the parameter to match several accounts.
Only posts carrying this content tag (case-insensitive, leading #
optional). Comma-separate or repeat the parameter to match any of
several tags.
Only posts from these platforms (case-insensitive, e.g. instagram,
tiktok, youtube). Comma-separate to match several.
Only posts published on or after this date (ISO 8601).
Only posts published on or before this date (ISO 8601).
Only posts whose Siftsy data changed on or after this date (ISO 8601). Useful for incremental syncs.
Only posts with a Siftsy score at or above this value (0–10). Posts that have not been scored yet are excluded.
Only posts with a Siftsy score at or below this value (0–10).
Only posts where sentimentMix.positivePercent is at or above this value (0–100).
Only posts where sentimentMix.positivePercent is at or below this value (0–100).
Only posts where sentimentMix.leanPositivePercent is at or above this value (0–100).
Only posts where sentimentMix.leanPositivePercent is at or below this value (0–100).
Only posts where sentimentMix.neutralPercent is at or above this value (0–100).
Only posts where sentimentMix.neutralPercent is at or below this value (0–100).
Only posts where sentimentMix.leanNegativePercent is at or above this value (0–100).
Only posts where sentimentMix.leanNegativePercent is at or below this value (0–100).
Only posts where sentimentMix.negativePercent is at or above this value (0–100).
Only posts where sentimentMix.negativePercent is at or below this value (0–100).
Response
Post page (newest first)
