Get an analysis | Siftsy Analyst API

{
  "data": {
    "id": "an_5f2c9a1e0b6d4d0f9c1a2b3c4d5e6f70",
    "kind": "snapshot",
    "status": "ready",
    "createdAt": "2026-09-10T15:04:05.000Z",
    "updatedAt": "2026-09-10T15:04:05.400Z",
    "completedAt": "2026-09-10T15:04:05.400Z",
    "expiresAt": "2026-09-17T15:04:05.000Z",
    "selection": {
      "collectionId": "col_launch",
      "type": "collection",
      "status": "complete"
    },
    "filters": null,
    "search": null,
    "include": [
      "wordCloud"
    ],
    "postCount": 12,
    "postIds": [
      "p_301",
      "p_298",
      "p_290"
    ],
    "selectionTruncated": false,
    "scope": {
      "postCount": 12,
      "postIds": [
        "p_301",
        "p_298",
        "p_290"
      ],
      "totalComments": 4820,
      "matchedComments": 611,
      "matchedPosts": 11,
      "shareOfComments": 0.1268,
      "shareOfContent": 0.9167
    },
    "content": {
      "postCount": 12,
      "posts": [
        {
          "id": "p_301",
          "platform": "tiktok",
          "link": "https://www.tiktok.com/@acme/video/7311",
          "creator": {
            "username": "acme"
          },
          "postedAt": "2026-09-02T17:00:00.000Z",
          "matchedComments": 97
        }
      ],
      "postsTruncated": false,
      "topics": [
        {
          "title": "Product launch",
          "description": null,
          "postCount": 12
        }
      ],
      "messages": [
        {
          "topic": "Product launch",
          "stance": "The new line ships faster",
          "postCount": 8
        }
      ],
      "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": null,
      "scores": {
        "scoreVersion": 3,
        "siftsyScore": 3.4,
        "sentiment": 2.3,
        "relevance": 7.8,
        "consensus": 6.9,
        "content": 2.1,
        "topic": 2.6
      },
      "mix": {
        "sentiment": {
          "positivePercent": 0,
          "leanPositivePercent": 0,
          "neutralPercent": 0,
          "leanNegativePercent": 38,
          "negativePercent": 62
        },
        "content": {
          "positivePercent": 0,
          "leanPositivePercent": 2,
          "neutralPercent": 5,
          "leanNegativePercent": 40,
          "negativePercent": 53
        },
        "topic": {
          "positivePercent": 1,
          "leanPositivePercent": 3,
          "neutralPercent": 6,
          "leanNegativePercent": 41,
          "negativePercent": 49
        },
        "relevance": {
          "positivePercent": 58,
          "leanPositivePercent": 24,
          "neutralPercent": 9,
          "leanNegativePercent": 6,
          "negativePercent": 3
        },
        "consensus": {
          "positivePercent": 44,
          "leanPositivePercent": 31,
          "neutralPercent": 12,
          "leanNegativePercent": 9,
          "negativePercent": 4
        }
      },
      "topics": [],
      "outliers": [],
      "wordCloud": [
        {
          "text": "shipping",
          "value": 84,
          "type": "word",
          "avgSentiment": 2.1,
          "sentimentCategory": "negative",
          "mentionPercentage": 13.7
        },
        {
          "text": "never arrived",
          "value": 51,
          "type": "phrase",
          "avgSentiment": 1.8,
          "sentimentCategory": "negative",
          "mentionPercentage": 5.6
        }
      ],
      "emojiCloud": null,
      "totalComments": 611,
      "completeness": "scores_and_content",
      "notableComments": [
        {
          "postId": "p_301",
          "commentId": "c_77f1"
        },
        {
          "postId": "p_298",
          "commentId": "c_1a09"
        }
      ]
    },
    "comments": {
      "path": "/analyses/an_5f2c9a1e0b6d4d0f9c1a2b3c4d5e6f70/comments"
    },
    "computedAt": "2026-09-10T15:04:05.400Z"
  },
  "meta": {
    "status": "queued",
    "pollAfterMs": 1
  }
}

Requires analyses:read. For analyses created with POST /analyses (an_… ids) this is the poll endpoint: status is queued, running, ready, or failed; scope, content, and commentAnalysis are populated once ready. Non-terminal responses include Retry-After and meta.pollAfterMs.

For persisted campaign reports (kind: report) the payload includes the stored report. Comment bodies are never included; sample them at GET /analyses/{analysisId}/comments (comments.path).

Rate class analysis_read (60 / minute, 2,000 / day per key). Poll at meta.pollAfterMs; polling faster only spends this budget.

Requires `analyses:read`. For analyses created with `POST /analyses` (`an_…` ids) this is the poll endpoint: `status` is `queued`, `running`, `ready`, or `failed`; `scope`, `content`, and `commentAnalysis` are populated once `ready`. Non-terminal responses include `Retry-After` and `meta.pollAfterMs`. For persisted campaign reports (`kind: report`) the payload includes the stored `report`. Comment bodies are never included; sample them at `GET /analyses/{analysisId}/comments` (`comments.path`). Rate class `analysis_read` (60 / minute, 2,000 / day per key). Poll at `meta.pollAfterMs`; polling faster only spends this budget.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

X-Api-Keystring

API Key authentication via header

Path parameters

analysisIdstringRequired

Response headers

Retry-Afterinteger

Present while the analysis is still queued / running

Response

Analysis detail, including comments.path

dataobjectOptional

An analysis created with POST /analyses. scope, content, and commentAnalysis are null until status is ready. content is creator-side (what was posted); commentAnalysis is audience-side (how the matched comments landed). A sample of comments behind the analysis lives at comments.path.

metaobjectOptional

Errors

404

Not Found Error