Sample comments behind a post analysis

Requires comments:read and posts:read. A sample of comments behind GET /posts/{postId}/analysis — the evidence for the mix bars, content topics, and messages. Hidden comments are excluded.

Siftsy is an analysis platform, not a comment exporter. Do not use this route to dump a full comment section. Prefer source=notables (engagement + relevance), content (grouped onto creator topics/messages), or all (union). Sampled rows include sampleReasons. meta.groups always lists content topic and message membership.

Narrow the sample with mix-bar buckets (sentiment, content, topic, relevance, consensus). Repeat a parameter or comma-separate to OR values within a dimension; different dimensions combine with AND.

Rate class comments (120 / minute, 1,000 / day per key) — enough to sample every post in a 500-post workspace once a day.

Requires `comments:read` and `posts:read`. A **sample of comments behind** `GET /posts/{postId}/analysis` — the evidence for the mix bars, content topics, and messages. Hidden comments are excluded. Siftsy is an analysis platform, not a comment exporter. Do not use this route to dump a full comment section. Prefer `source=notables` (engagement + relevance), `content` (grouped onto creator topics/messages), or `all` (union). Sampled rows include `sampleReasons`. `meta.groups` always lists content topic and message membership. Narrow the sample with mix-bar buckets (`sentiment`, `content`, `topic`, `relevance`, `consensus`). Repeat a parameter or comma-separate to OR values within a dimension; different dimensions combine with AND. Rate class `comments` (120 / minute, 1,000 / day per key) — enough to sample every post in a 500-post workspace once a day.

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

postIdstringRequired

Query parameters

cursorstringOptional

limitintegerOptional1-100Defaults to 25

sourceenumOptional

How to sample comments behind this analysis. Prefer notables (engagement + relevance), content (grouped onto creator topics/messages), or all (union). This is evidence, not a full-thread export.

Allowed values:

sentimentstringOptional

Only comments whose overall sentiment falls in these mix-bar buckets. Comma-separate or repeat to match several (positive,lean_positive). Values: positive, lean_positive, neutral, lean_negative, negative. Score version 3 uses a five-bucket split (neutral is 4.5–5.5); v1/v2 have no unused middle band.

Only comments whose overall sentiment falls in these mix-bar buckets. Comma-separate or repeat to match several (`positive,lean_positive`). Values: `positive`, `lean_positive`, `neutral`, `lean_negative`, `negative`. Score version 3 uses a five-bucket split (neutral is 4.5–5.5); v1/v2 have no unused middle band.

contentstringOptional

Only comments whose content sentiment (alignment with the post / creator) falls in these buckets. Same keys as sentiment. Score version 2+ comments; unscored comments are excluded.

topicstringOptional

Only comments whose topic sentiment (reception of the subject) falls in these buckets. Same keys as sentiment.

relevancestringOptional

Only comments in these relevance mix-bar buckets. Canonical keys match metrics (positive, lean_positive, neutral, lean_negative, negative). Dashboard labels also work: on_topic, relevant, general, off_topic.

Only comments in these relevance mix-bar buckets. Canonical keys match metrics (`positive`, `lean_positive`, `neutral`, `lean_negative`, `negative`). Dashboard labels also work: `on_topic`, `relevant`, `general`, `off_topic`.

consensusstringOptional

Only comments in these consensus mix-bar buckets. Canonical keys match metrics. Dashboard labels also work: agreeing, discussing, debating, fighting. Consensus is how the commenter is reacting to other commenters, not to the post.

Response

Sample of comments behind this analysis

datalist of objectsOptional

metaobjectOptional

Errors

400

Bad Request Error

404

Not Found Error

Rate class comments (120 / minute, 1,000 / day per key) — enough to sample every post in a 500-post workspace once a day.