# Prism Post Comments API (https://www.socialcrawl.dev/platforms/prism/post-comments)

> Batch comment reader for many posts at once. POST a JSON body with `items`, an array of 1-25 post URLs (or `{ "url": "…", "custom_id": "…" }` objects; `urls` is accepted too), from instagram, tiktok, youtube, facebook, reddit, twitter (x), threads or linkedin, mixed freely. Each URL is read through its platform's own comment endpoint (instagram, tiktok and facebook post/comments, youtube video/comments, twitter tweet/replies, reddit post/comments, threads post/comments, linkedin post/comments) on that endpoint's cursor, up to `per_post` comments (default 20, at most 200). Returns one row per URL, in input order: `status` (ok, not_found, unsupported, error or deferred), the `target` and `custom_id` echoed, the credits that row cost, and on an ok row `data` with `platform`, `endpoint`, `url`, `items` (the same canonical comment rows that endpoint returns), `pages`, `truncated` and `next_cursor` (pass it as `cursor` to `endpoint` to read on). One dead or unsupported URL never fails the batch. Send `since` (a date or ISO 8601 timestamp) to keep only comments published at or after it: on Instagram, YouTube, X and LinkedIn the post is read newest first and the walk stops at the first older comment (`stopped_at: "since"`); elsewhere each post is read up to per_post comments and filtered. A Reddit row holds the comments of one read of the thread (the single endpoint's deeper reply expansion is not run here; `truncated` says when the thread holds more). Posts not started within the 45-second budget come back `deferred` at no charge: re-request them. For more than 25 posts, send several calls, or `POST /v1/prism/jobs` with `endpoint` set to the platform's comment endpoint (up to 1,000 posts in the background). Never cached. Optionally streams Server-Sent Events when the client sends `Accept: text/event-stream`.

TL;DR: `POST /v1/prism/post-comments` costs Each post costs what its own comment endpoint charges per page (1 credit on TikTok, YouTube, Facebook, X and Threads; 5 on Instagram, LinkedIn and Reddit), for the pages that came back with comments. The call holds every post at the pages per_post can take and refunds the rest; unsupported, not found, failed and deferred posts cost nothing. With since, a post with no new comment costs nothing and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `items` | yes | JSON array of 1-25 post URLs. Each item is a URL string or `{ "url": "https://…", "custom_id"?: "…" }` (custom_id up to 128 characters, echoed on its row). `urls` is accepted as an alias. |
| `per_post` | no | Optional. An integer from 1 to 200 (default 20): the most comments read per post, walked page by page on that platform's comment endpoint. |
| `since` | no | Optional. Only comments published on or after this date (YYYY-MM-DD, midnight UTC) or ISO 8601 timestamp. A post whose comments are all older costs nothing. |

## Code example

```bash
curl -X POST "https://www.socialcrawl.dev/v1/prism/post-comments" \
  -H "x-api-key: sc_YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"items":["https://www.tiktok.com/@mrbeast/video/7654638524729216287","https://www.youtube.com/watch?v=dQw4w9WgXcQ"]}'
```

See the full Prism API: https://www.socialcrawl.dev/platforms/prism

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing