List posts in a collection | Siftsy Analyst API

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.

Rate class collection_posts (60 / minute, 1,000 / day per key).

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

X-Api-Keystring

API Key authentication via header

Path parameters

collectionIdstringRequired

Query parameters

cursorstringOptional

limitintegerOptional1-100Defaults to 25

statusenumOptionalDefaults to complete

linkstringOptional

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.

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