Add a public account's recent posts

curl -X POST https://api.siftsy.app/analyst/v1/content/accounts/add \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "account": {
    "url": "https://www.instagram.com/dove/"
  },
  "filters": {
    "limit": 100,
    "keywords": [
      {
        "term": "scrub",
        "match": "includes"
      }
    ]
  },
  "dryRun": true
}'

{
  "data": {
    "id": "cj_5f2c1a9e3b7d4c0e8a1f2b3c4d5e6f70",
    "kind": "posts",
    "status": "syncing",
    "teamId": "team_2f8c1a",
    "dryRun": false,
    "collections": [
      {
        "id": "col_launch",
        "name": "Q4 Launch",
        "type": "campaign",
        "created": false
      }
    ],
    "tags": [
      "launch",
      "paid"
    ],
    "credits": {
      "source": "auto",
      "perPost": 1,
      "reserved": 2,
      "settled": 0,
      "refunded": 0
    },
    "counts": {
      "requested": 3,
      "accepted": 2,
      "skipped": 0,
      "rejected": 1,
      "syncing": 2,
      "complete": 0,
      "failed": 0
    },
    "pollAfterMs": 5000,
    "createdAt": "2026-09-13T22:10:00.000Z",
    "updatedAt": "2026-09-13T22:10:00.000Z",
    "completedAt": null,
    "expiresAt": "2026-10-13T22:10:00.000Z",
    "accepted": [
      {
        "link": "https://www.tiktok.com/@dove/video/7412345678901234567",
        "postId": "post_01j9y",
        "postStatus": "fetching"
      },
      {
        "link": "https://www.instagram.com/reel/C9AbCdEfGhI/",
        "postId": "post_01j9z",
        "postStatus": "fetching"
      }
    ],
    "skipped": [],
    "rejected": [
      {
        "link": "https://example.com/not-social",
        "reason": "unsupported_platform"
      }
    ]
  },
  "meta": {
    "status": "string",
    "pollAfterMs": 1,
    "replayed": true
  }
}

Requires accounts:write (opt-in when the key is created). Discovers the recent public posts of one account URL (TikTok, Instagram, YouTube, Facebook page, LinkedIn, X), applies filters, and adds the matching posts to the team — the same as adding an account in the Siftsy app. Discovery runs in the background: responds 202 with status: discovering; poll GET /content/jobs/{jobId}.

Filters are the ones the app offers: since / until, limit (default 20, max 100), keywords (includes / exact / excludes on the caption), plus minViews, minLikes, and postType. You cannot hand-pick individual posts beyond these filters — use POST /content/posts/add for that.

Order of operations: the request validates, resolves the target team and collections, runs the replay check, saves the account on the team, and returns the job as discovering. A worker then pulls the account’s recent posts newest-first (since / until / limit / keywords at the source, retried up to 3 times), applies minViews / minLikes / postType, dedupes, cuts to limit, and hands the links to the same dedupe → fund check → reserve + create → queue path as POST /content/posts/add, moving the job to syncing. A discovery failure leaves the job failed with an error and no charge.

Credits are reserved only for posts that pass the filters and are not already on the team. Set dryRun: true to discover and price without adding anything: the job completes with discovered[] and credits.estimated.

collections, tags, teamId, credits, and capture behave as in POST /content/posts/add. Rate class content_add_accounts (2 / minute, 20 / day per key).

Requires `accounts:write` (opt-in when the key is created). Discovers the recent public posts of one account URL (TikTok, Instagram, YouTube, Facebook page, LinkedIn, X), applies `filters`, and adds the matching posts to the team — the same as adding an account in the Siftsy app. Discovery runs in the background: responds `202` with `status: discovering`; poll `GET /content/jobs/{jobId}`. Filters are the ones the app offers: `since` / `until`, `limit` (default 20, max 100), `keywords` (includes / exact / excludes on the caption), plus `minViews`, `minLikes`, and `postType`. You cannot hand-pick individual posts beyond these filters — use `POST /content/posts/add` for that. Order of operations: the request validates, resolves the target team and `collections`, runs the replay check, saves the account on the team, and returns the job as `discovering`. A worker then pulls the account's recent posts newest-first (`since` / `until` / `limit` / `keywords` at the source, retried up to 3 times), applies `minViews` / `minLikes` / `postType`, dedupes, cuts to `limit`, and hands the links to the same dedupe → fund check → reserve + create → queue path as `POST /content/posts/add`, moving the job to `syncing`. A discovery failure leaves the job `failed` with an `error` and no charge. Credits are reserved only for posts that pass the filters and are not already on the team. Set `dryRun: true` to discover and price without adding anything: the job completes with `discovered[]` and `credits.estimated`. `collections`, `tags`, `teamId`, `credits`, and `capture` behave as in `POST /content/posts/add`. Rate class `content_add_accounts` (2 / minute, 20 / 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

Request

This endpoint expects an object.

accountobjectRequired

filtersobjectOptional

The same account filters offered in the Siftsy app.

dryRunbooleanOptionalDefaults to false

Discover and price the matching posts without adding or charging

teamIdstringOptional

Enterprise keys only — a sub-team of the key’s enterprise to add to

collectionslist of objectsOptional

tagslist of stringsOptional

creditsobjectOptional

captureobjectOptional

Response

Identical request replayed; existing job returned (meta.replayed: true)

dataobjectOptional

metaobjectOptional

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error

collections, tags, teamId, credits, and capture behave as in POST /content/posts/add. Rate class content_add_accounts (2 / minute, 20 / day per key).