Get started

Quickstart

1

Create an API key

In the Siftsy dashboard, go to Team Settings → API. You need to be a team admin on a Powerhouse or Enterprise plan. This key is for the Siftsy Analyst API.

Create a key and copy it right away. For security, Siftsy only shows the full key once. The default scopes are read-only; if this key should also add content, turn on posts:write / accounts:write when you create it.

2

Check that it works

Replace YOUR_API_KEY with the key you copied.

curl -sS \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.siftsy.app/analyst/v1/me"

A successful response shows which team the key belongs to, what it can access, and its current rate-limit position (rateLimit) — a scheduled sync can check this before it starts. See Rate limits.

3

See your collections

curl -sS \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.siftsy.app/analyst/v1/collections"

This returns your campaigns and the groups inside them, just as they appear in Siftsy.

4

Get your posts

curl -sS \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.siftsy.app/analyst/v1/posts?limit=100"

Posts come back in pages of up to 100. If there are more, the response includes a nextCursor — pass it back as cursor to get the next page.

5

Narrow it down

Add filters to get exactly the posts you want — for example, TikTok posts from one creator with a Siftsy score of 7 or higher:

curl -sS \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.siftsy.app/analyst/v1/posts?account=@nike&platform=tiktok&min_score=7"

You can also filter by post link, posted date, and sentiment percentages. See Filtering posts for the full list.

Next steps

  • Read Filtering posts to find posts by link, account, platform, date, score, or sentiment.
  • Read Retrieving comments to sample the comments behind an analysis (by mix-bar bucket). This is evidence, not a full comment export.
  • Read Post analysis for the content + comment analysis object.
  • Read Scores to understand what the numbers mean.
  • Read Adding content to add posts or a public account from a pipeline (needs the write scopes).
  • See BI sync for a recommended order when loading everything into a warehouse or dashboard.
  • Browse the API reference for every endpoint and filter.