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

# Get a post's content and comment analysis

GET https://api.siftsy.app/analyst/v1/posts/{postId}/analysis

Requires `posts:read`. Materialized analysis for one post — the
dashboard Content Analysis + Comment Analysis panels, without comment
bodies.

**Content** is creator-side: brief, scoring-context topics and
messages, content/topic scores, and mix bars.
**Comment analysis** is audience-side: Siftsy scores, mix bars for
overall sentiment, content, topic, relevance, and consensus.

Comment text is not included. A sample of comments behind this
analysis lives at `GET /posts/{postId}/analysis/comments`.
Never recomputes.

Reference: https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/get-post-analysis

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

### Path parameters

- `postId` (string, required)

## Response

### 200

Post analysis

- `data` (PostAnalysis, optional) — Dashboard analysis for one post. `content` is creator-side. `commentAnalysis` is audience-side. A sample of comments behind this analysis lives under `/posts/{postId}/analysis/comments`.
- `meta` (EnvelopePostAnalysisMeta, optional)

## Errors

### 404 Not Found Error

Resource not found

- `any`

## Types

### PostAnalysis

Dashboard analysis for one post. `content` is creator-side. `commentAnalysis` is audience-side. A sample of comments behind this analysis lives under `/posts/{postId}/analysis/comments`.

- `postId` (string, optional)
- `content` (ContentAnalysis, optional)
- `commentAnalysis` (CommentAnalysis, optional)
- `comments` (PostAnalysisComments, optional) — Sample of comments behind this analysis (evidence, not a full-thread export).
- `computedAt` (string, optional, nullable)

### EnvelopePostAnalysisMeta

### ContentAnalysis

- `brief` (string, optional, nullable) — Post summary / content brief
- `title` (string, optional, nullable)
- `description` (string, optional, nullable)
- `platform` (string, optional, nullable)
- `link` (string, optional, nullable)
- `creator` (Creator, optional, nullable) — The account that published the post.
- `postedAt` (string, optional, nullable)
- `engagement` (Engagement, optional, nullable) — Platform engagement counts as last refreshed. Null when the platform does not report a metric.
- `isDemo` (boolean, optional)
- `topics` (list of ContentAnalysisTopicsItems, optional) — Creator topics this post was scored against
- `messages` (list of ContentAnalysisMessagesItems, optional) — Creator messages / stances this post was scored against
- `scores` (ContentAnalysisScores, optional)
- `mix` (ContentAnalysisMix, optional)

### CommentAnalysis

- `briefSummary` (string, optional, nullable) — Audience brief when materialized on the post
- `scores` (PostScores, optional) — Scores resolved for the team's selected score version (1-10 scale). `content` / `topic` are populated for score version 2+ teams.
- `mix` (CommentAnalysisMix, optional)
- `topics` (list of CommentTheme, optional) — Emergent comment themes when stored on the post
- `notableCommentIds` (list of string, optional)
- `outliers` (list of CommentAnalysisOutliersItems, optional)
- `wordCloud` (any, optional, nullable)
- `emojiCloud` (any, optional, nullable)
- `totalComments` (double, optional, nullable)
- `completeness` (enum, optional)
  - Allowed values: `full`, `scores_and_content`, `scores_only`, `content_only`, `unavailable`

### PostAnalysisComments

Sample of comments behind this analysis (evidence, not a full-thread export).

- `path` (string, optional) — Relative to the API base URL (`…/analyst/v1`).
- `url` (string, optional, nullable) — Absolute URL for `path` on the host you called. Follow it as-is.

### Creator

The account that published the post.

- `username` (string, optional, nullable)
- `name` (string, optional, nullable) — Display name
- `avatar` (string, optional, nullable) — Avatar URL

### Engagement

Platform engagement counts as last refreshed. Null when the platform does not report a metric.

- `views` (double, optional, nullable)
- `likes` (double, optional, nullable)
- `comments` (double, optional, nullable)
- `shares` (double, optional, nullable)
- `saves` (double, optional, nullable)
- `engagementRate` (double, optional, nullable)

### ContentAnalysisTopicsItems

- `title` (string, optional)
- `description` (string, optional, nullable)

### ContentAnalysisMessagesItems

- `topic` (string, optional)
- `stance` (string, optional, nullable)

### ContentAnalysisScores

- `content` (double, optional, nullable)
- `topic` (double, optional, nullable)

### ContentAnalysisMix

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

### PostScores

Scores resolved for the team's selected score version (1-10 scale). `content` / `topic` are populated for score version 2+ teams.

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

### CommentAnalysisMix

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

### CommentTheme

- `label` (string, optional)
- `shareOfComments` (double, optional, nullable)
- `shareOfContent` (double, optional, nullable)
- `commentCount` (double, optional, nullable)
- `postCount` (double, optional, nullable)
- `scores` (PostScores, optional) — Scores resolved for the team's selected score version (1-10 scale). `content` / `topic` are populated for score version 2+ teams.
- `brief` (CommentThemeBrief, optional)
- `sampleCommentIds` (list of string, optional)

### CommentAnalysisOutliersItems

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

### CommentThemeBrief

- `heading` (string, optional, nullable)
- `description` (string, optional, nullable)

## Examples

**Response**

```json
{
  "data": {
    "postId": "p_301",
    "content": {
      "brief": "Launch video for the new running line; creator demos the shoe and announces same-day shipping.",
      "title": "The new line is here",
      "description": "Same-day shipping on every order this week. #launch",
      "platform": "tiktok",
      "link": "https://www.tiktok.com/@acme/video/7311",
      "creator": {
        "username": "acme",
        "name": "Acme Running",
        "avatar": null
      },
      "postedAt": "2026-09-02T17:00:00.000Z",
      "engagement": {
        "views": 812000,
        "likes": 40400,
        "comments": 4820,
        "shares": 1210,
        "saves": 3300,
        "engagementRate": 0.0605
      },
      "isDemo": false,
      "topics": [
        {
          "title": "Product launch",
          "description": "New running shoe line"
        }
      ],
      "messages": [
        {
          "topic": "Product launch",
          "stance": "The new line ships faster"
        }
      ],
      "scores": {
        "content": 7.1,
        "topic": 6.4
      },
      "mix": {
        "content": {
          "positivePercent": 41,
          "leanPositivePercent": 22,
          "neutralPercent": 18,
          "leanNegativePercent": 11,
          "negativePercent": 8
        },
        "topic": {
          "positivePercent": 35,
          "leanPositivePercent": 27,
          "neutralPercent": 20,
          "leanNegativePercent": 10,
          "negativePercent": 8
        }
      }
    },
    "commentAnalysis": {
      "briefSummary": "Fans are excited about the colorways; a vocal minority reports late deliveries.",
      "scores": {
        "scoreVersion": 2,
        "siftsyScore": 7.1,
        "sentiment": 6.8,
        "relevance": 7.9,
        "consensus": 7.2,
        "content": 6.9,
        "topic": 7
      },
      "mix": {
        "sentiment": {
          "positivePercent": 44,
          "leanPositivePercent": 21,
          "neutralPercent": 14,
          "leanNegativePercent": 12,
          "negativePercent": 9
        },
        "content": {
          "positivePercent": 41,
          "leanPositivePercent": 22,
          "neutralPercent": 18,
          "leanNegativePercent": 11,
          "negativePercent": 8
        },
        "topic": {
          "positivePercent": 35,
          "leanPositivePercent": 27,
          "neutralPercent": 20,
          "leanNegativePercent": 10,
          "negativePercent": 8
        },
        "relevance": {
          "positivePercent": 61,
          "leanPositivePercent": 22,
          "neutralPercent": 0,
          "leanNegativePercent": 12,
          "negativePercent": 5
        },
        "consensus": {
          "positivePercent": 48,
          "leanPositivePercent": 30,
          "neutralPercent": 0,
          "leanNegativePercent": 16,
          "negativePercent": 6
        }
      },
      "topics": [
        {
          "label": "Shipping delays",
          "shareOfComments": 0.13,
          "shareOfContent": 1,
          "commentCount": 611,
          "postCount": 1,
          "scores": {
            "siftsyScore": 3.1,
            "sentiment": 2.3,
            "relevance": 7.8,
            "consensus": 6.9,
            "content": 2.1,
            "topic": 2.6
          },
          "brief": {
            "heading": "Orders arriving late",
            "description": "Commenters report deliveries missing the same-day promise."
          },
          "sampleCommentIds": [
            "c_77f1",
            "c_1a09"
          ]
        }
      ],
      "notableCommentIds": [],
      "outliers": [],
      "wordCloud": null,
      "emojiCloud": null,
      "totalComments": 4820,
      "completeness": "full"
    },
    "comments": {
      "path": "/posts/p_301/analysis/comments"
    },
    "computedAt": "2026-09-03T04:12:44.000Z"
  },
  "meta": {}
}
```

**SDK Code**

```python
import requests

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

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api.siftsy.app/analyst/v1/posts/postId/analysis';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

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"
	"net/http"
	"io"
)

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	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/postId/analysis")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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.get("https://api.siftsy.app/analyst/v1/posts/postId/analysis")
  .header("Authorization", "Bearer <token>")
  .asString();
```

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

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.siftsy.app/analyst/v1/posts/postId/analysis', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

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

```csharp
using RestSharp;

var client = new RestClient("https://api.siftsy.app/analyst/v1/posts/postId/analysis");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.siftsy.app/analyst/v1/posts/postId/analysis")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

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