# Prism Profiles API (https://www.socialcrawl.dev/platforms/prism/profiles)

> Batch profile lookup for handle vetting. POST a JSON body with an `items` array of 1–50 `{ platform, handle, custom_id? }` objects (handle accepts an @handle, a bare handle, or a pasted profile URL); returns one row per item — the canonical Author object (same shape as the single GET profile endpoint), a `status` of ok / not_found / unsupported / error / deferred, the caller's `custom_id` echoed, and the credits that row cost — in input order. Per-item isolation: one dead or private handle never fails the batch. Billing is per item at each platform's own credit tier (most platforms 1 credit; LinkedIn 5); only successful rows are charged, everything else is refunded. Supported platforms: instagram, tiktok, youtube, twitter, threads, twitch, snapchat, truthsocial, bluesky, kwai, linkedin, facebook. Never cached. Optionally streams Server-Sent Events when the client sends `Accept: text/event-stream`.

TL;DR: `POST /v1/prism/profiles` 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 |
| --- | --- | --- |
| `items` | yes | JSON array of 1–50 items. Each item is `{ "platform": "tiktok", "handle": "@scout2015", "custom_id"?: "…" }`. `handle` accepts an @handle, a bare handle, or a pasted profile URL. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/prism/profiles?items=%5B%7B%22platform%22%3A%22tiktok%22%2C%22handle%22%3A%22%40scout2015%22%7D%2C%7B%22platform%22%3A%22linkedin%22%2C%22handle%22%3A%22williamhgates%22%2C%22custom_id%22%3A%22vet-1%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