100 free credits. No credit card required
Prism Voice API
Returns one person's recent posts from X, Threads, Bluesky, and Truth Social in a single time-ordered feed, plus which of those they are actually on.
GET /v1/prism/voiceLast updated October 2026Maintained by the SocialCrawl team
When to use the Prism Voice API
Use it to follow someone across microblogs in one call; creator-card returns their profile stats, this returns what they actually posted.
From the API reference
Fetches a handle's recent posts from four microblogs in parallel, time-merges them into one chronological feed, and computes platform presence, a cross-post rate, and a per-platform tone label (a soft LLM heuristic that degrades to absent on failure). Microblogs the handle isn't on return empty arrays with platform_presence:false: the absence map is the product. Flat 5cr; all-miss → full refund. The legs[] block reports each leg's status, cost, and latency. X pages: pass a prior next_cursor back as cursor. v1 is list-level (no per-post detail drill).
Searching 69 platforms in parallel
·
TikTok·
Instagram·
YouTube·
Facebook·
X·
LinkedIn·
Reddit·
Threads·
Pinterest·
Twitch·
Truth Social·
Snapchat·
Kick·
Bluesky·
Kwai·
Rumble·
Spotify·
Apple Music·TikTok Shop·
Amazon Shop·
Google Shopping·
Trustpilot·
TripAdvisor·
Yelp·
Linktree·
Komi·
Pillar·
lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·
Finance·
Polymarket·
Tavily·
Hacker News·
GitHub·
Perplexity·
Naver·
Utility·
Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchPrism API
What can you do with the Voice API?
The Voice endpoint gives you structured Prism data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
# GET /v1/prism/voice: 5 credits per call. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
# --max-time 60: the API's own time limit for this endpoint.
# --retry 3: retries timeouts, 429 and 5xx, honoring Retry-After.
# -o response.json keeps only the final attempt's body.
# One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
IDEMPOTENCY_KEY=$(od -An -N16 -tx1 /dev/urandom | tr -d ' \n')
curl -sS --max-time 60 --retry 3 -o response.json \
-H "x-api-key: YOUR_API_KEY" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
"https://www.socialcrawl.dev/v1/prism/voice?handle=nasa&platforms=twitter%2Cthreads%2Cbluesky%2Ctruthsocial" && cat response.json# GET /v1/prism/voice: 5 credits per call. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
import os
import random
import time
import uuid
import requests
API_KEY = os.environ.get("SOCIALCRAWL_API_KEY", "YOUR_API_KEY")
TIMEOUT_S = 60 # the API's own time limit for this endpoint.
MAX_RETRIES = 3
URL = "https://www.socialcrawl.dev/v1/prism/voice"
def backoff(attempt):
# Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
return 2 ** attempt * (0.5 + random.random() / 2)
def socialcrawl(params):
# One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
idempotency_key = str(uuid.uuid4())
for attempt in range(MAX_RETRIES + 1):
try:
res = requests.get(
URL,
params=params,
headers={"x-api-key": API_KEY, "Idempotency-Key": idempotency_key},
timeout=TIMEOUT_S,
)
body = res.json()
except (requests.RequestException, ValueError):
# A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
if attempt == MAX_RETRIES:
raise
time.sleep(backoff(attempt))
continue
if body["success"]:
return body
error = body["error"]
# Branch on error["type"], never on the message text.
if error["type"] == "RESOURCE_NOT_FOUND":
return None # refunded: nothing to read
retry_after = res.headers.get("Retry-After")
# SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
permanent = error["type"] == "SERVICE_UNAVAILABLE" and retry_after is None
if not error.get("retryable") or permanent or attempt == MAX_RETRIES:
raise RuntimeError(f"{error['type']}: {error['message']} (request_id {body['request_id']})")
# Retry-After (seconds) wins; otherwise back off.
time.sleep(float(retry_after) if retry_after else backoff(attempt))
params = {
"handle": "nasa",
"platforms": "twitter,threads,bluesky,truthsocial",
}
body = socialcrawl(params)
if body is not None:
print(body["data"])// GET /v1/prism/voice: 5 credits per call. Cache hits are free and failed calls are refunded.
// Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
const API_KEY = process.env.SOCIALCRAWL_API_KEY ?? "YOUR_API_KEY";
const TIMEOUT_MS = 60_000; // the API's own time limit for this endpoint.
const MAX_RETRIES = 3;
type Page = { next_cursor: string | null; has_more: boolean };
type SocialCrawlResponse =
| { success: true; data: any; pagination?: Page; credits_used: number; request_id: string }
| { success: false; error: { type: string; message: string; retryable: boolean }; request_id: string };
const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
// Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
const backoffMs = (attempt: number) => 2 ** attempt * 1000 * (0.5 + Math.random() / 2);
async function socialcrawl(url: URL) {
// One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
const idempotencyKey = crypto.randomUUID();
for (let attempt = 0; ; attempt++) {
let res: Response;
let body: SocialCrawlResponse;
try {
res = await fetch(url, {
headers: {
"x-api-key": API_KEY,
"Idempotency-Key": idempotencyKey,
},
signal: AbortSignal.timeout(TIMEOUT_MS),
});
body = (await res.json()) as SocialCrawlResponse;
} catch (error) {
// A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
if (attempt >= MAX_RETRIES) throw error;
await sleep(backoffMs(attempt));
continue;
}
if (body.success) return body;
// Branch on error.type, never on the message text.
if (body.error.type === "RESOURCE_NOT_FOUND") return null; // refunded: nothing to read
const retryAfter = res.headers.get("Retry-After");
// SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
const permanent = body.error.type === "SERVICE_UNAVAILABLE" && retryAfter === null;
if (!body.error.retryable || permanent || attempt >= MAX_RETRIES) {
throw new Error(`${body.error.type}: ${body.error.message} (request_id ${body.request_id})`);
}
// Retry-After (seconds) wins; otherwise back off.
await sleep(retryAfter ? Number(retryAfter) * 1000 : backoffMs(attempt));
}
}
const url = new URL("https://www.socialcrawl.dev/v1/prism/voice");
url.searchParams.set("handle", "nasa");
url.searchParams.set("platforms", "twitter,threads,bluesky,truthsocial");
const body = await socialcrawl(url);
if (body) console.log(body.data);Parameters
| Parameter | Required | Description |
|---|---|---|
| handle | Yes | The handle to look up across all four microblogs (a single leading @ is stripped). |
| platforms | No | CSV subset of twitter,threads,bluesky,truthsocial (default all four). |
| cursor | No | Opaque composite cursor from a prior response's `next_cursor`. X/Twitter pages; Truth Social pages on `next_max_id`; a mangled token is a 400 at 0 credits. |
| include | No | CSV subset of posts_by_platform,merged_timeline,computed to trim the payload (posts_by_platform is always returned). |
Example Response
What does the Prism Voice API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "prism",
"endpoint": "/v1/prism/voice",
"data": {
"posts_by_platform": {
"twitter": [
{
"post": {
"id": "2105842656429432894",
"url": "https://x.com/user_06552e/status/2105842656429432894",
"content": {
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"media_urls": "https://pbs.twimg.com/amplify_video_thumb/2105842619867656192/img/RLtky5UmWy8qAhZd.jpg",
"thumbnail_url": "https://pbs.twimg.com/amplify_video_thumb/2105842619867656192/img/RLtky5UmWy8qAhZd.jpg",
"duration_seconds": 65.301
},
"author": {
"username": "user_06552e",
"display_name": "user_06552e",
"avatar_url": "https://example.com/avatars/user_a0bf17.png",
"verified": true
},
"engagement": {
"views": 797945,
"likes": 9451,
"comments": 261,
"shares": 1143,
"saves": 288
},
"flags": {
"nsfw": false,
"spoiler": null,
"pinned": false,
"deleted": false
},
"published_at": "2026-10-02T02:09:48.000Z",
"ext": {
"author_followers": 92377795,
"author_following": 115,
"author_posts_count": 74368,
"content_language": "en",
"quote_count": 77,
"all_media_urls": null
}
},
"computed": {
"engagement_rate": 0.013604,
"language": "en",
"content_category": "other",
"estimated_reach": 957534
}
},
{
"post": {
"id": "2105769921791549573",
"url": "https://x.com/user_06552e/status/2105769921791549573",
"content": {
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"media_urls": null,
"thumbnail_url": null,
"duration_seconds": null
},
"author": {
"username": "user_06552e",
"display_name": "user_06552e",
"avatar_url": "https://example.com/avatars/user_a0bf17.png",
"verified": true
},
"engagement": {
"views": 656685,
"likes": 2558,
"comments": 95,
"shares": 378,
"saves": 95
},
"flags": {
"nsfw": false,
"spoiler": null,
"pinned": false,
"deleted": false
},
"published_at": "2026-10-01T21:20:47.000Z",
"ext": {
"author_followers": 92377795,
"author_following": 115,
"author_posts_count": 74368,
"content_language": "en",
"quote_count": 37,
"all_media_urls": null
}
},
"computed": {
"engagement_rate": 0.004616,
"language": "en",
"content_category": "other",
"estimated_reach": 788022
}
}
],
"threads": [
{
"post": {
"id": "3998466748918692323",
"url": "https://www.threads.com/@nasa/post/Dd9aFLHgnnj",
"content": {
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"media_urls": "https://scontent-sjc3-1.cdninstagram.com/user_2352da/v/t16/f2/m84/AQNis7Y9YDNZep_iLYysbaC_w0BOwQDgZojwdfACyrk0_bjMkxZdNX0LCW-Q2TXysHZ7mega7fc-lOSMND3gN5UZc1fu7gVTqjHkz3M.mp4?_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-sjc3-1.cdninstagram.com&_nc_ohc=ILJGpKSQQ6AQ7kNvwFMFPjO&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uRkVFRC5DMy43MjAuZGFzaF9iYXNlbGluZV8xX3YxIiwieHB2X2Fzc2V0X2lkIjoxODEyMTg5MzE4NDk2MDM4OSwiYXNzZXRfYWdlX2RheXMiOjAsInZpX3VzZWNhc2VfaWQiOjEwMTY0LCJkdXJhdGlvbl9zIjoyNiwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&vs=877e25e1d824bc10&_nc_vs=HBksFQIYTGlnX2JhY2tmaWxsX3RpbWVsaW5lX3ZvZC84QzlEMkI3QTMyMUI0RUYyQkQzMjhGNkJGNkUxNDEzNl92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzI5RUU3RjU2Q0E0NzQ1NDE5NEMxNjQ5NkYzRjdBQTBFX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaK3pPfgfGwQBUCKAJDMywXQDrmZmZmZmYYEmRhc2hfYmFzZWxpbmVfMV92MREAdeoHZeieAQA&_nc_gid=JWvpn3Lldza6C8ebDYkjFQ&_nc_zt=28&_nc_ss=7a22e&oh=00_AQM3u8kAei1u6g3LkTTQADRrMBGFcxhcrBIwid0BOQr77w&oe=6AC16EF5",
"thumbnail_url": "https://scontent-sjc6-1.cdninstagram.com/user_4c9448/t51.71878-15/829554963_1749682576339320_650764131521691465_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=109&ig_cache_key=Mzk5ODQ2Njc0ODkxODY5MjMyMw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuNjQwLnNkci52aWRlb19kZWZhdWx0X2NvdmVyX2ZyYW1lLkMzIn0%3D&_nc_ohc=X0S4ZXajsTgQ7kNvwFYL4nA&_nc_oc=AdpDfWjUqvO5129B-HqfLtXpk8iMYi8mqNRiNl6uBxKTY_ri0ceWD0huk7xgtHW1_0o&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-sjc6-1.cdninstagram.com&_nc_gid=JWvpn3Lldza6C8ebDYkjFQ&_nc_ss=7a22e&oh=00_AQMBxxVUJHbr_3Oa5G4CZPJxJJSc62sxa520RAtE7nJzKA&oe=6AC57631",
"duration_seconds": null
},
"author": {
"username": "nasa",
"display_name": null,
"avatar_url": "https://example.com/avatars/user_e0d089.png",
"verified": true
},
"engagement": {
"views": null,
"likes": 929,
"comments": 40,
"shares": 36,
"saves": null
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": false,
"deleted": false
},
"published_at": "2026-10-01T17:12:26.000Z",
"ext": {
"published_at_epoch": 1790874746,
"quote_count": 5,
"topic_tag": null,
"reshare_count": 16,
"topic_tag_id": "18401017042011621"
}
},
"computed": {
"engagement_rate": null,
"language": "en",
"content_category": "other",
"estimated_reach": null
}
},
{
"post": {
"id": "3997687698517220723",
"url": "https://www.threads.com/@nasa/post/Dd6o8f5EV1z",
"content": {
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"media_urls": [
"https://scontent-sjc6-1.cdninstagram.com/user_4c9448/t51.82787-15/830729245_18121711231960389_7134118492960933179_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=108&ig_cache_key=Mzk5NzY4NzY4ODYwMTkyMjY4NQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTUzNi5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=tRIAsQJqC2cQ7kNvwGHyD_7&_nc_oc=AdqIoe9VDjX5_9rYFlqyVgnY8Rdt8cLsLjRhfP2u1mEhQ6hci0u6x7vbqvOJXV9MOSA&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-sjc6-1.cdninstagram.com&_nc_gid=JWvpn3Lldza6C8ebDYkjFQ&_nc_ss=7a22e&oh=00_AQON3IaCQJjLLEd9gxNrk8KnEJehq4NAwiKC3UF_6Z_1tQ&oe=6AC59280",
"https://scontent-sjc6-1.cdninstagram.com/user_4c9448/t51.82787-15/831641539_18121711249960389_8129064584883051938_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=109&ig_cache_key=Mzk5NzY4NzY4ODYxODY1OTkzNA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTUzNi5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=cFEBGzaZj9MQ7kNvwGUgbbB&_nc_oc=AdoGQ6kvEFjAoMUtb9jkhmTfVhAQF5iUgz12QQms_P-7X2HhkWjmy1LCoU9kzxtYtZ0&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-sjc6-1.cdninstagram.com&_nc_gid=JWvpn3Lldza6C8ebDYkjFQ&_nc_ss=7a22e&oh=00_AQNlOeXXrepoSF_JgU888svGL_OxaPpS30cPHMCBXVaStg&oe=6AC586E2"
],
"thumbnail_url": null,
"duration_seconds": null
},
"author": {
"username": "nasa",
"display_name": null,
"avatar_url": "https://example.com/avatars/user_e0d089.png",
"verified": true
},
"engagement": {
"views": null,
"likes": 1965,
"comments": 43,
"shares": 75,
"saves": null
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": false,
"deleted": false
},
"published_at": "2026-09-30T15:18:52.000Z",
"ext": {
"published_at_epoch": 1790781532,
"quote_count": 20,
"topic_tag": null,
"reshare_count": 10,
"topic_tag_id": "18401017042011621"
}
},
"computed": {
"engagement_rate": null,
"language": "en",
"content_category": "other",
"estimated_reach": null
}
}
],
"bluesky": [],
"truthsocial": []
},
"merged_timeline": [
{
"platform": "twitter",
"post": {
"id": "2105842656429432894",
"url": "https://x.com/user_06552e/status/2105842656429432894",
"content": {
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"media_urls": "https://pbs.twimg.com/amplify_video_thumb/2105842619867656192/img/RLtky5UmWy8qAhZd.jpg",
"thumbnail_url": "https://pbs.twimg.com/amplify_video_thumb/2105842619867656192/img/RLtky5UmWy8qAhZd.jpg",
"duration_seconds": 65.301
},
"author": {
"username": "user_06552e",
"display_name": "user_06552e",
"avatar_url": "https://example.com/avatars/user_a0bf17.png",
"verified": true
},
"engagement": {
"views": 797945,
"likes": 9451,
"comments": 261,
"shares": 1143,
"saves": 288
},
"flags": {
"nsfw": false,
"spoiler": null,
"pinned": false,
"deleted": false
},
"published_at": "2026-10-02T02:09:48.000Z",
"ext": {
"author_followers": 92377795,
"author_following": 115,
"author_posts_count": 74368,
"content_language": "en",
"quote_count": 77,
"all_media_urls": null
}
},
"computed": {
"engagement_rate": 0.013604,
"language": "en",
"content_category": "other",
"estimated_reach": 957534
}
},
{
"platform": "twitter",
"post": {
"id": "2105769921791549573",
"url": "https://x.com/user_06552e/status/2105769921791549573",
"content": {
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"media_urls": null,
"thumbnail_url": null,
"duration_seconds": null
},
"author": {
"username": "user_06552e",
"display_name": "user_06552e",
"avatar_url": "https://example.com/avatars/user_a0bf17.png",
"verified": true
},
"engagement": {
"views": 656685,
"likes": 2558,
"comments": 95,
"shares": 378,
"saves": 95
},
"flags": {
"nsfw": false,
"spoiler": null,
"pinned": false,
"deleted": false
},
"published_at": "2026-10-01T21:20:47.000Z",
"ext": {
"author_followers": 92377795,
"author_following": 115,
"author_posts_count": 74368,
"content_language": "en",
"quote_count": 37,
"all_media_urls": null
}
},
"computed": {
"engagement_rate": 0.004616,
"language": "en",
"content_category": "other",
"estimated_reach": 788022
}
}
],
"computed": {
"platform_presence": {
"twitter": true,
"threads": true,
"bluesky": false,
"truthsocial": false
},
"cross_post_rate": 0,
"tone_distribution": {
"twitter": {
"rally": 0,
"combative": 0,
"promotional": 0,
"informational": 0.8333333333333334,
"personal": 0.16666666666666666,
"neutral": 0,
"items": 12,
"counted": 12
},
"threads": {
"rally": 0,
"combative": 0,
"promotional": 0.18181818181818185,
"informational": 0.8181818181818182,
"personal": 0,
"neutral": 0,
"items": 12,
"counted": 11
}
},
"tone_by_platform": {
"twitter": "informational",
"threads": "informational"
}
},
"cursors_by_platform": {
"twitter": "DAAHCgABHToFvFP___ELAAIAAAATMjEwNTYzMzg5MDM1MDM1ODg4MAgAAwAAAAIAAA",
"threads": null,
"bluesky": null,
"truthsocial": null
},
"next_cursor": "eyJ0d2l0dGVyIjoiREFBSENnQUJIVG9GdkZQX19fRUxBQUlBQUFBVE1qRXdOVFl6TXpnNU1ETTFNRE0xT0RnNE1BZ0FBd0FBQUFJQUFBIn0",
"legs": [
{
"endpoint": "/v1/twitter/user/user_5f036a",
"status": 200,
"credits_used": 1,
"latency_ms": 2777,
"error": null
},
{
"endpoint": "/v1/threads/user/user_a44f1b",
"status": 200,
"credits_used": 1,
"latency_ms": 7553,
"error": null
}
]
},
"credits_used": 5,
"request_id": "req_example000000",
"cached": false,
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-02T12:43:24.373Z",
"redacted": true
}Live sample illustrating the unified response shape. Field values reflect the record you query.
API Details
How does the Prism Voice 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
Developer First
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 69 platforms covering 10B+ monthly active users.
One schema, every platform
Query 69 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()[ .JSON ]
{
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}FAQ
Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usWhat is the SocialCrawl Truth Social API (Prism Voice)?
The Truth Social API endpoint GET /v1/prism/voice takes one handle and pulls that person's recent public posts from four microblogs (X, Threads, Bluesky, and Truth Social) in parallel. It time-merges them into one chronological feed and adds platform presence, cross-post rate, and a per-platform tone label.
Which platforms does the voice endpoint cover?
Four microblogs: X (Twitter), Threads, Bluesky, and Truth Social. Pass the platforms parameter to scope down, for example platforms=twitter,truthsocial. A handle the person isn't on returns an empty array and platform_presence=false, which is a valid answer, not an error.
How much does a Prism Voice call cost?
Each call is a flat 5 credits, covering all four microblog legs plus the time-merge and tone analysis. New accounts get 100 free credits with no credit card. If the handle is on zero of the four platforms, the call returns no data and the 5 credits are refunded in full.
What is cross_post_rate in the voice response?
It is the fraction of a person's posts that appear near-duplicated on another platform within a short time window, computed by text similarity, no LLM. A high cross-post rate means they broadcast the same message everywhere; a low rate means they tailor each audience differently.
Why track one person's voice across X, Threads, Bluesky, and Truth Social?
Executives, founders, and politicians increasingly post differently to different audiences: measured on X, combative on Truth Social. Voice surfaces that divergence in one call. No other API time-merges all four microblogs, which makes it built for comms risk, founder-signal, and accountability work.
Do I need to send the platform with the handle?
No. The handle parameter is the only required input, and one leading @ is stripped automatically. Voice queries all four microblogs with the same handle, so you do not map handles per platform. The platform_presence map tells you which of the four the person actually posts on.
Ask AI about SocialCrawl
Ready to scrape Prism Voice data?
Get your API key and start pulling Prism data in under 60 seconds.