Prism Handle Audit API
Scrape Prism Handle Audit data with one API call. 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. 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.
Last updated July 2026
Try the Prism Handle Audit API
See real data before writing a single line
Searching 43 platforms in parallel
What can you do with the Handle Audit API?
The Handle Audit endpoint gives you structured Prism data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl "https://www.socialcrawl.dev/v1/prism/handle-audit?handle=mrbeast" \
-H "x-api-key: YOUR_API_KEY"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/prism/handle-audit",
headers={"x-api-key": "YOUR_API_KEY"},
params={"handle": "mrbeast"},
)
data = response.json()const params = new URLSearchParams({
"handle": "mrbeast",
});
const response = await fetch(`https://www.socialcrawl.dev/v1/prism/handle-audit?${params}`, {
headers: { "x-api-key": "YOUR_API_KEY" },
});
const data = await response.json();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). |
How does the Prism Handle Audit API work?
Send a GET request with your API key and get back clean, structured JSON. Every response follows our unified schema with computed fields.
Method
GET
Response
JSON
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 43 platforms covering 10B+ monthly active users.
One schema, every platform
Query 43 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
Every response includes engagement_rate, estimated_reach, content_category, and language — ready to use.
See your data before you code
Visual Data Explorer — paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Ready to scrape Prism Handle Audit data?
Get your API key and start pulling Prism data in under 60 seconds.
