# Prism Comment Lookup API (https://www.socialcrawl.dev/platforms/prism/comment-lookup)

> Batch version of the single-comment lookup, built for recurring brand-comment tracking. Pass up to 25 items, each either `{ comment_url }` or `{ platform, post_url, comment_id }` (plus optional `parent_comment_id`, `position_hint`, `deep_scan`). Every item resolves independently — one bad item never fails the batch — and returns a `status` of `found`, `not_found`, `error`, or `deferred`. Billing is per item (TikTok 2 credits, Instagram 5 credits; deep_scan raises it); only `found` items are charged, everything else is refunded, and the whole batch holds at most 100 credits. Store each returned `lookup.position_hint` and pass it back on the next run so a daily refresh of your tracked comments costs ~1-2 credits per item. Returns sync JSON, or a typed SSE stream (`Accept: text/event-stream`) that emits each item as it settles. Items not started within the 45-second budget come back `deferred` (refunded) — just re-request them.

TL;DR: `POST /v1/prism/comment-lookup` costs 2 credits per call 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 lookup items. Each item is `{ "comment_url": "…" }` or `{ "platform": "tiktok"\|"instagram", "post_url": "…", "comment_id": "…" }`, optionally with `parent_comment_id`, `position_hint`, and `deep_scan`. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/prism/comment-lookup?items=%5B%7B%22comment_url%22%3A%22https%3A%2F%2Fwww.tiktok.com%2F%40mrbeast%2Fvideo%2F7654638524729216287%3Fcomment_id%3D7654640784985211670%22%7D%2C%7B%22platform%22%3A%22instagram%22%2C%22post_url%22%3A%22https%3A%2F%2Fwww.instagram.com%2Fp%2FCnpPou9hWqq%2F%22%2C%22comment_id%22%3A%2218007013966365752%22%7D%5D" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

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