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

> Bulk stats refresh for verification loops (clipper payouts). POST a JSON body with a `urls` array (1–100 mixed-platform post links); returns one row per URL — platform, status (ok / not_found / error / unsupported), the unified engagement block (views/likes/comments/shares/saves), and a server `fetched_at` timestamp — in input order. Per-URL isolation: one dead link never fails the batch. Metered at 1 credit per successful URL; dead, errored, and unsupported URLs are refunded, so you pay exactly for the counts you got. Never cached (every call reads the live count). Optionally streams Server-Sent Events when the client sends `Accept: text/event-stream`.

TL;DR: `POST /v1/prism/post-stats` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `urls` | yes | JSON array of 1–100 absolute http(s) post URLs (mixed platforms allowed). |
| `include` | no | CSV subset of views,likes,comments,shares,saves to trim each row's engagement block. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/prism/post-stats?urls=%5B%22https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ%22%5D" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get current view and like counts for many posts at once?

Send POST /v1/prism/post-stats with a JSON body of up to 100 post URLs. The post engagement API returns the current views, likes, comments, shares, and saves for each URL, in the same order you sent them, with a fetched_at timestamp per row.

### What happens to dead or invalid links in the batch?

Each URL is isolated, so one bad link never fails the batch. A removed post returns status not_found, an unsupported link returns status unsupported, and you are billed 1 credit only per successful URL — every failed or unsupported link is refunded.

### Which platforms and link types does it support?

Any post URL the router recognizes — TikTok, Instagram, YouTube, X, Facebook, Reddit, Bluesky, Pinterest, Threads, Rumble, and more. Links that carry no engagement, such as a GitHub repo or a profile page, come back as status unsupported and are not charged.

### Is the post engagement API's data cached or live?

Live. post-stats never serves a cached count, so a payout dashboard polling the same clips always reads the current numbers. Each row carries a fetched_at timestamp so you can prove exactly when a count was read.

### Can I stream results as each URL is checked?

Yes. Send Accept: text/event-stream and each URL's row arrives as it settles, followed by a done chunk with the credits used. The default application/json returns one envelope with every row once the whole batch is finished.

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:

- Which API returns current view counts for a batch of TikTok and YouTube URLs?
- How do I verify view counts on hundreds of social media post links with one API call?