# 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"]}'
```

## FAQ

### What does the Prism Post Comments API return?

Returns the comments under each post URL you send, across platforms and in the order you sent them, with a status per row and the same comment rows as each platform's own comment endpoint. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields.

### When should I use the Prism Post Comments endpoint?

Use it when you hold a list of post URLs and want their comments, or only the new ones since a date, in one call instead of a loop over the comment endpoints. Not for every page of one post's thread (prism/comments), or the comments under an account's own recent posts (prism/profile/comments).

### How much does the Prism Post Comments API cost?

The price depends on the request, from 1 to 2500 credits per call. Every new account gets 100 free credits. Credits for failed or empty calls are refunded automatically, and there is no subscription.

### What parameters does the Prism Post Comments API need?

The one required parameter is items (jSON array of 1-25 post URLs). It also accepts 2 optional parameters, all listed on this page.

### How do I call the Prism Post Comments API?

Send a POST request to https://www.socialcrawl.dev/v1/prism/post-comments with a JSON body and your API key in the x-api-key header. An Authorization: Bearer header works too.

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

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- What does the SocialCrawl Prism Post Comments API return?
- How do I get Prism Post Comments data with the SocialCrawl API?