Siftsy Analyst API

List posts

Cursor-paginated posts for the key's team, newest first. Defaults to completed posts; use `status` to opt into other buckets. Narrow the result with any combination of filters — by post link, creator account, platform, posted date range, Siftsy score (e.g. `min_score=7`), or sentiment percentages (e.g. `min_positive_percent=60`, `max_negative_percent=10`). All filters combine with AND. Active filters are echoed back in `meta.filters`. Filters are applied while the page is filled, so pages stay close to `limit`.

Authentication

AuthorizationBearer

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

OR
X-Api-Keystring
API Key authentication via header

Query parameters

cursorstringOptional
limitintegerOptional1-100Defaults to 25
statusenumOptionalDefaults to complete
collectionIdstringOptional

Restrict to a collection (campaigns include nested subgroups). collection_id is accepted as an alias. If both are set they must match. The applied id is echoed in meta.collectionId.

collection_idstringOptional

Alias of collectionId. Restrict to a collection (campaigns include nested subgroups).

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
datalist of objectsOptional
metaobjectOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error