Prism Handle Audit API
Scrape Prism Handle Audit data with one API call. Decide whether to pull a handle before paying for a full collection. Score model 2.0.0 returns nullable top-level and per-platform scores, explicit evidence and component coverage, surface estimates, and `legs[]` diagnostics. Unknown numeric values are `null`, not zero. Output is deterministic only for the same (`score_version`, `evidence_fingerprint`) and returned evidence; a later live collection may produce different evidence and a different score. Stale-if-error evidence is eligible for at most 24 hours, and future-dated evidence more than 300 seconds ahead is rejected. 5 credits for any selection of up to 4 supported platforms; +1 credit per selected platform beyond 4. Every successful HTTP 200 receives the full request-shaped charge with no partial refund. A non-200 execution failure receives a full refund when every requested platform is a definitive miss or cannot return usable profile evidence. Scores are advisory estimates from public evidence, not calibrated probabilities.
Last updated August 2026Maintained by the SocialCrawl team
Returns a scored audit of a handle across platforms: a verdict, per platform scores, follower and activity signals, and an estimate of the data volume and credits a full pull would cost.
Use it to vet a creator or brand name across platforms in one call instead of checking each network separately.
Searching 48 platforms in parallel
TikTok·
Instagram·
YouTube·
Facebook·
X·
LinkedIn·
Reddit·
Threads·
Pinterest·
Twitch·
Truth Social·
Snapchat·
Kick·
Bluesky·
Kwai·
Rumble·
Spotify·TikTok Shop·
Amazon Shop·
Google Shopping·
Trustpilot·
TripAdvisor·
Linktree·
Komi·
Pillar·
lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·
Polymarket·
Tavily·
Hacker News·
GitHub·
Perplexity·
Naver·Utility·
Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchWhat 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 -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/prism/handle-audit?handle=mrbeast"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/prism/handle-audit",
params={
'handle': 'mrbeast',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/prism/handle-audit?handle=mrbeast",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();Parameters
| Parameter | Required | Description |
|---|---|---|
| handle | Yes | The identity to audit. Accepts a bare handle, a leading @, a supported profile URL, or a YouTube channel ID. A YouTube channel ID is YouTube-only: omit `platforms` or set `platforms=youtube`. |
| platforms | No | CSV subset of tiktok,instagram,youtube,twitter,threads,bluesky,truthsocial (default: tiktok,instagram,youtube,twitter). Names are case-insensitive and deduplicated. Unknown platforms are rejected. At most 8 CSV members before deduplication. |
| sample | No | Integer from 1 to 25: recent posts sampled per found platform for engagement and activity metrics (default 10). |
What does the Prism Handle Audit API return?
This synthetic response comes from the score-v2 reducer fixture. It shows the contract and nullable fields; it is not a live profile lookup.
Example response
{
"success": true,
"platform": "prism",
"endpoint": "/v1/prism/handle-audit",
"data": {
"handle": "creator",
"verdict": "insufficient_evidence",
"score": null,
"score_status": "insufficient_evidence",
"score_version": "2.0.0",
"evidence_fingerprint": "8115d8ff586f018c3f78e10eda64da2b17bb4d598da667c23addd8dbd259ac9b",
"computed_at": "2026-07-21T12:00:00.000Z",
"evidence_as_of": {
"oldest": "2026-07-21T12:00:00.000Z",
"newest": "2026-07-21T12:00:00.000Z"
},
"confidence": {
"tier": "low",
"reason": "No decision-grade post evidence is available. Posts evidence unavailable: tiktok."
},
"evaluated_platforms": [
"tiktok"
],
"skipped_platforms": [],
"stale_platforms": [],
"score_components": {
"presence": null,
"audience": null,
"engagement": null,
"activity": null,
"content_richness": null
},
"component_availability": {
"presence": false,
"audience": false,
"engagement": false,
"activity": false,
"content_richness": false
},
"component_coverage": {
"presence": "unavailable",
"audience": "unavailable",
"engagement": "unavailable",
"activity": "unavailable",
"content_richness": "unavailable"
},
"effective_weights": {
"presence": 0,
"audience": 0,
"engagement": 0,
"activity": 0,
"content_richness": 0
},
"available_weight": 0,
"score_aggregation": {
"best_platform": null,
"best_score": null,
"mean_score": null,
"best_weight": 0.7,
"mean_weight": 0.3
},
"best_platforms": [],
"platforms": {
"tiktok": {
"found": true,
"score": null,
"score_status": "insufficient_evidence",
"score_components": {
"presence": 100,
"audience": 53,
"engagement": null,
"activity": null,
"content_richness": null
},
"component_availability": {
"presence": true,
"audience": true,
"engagement": false,
"activity": false,
"content_richness": false
},
"component_coverage": {
"presence": "complete",
"audience": "complete",
"engagement": "unavailable",
"activity": "unavailable",
"content_richness": "unavailable"
},
"effective_weights": {
"presence": 0.28571428571428575,
"audience": 0.7142857142857143,
"engagement": 0,
"activity": 0,
"content_richness": 0
},
"available_weight": 0.35,
"author": {
"id": "creator-1",
"username": "creator",
"followers": 12000,
"verified": true,
"posts_count": 4
},
"signals": {
"followers": 12000,
"verified": true,
"posts_total": 4,
"sampled_posts": null,
"median_engagement_rate": null,
"er_benchmark_ratio": null,
"days_since_last_post": null,
"avg_comments_per_post": null,
"posts_per_week": null,
"media_fraction": null,
"avg_text_length": null
},
"evidence": {
"profile": {
"state": "live",
"captured_at": "2026-07-21T12:00:00.000Z",
"stale_age_seconds": null,
"failure_reason": null
},
"posts": {
"state": "unavailable",
"captured_at": null,
"stale_age_seconds": null,
"failure_reason": null
}
},
"recommended_endpoints": [
"GET /v1/tiktok/profile/videos",
"GET /v1/tiktok/video/comments"
]
}
},
"surface": {
"posts_estimate": {
"tiktok": 4,
"total": 4
},
"comments_estimate": {
"tiktok": null,
"total": 0
},
"estimate_basis": "posts_total from profile metadata; comments = posts_total x observed average comments per post; null = unknown required evidence and is excluded from total",
"pull_cost_estimate_credits": {
"posts_only": 1,
"posts_and_comments": 5
}
},
"disclaimer": "Scores are heuristics estimated from public data at request time; they are advisory, not calibrated probabilities.",
"legs": [
{
"endpoint": "/v1/tiktok/profile",
"status": 200,
"credits_used": 1,
"latency_ms": 180,
"error": null
},
{
"endpoint": "/v1/tiktok/profile/videos",
"status": 502,
"credits_used": 0,
"latency_ms": 250,
"error": "INVALID_RESPONSE"
}
]
},
"credits_used": 5,
"credits_remaining": 4995,
"request_id": "req-handle-audit-example",
"cached": false
}Reducer-derived fixture for the v2 response shape. Values are illustrative, not a production capture.
How does the Prism Handle Audit API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
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 48 platforms covering 10B+ monthly active users.
One schema, every platform
Query 48 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record 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.