# Prism Handle Audit API (https://www.socialcrawl.dev/platforms/prism/handle-audit)

> Answers three questions BEFORE you spend credits on a full pull. (1) Is this handle worth pulling? — a deterministic 0-100 composite quality score with five component sub-scores (presence, audience, engagement, activity, content_richness). (2) On which platforms? — a per-platform verdict and a `best_platforms` ranking, plus the native endpoints to hit next, so you can route the follow-up pull. (3) How much data is there? — a `surface` block projecting post + comment volume and the credit cost to pull it. Looks a single handle up across TikTok, Instagram, YouTube, and X in parallel (Threads/Bluesky/Truth Social can be added via `platforms`); for every platform the handle is found on it also samples recent posts to measure engagement and posting activity. A handle found on only some platforms is a successful, complete answer (the misses are the product); only an all-platform miss refunds. The call returns within a bounded latency budget: a slow upstream platform is skipped rather than stalling the whole audit, and the score is computed from the data available at request time (a skipped or profile-only platform is scored on the signals that did return and shown in `legs[]`, never silently dropped or penalized as a miss). Data completeness is first-class in the contract: `confidence` reports a deterministic high/medium/low tier with the reason, `evaluated_platforms`/`skipped_platforms` name exactly which platforms answered, `computed_at` timestamps the computation (cached responses can be up to 30 minutes old), and `score_version` pins the scoring-model semver so stored scores stay comparable across tuning releases. Scores are advisory heuristics estimated from public data at request time, not calibrated probabilities. Flat 5 credits for up to 4 platforms, +1 credit per extra platform. `legs[]` reports each leg's status, cost, and latency. See `prism/creator-vet` for the deeper 'should I sponsor' report.

TL;DR: `GET /v1/prism/handle-audit` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `handle` | yes | The handle to audit across every requested platform. Accepts a bare handle, a leading @, or a full profile URL (the platform is sniffed from the host). |
| `platforms` | no | CSV subset of tiktok,instagram,youtube,twitter,threads,bluesky,truthsocial (default the first four). Unknown platforms are ignored. Max 8. |
| `sample` | no | Recent posts sampled per found platform for the engagement + activity metrics (default 10, max 25). |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/prism/handle-audit?handle=mrbeast" \
  -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