> 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.

# Break a selection down by account, platform, tag, type, collection, or period

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

Requires `posts:read` (`by: collection` also needs
`collections:read`). Rolls a selection (up to 1,000 posts) up by
`account`, `platform`, `tag`, `contentType`, `collection`, `week`
(Monday, UTC, by post date), or `month`. Each group is the
comment-weighted rollup of its posts' stored scores — the
dashboard's combined-by-account math — with its share of the
selection's posts and comments and its difference from the whole
selection (`meta.overall`).

A post with several tags or collections counts once in each, so tag
and collection groups can add up to more than the selection
(`meta.multiMembership: true`). Posts with no date group as
`undated`.

Default sort: `postCount` descending, or `key` ascending for
`week` / `month`. JSON returns up to `limit` groups (default 50,
max 200); `format=csv` returns every group.

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


Reference: https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/breakdown-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 BreakdownRequest.

- `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).
- `by` (enum, required)
  - Allowed values: `account`, `platform`, `tag`, `contentType`, `collection`, `week`, `month`
- `sort` (BreakdownRequestSort, optional)
- `limit` (integer, optional, default: 50)
- `format` (enum, optional, default: json)
  - Allowed values: `json`, `csv`

## Response

### 200

Breakdown groups (JSON) or every group as CSV

- `data` (list of BreakdownGroup, optional)
- `meta` (EnvelopeBreakdownMeta, 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).

### BreakdownRequestSort

- string
- BreakdownRequestSort1

### BreakdownGroup

- `key` (string, optional) — Stable group key (`tiktok::acme`, `launch`, a collection id; `2026-09-07` for a week, `2026-09-01` for a month — the same period keys as the timeline)
- `label` (string, optional)
- `platform` (string, optional) — `by: account` only
- `account` (string, optional, nullable) — `by: account` only
- `collectionId` (string, optional) — `by: collection` only
- `postCount` (integer, optional)
- `totalComments` (integer, optional)
- `share` (BreakdownGroupShare, 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.
- `baselineDelta` (BreakdownGroupBaselineDelta, optional) — Difference from the whole selection (`meta.overall`).
- `latestPostedAt` (string, optional, nullable)
- `postIds` (list of string, optional) — Up to 50 post ids in the group.
- `postIdsTruncated` (boolean, optional)

### EnvelopeBreakdownMeta

- `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)
- `by` (string, optional)
- `sort` (map from string to any, optional)
- `groupCount` (integer, optional)
- `groupsTruncated` (boolean, optional)
- `limit` (integer, optional)
- `multiMembership` (boolean, optional)
- `overall` (Rollup, optional) — Comment-weighted rollup of post rows (the dashboard's combined-by-account math).
- `csvColumns` (list of string, optional)

### BreakdownRequestSort1

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

### BreakdownGroupShare

- `ofPosts` (double, optional, nullable)
- `ofComments` (double, optional, nullable)

### 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.

### BreakdownGroupBaselineDelta

Difference from the whole selection (`meta.overall`).

- `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

### Weekly trend for a brand account

**Request**

```json
{
  "selection": {
    "posts": {
      "account": "@dove",
      "posted_since": "2026-06-01"
    }
  },
  "by": "week"
}
```

**Response**

```json
{
  "data": [
    {
      "key": "string",
      "label": "string",
      "platform": "string",
      "account": "string",
      "collectionId": "string",
      "postCount": 1,
      "totalComments": 1,
      "share": {
        "ofPosts": 1.1,
        "ofComments": 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
        }
      },
      "baselineDelta": {
        "sentiment": 1.1,
        "siftsyScore": 1.1
      },
      "latestPostedAt": "string",
      "postIds": [
        "string"
      ],
      "postIdsTruncated": true
    }
  ],
  "meta": {
    "selection": {
      "collectionId": "col_launch",
      "posts": {
        "tag": "launch",
        "platform": "tiktok"
      }
    },
    "selectionTruncated": true,
    "by": "string",
    "sort": {},
    "groupCount": 1,
    "groupsTruncated": true,
    "limit": 1,
    "multiMembership": true,
    "overall": {
      "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
        }
      }
    },
    "csvColumns": [
      "string"
    ]
  }
}
```

**SDK Code**

```python Weekly trend for a brand account
import requests

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

payload = {
    "selection": { "posts": {
            "account": "@dove",
            "posted_since": "2026-06-01"
        } },
    "by": "week"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.json())
```

```javascript Weekly trend for a brand account
const url = 'https://api.siftsy.app/analyst/v1/breakdowns';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"selection":{"posts":{"account":"@dove","posted_since":"2026-06-01"}},"by":"week"}'
};

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

```go Weekly trend for a brand account
package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"selection\": {\n    \"posts\": {\n      \"account\": \"@dove\",\n      \"posted_since\": \"2026-06-01\"\n    }\n  },\n  \"by\": \"week\"\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 Weekly trend for a brand account
require 'uri'
require 'net/http'

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

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\": \"@dove\",\n      \"posted_since\": \"2026-06-01\"\n    }\n  },\n  \"by\": \"week\"\n}"

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

```java Weekly trend for a brand account
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.siftsy.app/analyst/v1/breakdowns")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"selection\": {\n    \"posts\": {\n      \"account\": \"@dove\",\n      \"posted_since\": \"2026-06-01\"\n    }\n  },\n  \"by\": \"week\"\n}")
  .asString();
```

```php Weekly trend for a brand account
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.siftsy.app/analyst/v1/breakdowns', [
  'body' => '{
  "selection": {
    "posts": {
      "account": "@dove",
      "posted_since": "2026-06-01"
    }
  },
  "by": "week"
}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

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

```csharp Weekly trend for a brand account
using RestSharp;

var client = new RestClient("https://api.siftsy.app/analyst/v1/breakdowns");
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\": \"@dove\",\n      \"posted_since\": \"2026-06-01\"\n    }\n  },\n  \"by\": \"week\"\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift Weekly trend for a brand account
import Foundation

let headers = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = [
  "selection": ["posts": [
      "account": "@dove",
      "posted_since": "2026-06-01"
    ]],
  "by": "week"
] as [String : Any]

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

let request = NSMutableURLRequest(url: NSURL(string: "https://api.siftsy.app/analyst/v1/breakdowns")! 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": "@dove",
      "posted_since": "2026-06-01"
    }
  },
  "by": "week"
}
```

**Response**

```json
{
  "data": [
    {
      "key": "string",
      "label": "string",
      "platform": "string",
      "account": "string",
      "collectionId": "string",
      "postCount": 1,
      "totalComments": 1,
      "share": {
        "ofPosts": 1.1,
        "ofComments": 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
        }
      },
      "baselineDelta": {
        "sentiment": 1.1,
        "siftsyScore": 1.1
      },
      "latestPostedAt": "string",
      "postIds": [
        "string"
      ],
      "postIdsTruncated": true
    }
  ],
  "meta": {
    "selection": {
      "collectionId": "col_launch",
      "posts": {
        "tag": "launch",
        "platform": "tiktok"
      }
    },
    "selectionTruncated": true,
    "by": "string",
    "sort": {},
    "groupCount": 1,
    "groupsTruncated": true,
    "limit": 1,
    "multiMembership": true,
    "overall": {
      "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
        }
      }
    },
    "csvColumns": [
      "string"
    ]
  }
}
```

**SDK Code**

```python
import requests

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

payload = {
    "selection": { "posts": {
            "account": "@dove",
            "posted_since": "2026-06-01"
        } },
    "by": "week"
}
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/breakdowns';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"selection":{"posts":{"account":"@dove","posted_since":"2026-06-01"}},"by":"week"}'
};

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/breakdowns"

	payload := strings.NewReader("{\n  \"selection\": {\n    \"posts\": {\n      \"account\": \"@dove\",\n      \"posted_since\": \"2026-06-01\"\n    }\n  },\n  \"by\": \"week\"\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/breakdowns")

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\": \"@dove\",\n      \"posted_since\": \"2026-06-01\"\n    }\n  },\n  \"by\": \"week\"\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/breakdowns")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"selection\": {\n    \"posts\": {\n      \"account\": \"@dove\",\n      \"posted_since\": \"2026-06-01\"\n    }\n  },\n  \"by\": \"week\"\n}")
  .asString();
```

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

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.siftsy.app/analyst/v1/breakdowns', [
  'body' => '{
  "selection": {
    "posts": {
      "account": "@dove",
      "posted_since": "2026-06-01"
    }
  },
  "by": "week"
}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

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

```csharp
using RestSharp;

var client = new RestClient("https://api.siftsy.app/analyst/v1/breakdowns");
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\": \"@dove\",\n      \"posted_since\": \"2026-06-01\"\n    }\n  },\n  \"by\": \"week\"\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": "@dove",
      "posted_since": "2026-06-01"
    ]],
  "by": "week"
] as [String : Any]

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

let request = NSMutableURLRequest(url: NSURL(string: "https://api.siftsy.app/analyst/v1/breakdowns")! 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()
```