> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://api.docs.siftsy.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://api.docs.siftsy.com/_mcp/server.

# Scan a selection for posts that stand out

POST https://api.siftsy.app/analyst/v1/posts/scan
Content-Type: application/json

Requires `posts:read`. One row per post across a selection (up to
1,000 posts), compared with the selection's own baseline — the
comment-weighted rollup of the same posts, the same math as the
dashboard's combined-by-account rows. Every number is a stored post
score; nothing is rescored and no comments are loaded.

Posts with at least 10 analyzed comments get `flags` (posts under 10
are `lowSample: true` with no flags). `meta.flagRules` spells out
each rule:

- `negative_sentiment`: sentiment under 4.5
- `below_baseline` / `above_baseline`: sentiment 1.5+ below / above the baseline
- `commenters_arguing`: 25%+ of comments in the debating or fighting
  consensus bands — commenters arguing with **each other**, whatever
  they think of the post
- `off_topic`: relevance under 4.5
- `content_topic_gap`: content and topic scores 2+ points apart
- `high_engagement_negative`: engagement rate in the selection's top
  quarter while sentiment is under 4.5

Flags say where to look; `POST /analyses` on those posts says why.
`flags` in the body keeps only posts with any of the listed flags.
`engagement.engagementRate` is the stored rate, or (likes +
comments + shares + saves) / views when none is stored.

JSON pages with `limit` / `cursor` (each page re-resolves the
selection). `format=csv` returns every row in one call.

Rate class `posts_scan` (20 / minute, 500 / day per key).


Reference: https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/scan-posts

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.
- `X-Api-Key` header (required) — API Key authentication via header

## Servers

- `https://api.siftsy.app/analyst/v1` (Production, default)
- `http://localhost:3000/analyst/v1` (Local development)

## Request

### Body (application/json)

This endpoint expects a ScanPostsRequest.

- `selection` (AnalysisSelection, required) — Which content the analysis covers. Provide exactly one of `postIds` or `posts`; `collectionId` may stand alone or be combined with `posts` filters to narrow within the collection. Resolves to at most 1,000 posts (newest first).
- `sort` (ScanPostsRequestSort, optional) — A field name, or `{ by, order }`. Default `postedAt` descending; other fields default ascending (worst first for scores).
- `flags` (list of enum, optional) — Keep only posts with any of these flags.
  - Allowed values: `negative_sentiment`, `below_baseline`, `above_baseline`, `commenters_arguing`, `off_topic`, `content_topic_gap`, `high_engagement_negative`
- `limit` (integer, optional, default: 25)
- `cursor` (string, optional)
- `format` (enum, optional, default: json)
  - Allowed values: `json`, `csv`

## Response

### 200

Scan rows (JSON, paged) or every row as CSV

- `data` (list of ScanRow, optional)
- `meta` (EnvelopeScanMeta, optional)

## Errors

### 400 Bad Request Error

Invalid request

- `any`

### 403 Forbidden Error

Missing required scope

- `any`

### 404 Not Found Error

Resource not found

- `any`

### 429 Too Many Requests Error

A per-minute cap, a per-day budget, or the daily transfer cap was exceeded. `error.message` is `Rate limit exceeded`, `Daily request limit exceeded`, or `Daily transfer limit exceeded`. Honor `Retry-After` (next UTC minute for burst caps; UTC midnight for daily budgets). Sized for a scheduled BI refresh: burst caps that a sequential loop cannot trip, daily budgets that fit eight full refreshes a day of a 500-post workspace or one full refresh plus hourly incrementals. Defaults: 300/minute and 10,000/day globally, with class budgets for per-post comment samples (120/min, 1,000/day), analysis-wide comment samples (20/min, 300/day), collection posts (60/min, 1,000/day), analysis reads (60/min, 2,000/day), analysis create (10/min, 100/day), AI search (2/min, 10/day), adding posts (10/min, 200/day), adding accounts (2/min, 20/day), refreshing posts (10/min, 200/day), and content job polls (60/min, 2,000/day). Daily transfer cap 500 MB.

- `any`

## Types

### AnalysisSelection

Which content the analysis covers. Provide exactly one of `postIds` or `posts`; `collectionId` may stand alone or be combined with `posts` filters to narrow within the collection. Resolves to at most 1,000 posts (newest first).

- `collectionId` (string, optional) — Only posts in this collection (and its sub-collections).
- `postIds` (list of string, optional) — Explicit post ids. Cannot be combined with `collectionId` or `posts`.
- `posts` (map from string to any, optional) — The same filters accepted by `GET /posts`: `link`, `account`, `tag`, `platform`, `posted_since`, `posted_until`, `updated_since`, `min_score` / `max_score`, the bucket percentage ranges (`min_positive_percent`, …), and `status` (`complete` by default).

### ScanPostsRequestSort

A field name, or `{ by, order }`. Default `postedAt` descending; other fields default ascending (worst first for scores).

- string
- ScanPostsRequestSort1

### ScanRow

A post with the keys analysts join on (`postId`, `link`, `platform`, `account`, `postedAt`, `collectionIds`, `tags`) and its stored scores and mix bars.

- `postId` (string, optional)
- `link` (string, optional, nullable)
- `platform` (string, optional, nullable)
- `account` (string, optional, nullable) — Creator handle, lowercase, without `@` (the same key as `by: account` breakdown groups)
- `accountName` (string, optional, nullable)
- `postedAt` (string, optional, nullable) — ISO-8601
- `title` (string, optional, nullable)
- `postType` (string, optional, nullable)
- `status` (string, optional, nullable)
- `tags` (list of string, optional)
- `collectionIds` (list of string, optional)
- `totalComments` (double, optional, nullable)
- `engagement` (RowEngagement, optional)
- `scores` (RowScores, optional) — Stored 1–10 scores for the team's selected score version.
- `mix` (MixSet, optional) — Every dimension is always present with all five buckets; buckets are `null` when unknown, so table columns never shift.
- `lowSample` (boolean, optional) — Fewer than 10 analyzed comments; never flagged.
- `flags` (list of enum, optional)
  - Allowed values: `negative_sentiment`, `below_baseline`, `above_baseline`, `commenters_arguing`, `off_topic`, `content_topic_gap`, `high_engagement_negative`
- `baselineDelta` (ScanRowBaselineDelta, optional)

### EnvelopeScanMeta

- `selection` (AnalysisSelection, optional) — Which content the analysis covers. Provide exactly one of `postIds` or `posts`; `collectionId` may stand alone or be combined with `posts` filters to narrow within the collection. Resolves to at most 1,000 posts (newest first).
- `selectionTruncated` (boolean, optional)
- `postCount` (integer, optional)
- `matchedCount` (integer, optional) — Rows after the `flags` filter
- `baseline` (Rollup, optional) — Comment-weighted rollup of post rows (the dashboard's combined-by-account math).
- `flagCounts` (map from string to integer, optional)
- `flagRules` (map from string to any, optional)
- `sort` (map from string to any, optional)
- `limit` (integer, optional)
- `hasMore` (boolean, optional)
- `nextCursor` (string, optional, nullable)
- `csvColumns` (list of string, optional) — The column headers `format=csv` would return.

### ScanPostsRequestSort1

- `by` (enum, optional)
  - Allowed values: `postedAt`, `siftsyScore`, `sentiment`, `relevance`, `consensus`, `content`, `topic`, `totalComments`, `views`, `engagementRate`, `flagCount`, `sentimentDelta`
- `order` (enum, optional)
  - Allowed values: `asc`, `desc`

### RowEngagement

- `views` (double, optional, nullable)
- `likes` (double, optional, nullable)
- `comments` (double, optional, nullable)
- `shares` (double, optional, nullable)
- `saves` (double, optional, nullable)
- `engagementRate` (double, optional, nullable) — Percent. On post rows, computed from the counts when none is stored; on rollups, pooled over posts that report views.

### RowScores

Stored 1–10 scores for the team's selected score version.

- `siftsyScore` (double, optional, nullable)
- `sentiment` (double, optional, nullable)
- `relevance` (double, optional, nullable)
- `consensus` (double, optional, nullable)
- `content` (double, optional, nullable)
- `topic` (double, optional, nullable)

### MixSet

Every dimension is always present with all five buckets; buckets are `null` when unknown, so table columns never shift.

- `sentiment` (ScoreBuckets, optional) — Five-bucket percentage breakdown. Dashboard labels per dimension — Sentiment: Positive / Lean positive / Neutral / Lean negative / Negative. Content: Supportive (positive) / Receptive (leanPositive) / Split (neutral) / Skeptical (leanNegative) / Opposed (negative). Topic: Enthusiastic (positive) / Favorable (leanPositive) / Mixed (neutral) / Critical (leanNegative) / Hostile (negative). Relevance: On-topic (positive) / Relevant (leanPositive) / General (leanNegative) / Off-topic (negative). Consensus: Agreeing (positive) / Discussing (leanPositive) / Debating (leanNegative) / Fighting (negative). neutralPercent is typically unused for relevance and consensus.
- `relevance` (ScoreBuckets, optional) — Five-bucket percentage breakdown. Dashboard labels per dimension — Sentiment: Positive / Lean positive / Neutral / Lean negative / Negative. Content: Supportive (positive) / Receptive (leanPositive) / Split (neutral) / Skeptical (leanNegative) / Opposed (negative). Topic: Enthusiastic (positive) / Favorable (leanPositive) / Mixed (neutral) / Critical (leanNegative) / Hostile (negative). Relevance: On-topic (positive) / Relevant (leanPositive) / General (leanNegative) / Off-topic (negative). Consensus: Agreeing (positive) / Discussing (leanPositive) / Debating (leanNegative) / Fighting (negative). neutralPercent is typically unused for relevance and consensus.
- `consensus` (ScoreBuckets, optional) — Five-bucket percentage breakdown. Dashboard labels per dimension — Sentiment: Positive / Lean positive / Neutral / Lean negative / Negative. Content: Supportive (positive) / Receptive (leanPositive) / Split (neutral) / Skeptical (leanNegative) / Opposed (negative). Topic: Enthusiastic (positive) / Favorable (leanPositive) / Mixed (neutral) / Critical (leanNegative) / Hostile (negative). Relevance: On-topic (positive) / Relevant (leanPositive) / General (leanNegative) / Off-topic (negative). Consensus: Agreeing (positive) / Discussing (leanPositive) / Debating (leanNegative) / Fighting (negative). neutralPercent is typically unused for relevance and consensus.
- `content` (ScoreBuckets, optional) — Five-bucket percentage breakdown. Dashboard labels per dimension — Sentiment: Positive / Lean positive / Neutral / Lean negative / Negative. Content: Supportive (positive) / Receptive (leanPositive) / Split (neutral) / Skeptical (leanNegative) / Opposed (negative). Topic: Enthusiastic (positive) / Favorable (leanPositive) / Mixed (neutral) / Critical (leanNegative) / Hostile (negative). Relevance: On-topic (positive) / Relevant (leanPositive) / General (leanNegative) / Off-topic (negative). Consensus: Agreeing (positive) / Discussing (leanPositive) / Debating (leanNegative) / Fighting (negative). neutralPercent is typically unused for relevance and consensus.
- `topic` (ScoreBuckets, optional) — Five-bucket percentage breakdown. Dashboard labels per dimension — Sentiment: Positive / Lean positive / Neutral / Lean negative / Negative. Content: Supportive (positive) / Receptive (leanPositive) / Split (neutral) / Skeptical (leanNegative) / Opposed (negative). Topic: Enthusiastic (positive) / Favorable (leanPositive) / Mixed (neutral) / Critical (leanNegative) / Hostile (negative). Relevance: On-topic (positive) / Relevant (leanPositive) / General (leanNegative) / Off-topic (negative). Consensus: Agreeing (positive) / Discussing (leanPositive) / Debating (leanNegative) / Fighting (negative). neutralPercent is typically unused for relevance and consensus.

### ScanRowBaselineDelta

- `sentiment` (double, optional, nullable)
- `siftsyScore` (double, optional, nullable)

### Rollup

Comment-weighted rollup of post rows (the dashboard's combined-by-account math).

- `postCount` (integer, optional)
- `scoredPosts` (integer, optional)
- `totalComments` (integer, optional)
- `engagement` (RowEngagement, optional)
- `scores` (RowScores, optional) — Stored 1–10 scores for the team's selected score version.
- `mix` (MixSet, optional) — Every dimension is always present with all five buckets; buckets are `null` when unknown, so table columns never shift.

### ScoreBuckets

Five-bucket percentage breakdown. Dashboard labels per dimension — Sentiment: Positive / Lean positive / Neutral / Lean negative / Negative. Content: Supportive (positive) / Receptive (leanPositive) / Split (neutral) / Skeptical (leanNegative) / Opposed (negative). Topic: Enthusiastic (positive) / Favorable (leanPositive) / Mixed (neutral) / Critical (leanNegative) / Hostile (negative). Relevance: On-topic (positive) / Relevant (leanPositive) / General (leanNegative) / Off-topic (negative). Consensus: Agreeing (positive) / Discussing (leanPositive) / Debating (leanNegative) / Fighting (negative). neutralPercent is typically unused for relevance and consensus.

- `positivePercent` (double, optional, nullable)
- `leanPositivePercent` (double, optional, nullable)
- `neutralPercent` (double, optional, nullable)
- `leanNegativePercent` (double, optional, nullable)
- `negativePercent` (double, optional, nullable)

## Examples

### Only posts where commenters are arguing or off topic, as CSV

**Request**

```json
{
  "selection": {
    "posts": {
      "account": "@acme",
      "posted_since": "2026-09-01"
    }
  },
  "flags": [
    "commenters_arguing",
    "off_topic"
  ],
  "format": "csv"
}
```

**Response**

```json
{
  "data": [
    {
      "postId": "string",
      "link": "string",
      "platform": "string",
      "account": "string",
      "accountName": "string",
      "postedAt": "string",
      "title": "string",
      "postType": "string",
      "status": "string",
      "tags": [
        "string"
      ],
      "collectionIds": [
        "string"
      ],
      "totalComments": 1.1,
      "engagement": {
        "views": 1.1,
        "likes": 1.1,
        "comments": 1.1,
        "shares": 1.1,
        "saves": 1.1,
        "engagementRate": 1.1
      },
      "scores": {
        "siftsyScore": 1.1,
        "sentiment": 1.1,
        "relevance": 1.1,
        "consensus": 1.1,
        "content": 1.1,
        "topic": 1.1
      },
      "mix": {
        "sentiment": {
          "positivePercent": 1.1,
          "leanPositivePercent": 1.1,
          "neutralPercent": 1.1,
          "leanNegativePercent": 1.1,
          "negativePercent": 1.1
        },
        "relevance": {
          "positivePercent": 1.1,
          "leanPositivePercent": 1.1,
          "neutralPercent": 1.1,
          "leanNegativePercent": 1.1,
          "negativePercent": 1.1
        },
        "consensus": {
          "positivePercent": 1.1,
          "leanPositivePercent": 1.1,
          "neutralPercent": 1.1,
          "leanNegativePercent": 1.1,
          "negativePercent": 1.1
        },
        "content": {
          "positivePercent": 1.1,
          "leanPositivePercent": 1.1,
          "neutralPercent": 1.1,
          "leanNegativePercent": 1.1,
          "negativePercent": 1.1
        },
        "topic": {
          "positivePercent": 1.1,
          "leanPositivePercent": 1.1,
          "neutralPercent": 1.1,
          "leanNegativePercent": 1.1,
          "negativePercent": 1.1
        }
      },
      "lowSample": true,
      "flags": [
        "negative_sentiment"
      ],
      "baselineDelta": {
        "sentiment": 1.1,
        "siftsyScore": 1.1
      }
    }
  ],
  "meta": {
    "selection": {
      "collectionId": "col_launch",
      "posts": {
        "tag": "launch",
        "platform": "tiktok"
      }
    },
    "selectionTruncated": true,
    "postCount": 1,
    "matchedCount": 1,
    "baseline": {
      "postCount": 1,
      "scoredPosts": 1,
      "totalComments": 1,
      "engagement": {
        "views": 1.1,
        "likes": 1.1,
        "comments": 1.1,
        "shares": 1.1,
        "saves": 1.1,
        "engagementRate": 1.1
      },
      "scores": {
        "siftsyScore": 1.1,
        "sentiment": 1.1,
        "relevance": 1.1,
        "consensus": 1.1,
        "content": 1.1,
        "topic": 1.1
      },
      "mix": {
        "sentiment": {
          "positivePercent": 1.1,
          "leanPositivePercent": 1.1,
          "neutralPercent": 1.1,
          "leanNegativePercent": 1.1,
          "negativePercent": 1.1
        },
        "relevance": {
          "positivePercent": 1.1,
          "leanPositivePercent": 1.1,
          "neutralPercent": 1.1,
          "leanNegativePercent": 1.1,
          "negativePercent": 1.1
        },
        "consensus": {
          "positivePercent": 1.1,
          "leanPositivePercent": 1.1,
          "neutralPercent": 1.1,
          "leanNegativePercent": 1.1,
          "negativePercent": 1.1
        },
        "content": {
          "positivePercent": 1.1,
          "leanPositivePercent": 1.1,
          "neutralPercent": 1.1,
          "leanNegativePercent": 1.1,
          "negativePercent": 1.1
        },
        "topic": {
          "positivePercent": 1.1,
          "leanPositivePercent": 1.1,
          "neutralPercent": 1.1,
          "leanNegativePercent": 1.1,
          "negativePercent": 1.1
        }
      }
    },
    "flagCounts": {},
    "flagRules": {},
    "sort": {},
    "limit": 1,
    "hasMore": true,
    "nextCursor": "string",
    "csvColumns": [
      "string"
    ]
  }
}
```

**SDK Code**

```python Only posts where commenters are arguing or off topic, as CSV
import requests

url = "https://api.siftsy.app/analyst/v1/posts/scan"

payload = {
    "selection": { "posts": {
            "account": "@acme",
            "posted_since": "2026-09-01"
        } },
    "flags": ["commenters_arguing", "off_topic"],
    "format": "csv"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript Only posts where commenters are arguing or off topic, as CSV
const url = 'https://api.siftsy.app/analyst/v1/posts/scan';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"selection":{"posts":{"account":"@acme","posted_since":"2026-09-01"}},"flags":["commenters_arguing","off_topic"],"format":"csv"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Only posts where commenters are arguing or off topic, as CSV
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.siftsy.app/analyst/v1/posts/scan"

	payload := strings.NewReader("{\n  \"selection\": {\n    \"posts\": {\n      \"account\": \"@acme\",\n      \"posted_since\": \"2026-09-01\"\n    }\n  },\n  \"flags\": [\n    \"commenters_arguing\",\n    \"off_topic\"\n  ],\n  \"format\": \"csv\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Only posts where commenters are arguing or off topic, as CSV
require 'uri'
require 'net/http'

url = URI("https://api.siftsy.app/analyst/v1/posts/scan")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"selection\": {\n    \"posts\": {\n      \"account\": \"@acme\",\n      \"posted_since\": \"2026-09-01\"\n    }\n  },\n  \"flags\": [\n    \"commenters_arguing\",\n    \"off_topic\"\n  ],\n  \"format\": \"csv\"\n}"

response = http.request(request)
puts response.read_body
```

```java Only posts where commenters are arguing or off topic, as CSV
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.siftsy.app/analyst/v1/posts/scan")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"selection\": {\n    \"posts\": {\n      \"account\": \"@acme\",\n      \"posted_since\": \"2026-09-01\"\n    }\n  },\n  \"flags\": [\n    \"commenters_arguing\",\n    \"off_topic\"\n  ],\n  \"format\": \"csv\"\n}")
  .asString();
```

```php Only posts where commenters are arguing or off topic, as CSV
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.siftsy.app/analyst/v1/posts/scan', [
  'body' => '{
  "selection": {
    "posts": {
      "account": "@acme",
      "posted_since": "2026-09-01"
    }
  },
  "flags": [
    "commenters_arguing",
    "off_topic"
  ],
  "format": "csv"
}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp Only posts where commenters are arguing or off topic, as CSV
using RestSharp;

var client = new RestClient("https://api.siftsy.app/analyst/v1/posts/scan");
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"selection\": {\n    \"posts\": {\n      \"account\": \"@acme\",\n      \"posted_since\": \"2026-09-01\"\n    }\n  },\n  \"flags\": [\n    \"commenters_arguing\",\n    \"off_topic\"\n  ],\n  \"format\": \"csv\"\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift Only posts where commenters are arguing or off topic, as CSV
import Foundation

let headers = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = [
  "selection": ["posts": [
      "account": "@acme",
      "posted_since": "2026-09-01"
    ]],
  "flags": ["commenters_arguing", "off_topic"],
  "format": "csv"
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.siftsy.app/analyst/v1/posts/scan")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

### Example 2

**Request**

```json
{
  "selection": {
    "posts": {
      "account": "@acme",
      "posted_since": "2026-09-01"
    }
  },
  "flags": [
    "commenters_arguing",
    "off_topic"
  ],
  "format": "csv"
}
```

**Response**

```json
{
  "data": [
    {
      "postId": "string",
      "link": "string",
      "platform": "string",
      "account": "string",
      "accountName": "string",
      "postedAt": "string",
      "title": "string",
      "postType": "string",
      "status": "string",
      "tags": [
        "string"
      ],
      "collectionIds": [
        "string"
      ],
      "totalComments": 1.1,
      "engagement": {
        "views": 1.1,
        "likes": 1.1,
        "comments": 1.1,
        "shares": 1.1,
        "saves": 1.1,
        "engagementRate": 1.1
      },
      "scores": {
        "siftsyScore": 1.1,
        "sentiment": 1.1,
        "relevance": 1.1,
        "consensus": 1.1,
        "content": 1.1,
        "topic": 1.1
      },
      "mix": {
        "sentiment": {
          "positivePercent": 1.1,
          "leanPositivePercent": 1.1,
          "neutralPercent": 1.1,
          "leanNegativePercent": 1.1,
          "negativePercent": 1.1
        },
        "relevance": {
          "positivePercent": 1.1,
          "leanPositivePercent": 1.1,
          "neutralPercent": 1.1,
          "leanNegativePercent": 1.1,
          "negativePercent": 1.1
        },
        "consensus": {
          "positivePercent": 1.1,
          "leanPositivePercent": 1.1,
          "neutralPercent": 1.1,
          "leanNegativePercent": 1.1,
          "negativePercent": 1.1
        },
        "content": {
          "positivePercent": 1.1,
          "leanPositivePercent": 1.1,
          "neutralPercent": 1.1,
          "leanNegativePercent": 1.1,
          "negativePercent": 1.1
        },
        "topic": {
          "positivePercent": 1.1,
          "leanPositivePercent": 1.1,
          "neutralPercent": 1.1,
          "leanNegativePercent": 1.1,
          "negativePercent": 1.1
        }
      },
      "lowSample": true,
      "flags": [
        "negative_sentiment"
      ],
      "baselineDelta": {
        "sentiment": 1.1,
        "siftsyScore": 1.1
      }
    }
  ],
  "meta": {
    "selection": {
      "collectionId": "col_launch",
      "posts": {
        "tag": "launch",
        "platform": "tiktok"
      }
    },
    "selectionTruncated": true,
    "postCount": 1,
    "matchedCount": 1,
    "baseline": {
      "postCount": 1,
      "scoredPosts": 1,
      "totalComments": 1,
      "engagement": {
        "views": 1.1,
        "likes": 1.1,
        "comments": 1.1,
        "shares": 1.1,
        "saves": 1.1,
        "engagementRate": 1.1
      },
      "scores": {
        "siftsyScore": 1.1,
        "sentiment": 1.1,
        "relevance": 1.1,
        "consensus": 1.1,
        "content": 1.1,
        "topic": 1.1
      },
      "mix": {
        "sentiment": {
          "positivePercent": 1.1,
          "leanPositivePercent": 1.1,
          "neutralPercent": 1.1,
          "leanNegativePercent": 1.1,
          "negativePercent": 1.1
        },
        "relevance": {
          "positivePercent": 1.1,
          "leanPositivePercent": 1.1,
          "neutralPercent": 1.1,
          "leanNegativePercent": 1.1,
          "negativePercent": 1.1
        },
        "consensus": {
          "positivePercent": 1.1,
          "leanPositivePercent": 1.1,
          "neutralPercent": 1.1,
          "leanNegativePercent": 1.1,
          "negativePercent": 1.1
        },
        "content": {
          "positivePercent": 1.1,
          "leanPositivePercent": 1.1,
          "neutralPercent": 1.1,
          "leanNegativePercent": 1.1,
          "negativePercent": 1.1
        },
        "topic": {
          "positivePercent": 1.1,
          "leanPositivePercent": 1.1,
          "neutralPercent": 1.1,
          "leanNegativePercent": 1.1,
          "negativePercent": 1.1
        }
      }
    },
    "flagCounts": {},
    "flagRules": {},
    "sort": {},
    "limit": 1,
    "hasMore": true,
    "nextCursor": "string",
    "csvColumns": [
      "string"
    ]
  }
}
```

**SDK Code**

```python
import requests

url = "https://api.siftsy.app/analyst/v1/posts/scan"

payload = {
    "selection": { "posts": {
            "account": "@acme",
            "posted_since": "2026-09-01"
        } },
    "flags": ["commenters_arguing", "off_topic"],
    "format": "csv"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api.siftsy.app/analyst/v1/posts/scan';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"selection":{"posts":{"account":"@acme","posted_since":"2026-09-01"}},"flags":["commenters_arguing","off_topic"],"format":"csv"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.siftsy.app/analyst/v1/posts/scan"

	payload := strings.NewReader("{\n  \"selection\": {\n    \"posts\": {\n      \"account\": \"@acme\",\n      \"posted_since\": \"2026-09-01\"\n    }\n  },\n  \"flags\": [\n    \"commenters_arguing\",\n    \"off_topic\"\n  ],\n  \"format\": \"csv\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.siftsy.app/analyst/v1/posts/scan")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"selection\": {\n    \"posts\": {\n      \"account\": \"@acme\",\n      \"posted_since\": \"2026-09-01\"\n    }\n  },\n  \"flags\": [\n    \"commenters_arguing\",\n    \"off_topic\"\n  ],\n  \"format\": \"csv\"\n}"

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.siftsy.app/analyst/v1/posts/scan")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"selection\": {\n    \"posts\": {\n      \"account\": \"@acme\",\n      \"posted_since\": \"2026-09-01\"\n    }\n  },\n  \"flags\": [\n    \"commenters_arguing\",\n    \"off_topic\"\n  ],\n  \"format\": \"csv\"\n}")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.siftsy.app/analyst/v1/posts/scan', [
  'body' => '{
  "selection": {
    "posts": {
      "account": "@acme",
      "posted_since": "2026-09-01"
    }
  },
  "flags": [
    "commenters_arguing",
    "off_topic"
  ],
  "format": "csv"
}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.siftsy.app/analyst/v1/posts/scan");
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"selection\": {\n    \"posts\": {\n      \"account\": \"@acme\",\n      \"posted_since\": \"2026-09-01\"\n    }\n  },\n  \"flags\": [\n    \"commenters_arguing\",\n    \"off_topic\"\n  ],\n  \"format\": \"csv\"\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = [
  "selection": ["posts": [
      "account": "@acme",
      "posted_since": "2026-09-01"
    ]],
  "flags": ["commenters_arguing", "off_topic"],
  "format": "csv"
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.siftsy.app/analyst/v1/posts/scan")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```