Skip to navigation

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

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

OR
X-Api-Keystring
API Key authentication via header

Path parameters

collectionIdstringRequired

Query parameters

cursorstringOptional
limitintegerOptional1-100Defaults to 25
statusenumOptionalDefaults to complete
accountstringOptional

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.

tagstringOptional

Only posts carrying this content tag (case-insensitive, leading # optional). Comma-separate or repeat the parameter to match any of several tags.

platformstringOptional

Only posts from these platforms (case-insensitive, e.g. instagram, tiktok, youtube). Comma-separate to match several.

posted_sincedatetimeOptional

Only posts published on or after this date (ISO 8601).

posted_untildatetimeOptional

Only posts published on or before this date (ISO 8601).

updated_sincedatetimeOptional

Only posts whose Siftsy data changed on or after this date (ISO 8601). Useful for incremental syncs.

min_scoredoubleOptional0-10

Only posts with a Siftsy score at or above this value (0–10). Posts that have not been scored yet are excluded.

max_scoredoubleOptional0-10

Only posts with a Siftsy score at or below this value (0–10).

min_positive_percentdoubleOptional0-100

Only posts where sentimentMix.positivePercent is at or above this value (0–100).

max_positive_percentdoubleOptional0-100

Only posts where sentimentMix.positivePercent is at or below this value (0–100).

min_lean_positive_percentdoubleOptional0-100

Only posts where sentimentMix.leanPositivePercent is at or above this value (0–100).

max_lean_positive_percentdoubleOptional0-100

Only posts where sentimentMix.leanPositivePercent is at or below this value (0–100).

min_neutral_percentdoubleOptional0-100

Only posts where sentimentMix.neutralPercent is at or above this value (0–100).

max_neutral_percentdoubleOptional0-100

Only posts where sentimentMix.neutralPercent is at or below this value (0–100).

min_lean_negative_percentdoubleOptional0-100

Only posts where sentimentMix.leanNegativePercent is at or above this value (0–100).

max_lean_negative_percentdoubleOptional0-100

Only posts where sentimentMix.leanNegativePercent is at or below this value (0–100).

min_negative_percentdoubleOptional0-100

Only posts where sentimentMix.negativePercent is at or above this value (0–100).

max_negative_percentdoubleOptional0-100

Only posts where sentimentMix.negativePercent is at or below this value (0–100).

Response

Post page (newest first)

datalist of objectsOptional
metaobjectOptional

Errors

400
Bad Request Error
404
Not Found Error