URL lookup
0 credits (pass-through)/v1/prism/lookupPaste a social or shopping URL. Prism resolves the platform and resource, then returns the post, profile, video, or product in one envelope. Billing follows the resolved endpoint.
url, include
Call SocialCrawl Prism with one API key. Get composite social analytics as structured JSON. URL lookup, multi-platform handles, brand intelligence, crisis, GEO, and batch posts or profiles. Reads are priced in credits.
33 active composite endpoints.
Thirty-three live composite endpoints under /v1/prism. Resolve any social URL, fan out handles across platforms, run brand and crisis intelligence, probe AI visibility, and batch post or profile refreshes. Data API only. No posting and no private accounts.
/v1/prism/lookupPaste a social or shopping URL. Prism resolves the platform and resource, then returns the post, profile, video, or product in one envelope. Billing follows the resolved endpoint.
url, include
/v1/prism/commentsHarvest every comment on a TikTok, YouTube, Facebook, Reddit, Hacker News, or Instagram post URL. Pages to completion with nested replies where the platform allows.
url, max, replies, cursor, sort, limit
/v1/prism/creator-cardLook up one handle across platforms in parallel. Returns followers, verified status, bio, and ids per platform, or null where the handle is missing.
handle, platforms, include
/v1/prism/handle-auditScored pre-flight check for a handle across platforms. Verdict, per-platform scores, activity signals, and a projected credit cost for a full pull.
handle, platforms, sample
/v1/prism/voiceMerge one person's recent posts from X, Threads, Bluesky, and Truth Social into a single time-ordered feed, plus which networks they are active on.
handle, platforms, cursor, include
/v1/prism/video-intelOne video URL in: details, stats, comments, optional transcript, and on TikTok or Instagram a few commenter profiles. Covers YouTube, TikTok, Rumble, and Instagram.
url, comments, include
/v1/prism/answersAsk several AI search engines the same question. Returns each answer verbatim, merged citations, and where the engines agree or disagree.
query, engines, include
/v1/prism/brand-mentionsOne keyword mention report: volume over time, positive and negative split, top sources, and recent mention samples in a single call.
keyword, date_from, date_to, date_group, page_type, include
/v1/prism/demand-signalsFuse web mention slope, Reddit velocity, product review levels, and optional app review speed into a transparent consumer demand index.
keyword, google_play_id, app_store_id, signals, amazon_query, country, date_from, date_to, depth
/v1/prism/campaignMeasure a hashtag or phrase campaign: pre, during, and post volume, engagement by platform, and the accounts amplifying it most.
hashtag or phrase, window_start, window_end, pre_days, post_days, include
/v1/prism/ai-visibilityHow often answer engines name your brand for a prompt set, plus which domains they cite. For AEO and GEO tracking.
brand, prompts, topic, competitors, engines, runs, preset, include
/v1/prism/crisis-radarCompare today mention volume and negative share to a recent daily baseline. Returns calm, watch, alert, or crisis for recurring checks.
brand, sensitivity, confirm, baseline_days, date_to
/v1/prism/crisis-postmortemReconstruct a brand crisis timeline across web, Reddit, Hacker News, and social: origin, peak, propagation, and a written summary.
brand, window_start, window_end, crisis_terms, include
/v1/prism/reputationBlended reputation from Trustpilot, app stores, Google Business, and web sentiment, with themed pros, cons, and quotes.
brand, sources, country, depth, place, axis, app_store_id, google_play_id, include
/v1/prism/share-of-voiceEngagement-weighted share of voice for two to five brands, split into web and social, with emotion breakdown and per-brand trend.
brands, category_code, market_shares, include, page_type, date_from, date_to
/v1/prism/leadsRanked public posts and comments where people ask for alternatives to a competitor or say they are switching away.
competitor, product_category, freshness, include, limit
/v1/prism/devtool-pulseHealth snapshot for a developer tool: GitHub repo details, Hacker News reaction, Reddit chatter, blog coverage, and a summary label.
query, repo, subreddit, include, date_from, date_to
/v1/prism/launch-echoHow a launch was received: top Hacker News threads and comments, blog coverage, and optional GitHub repository context.
query, repo, threads, date_from, date_to, include
/v1/prism/org-radarGitHub organization footprint: most starred repos with releases, open issue load, and top feature request and complaint signals.
org, repos, sort, include
/v1/prism/earned-mediaDeduplicated ranked feed of news, tech press, and fresh web articles mentioning a brand, plus which outlets covered it most.
brand, competitor, date_from, date_to, min_domain_rank, include
/v1/prism/truthsocial-pulseOne Truth Social account: profile, recent posts, detail on top posts, related news, plus activity and sentiment read.
handle, drill, posts, news_query, include, cursor
/v1/prism/audience-overlapHow much two TikTok creators' commenting audiences overlap: shared people, overlap score, unique counts, and confidence.
handle_a, handle_b, platform, videos_per_creator, depth
/v1/prism/employer-brandWhat people say about working at a company across Reddit, news, and YouTube, plus LinkedIn post tone when you pass linkedin_url.
company, linkedin_url, surfaces, phrases, timeframe, date_from, date_to
/v1/prism/audience-questionsReal questions people ask about a topic from Reddit and YouTube, grouped by intent such as who, what, why, how, and comparisons.
topic, platforms, max_questions, threads_per_source, timeframe, include
/v1/prism/product-reviewsOne product across Amazon, Google Shopping, and Trustpilot: rating per source, retailer comparison, and themes moving the score.
query or asin or gid, sources, country, depth, competitors, include
/v1/prism/apps-lookupOne app on Google Play and the App Store side by side: rating, installs, price, store gap, and match confidence.
title or google_play_id or app_store_id, stores, country, language, match_threshold, include
/v1/prism/app-reviewsGoogle Play and App Store reviews together: rating summaries, topic clusters, sentiment over time, feature requests, and dev reply rate.
google_play_id, app_store_id, query, country, language, depth, stores, include
/v1/prism/creator-vetVetting signals for a creator: engagement rate, commenter authenticity, posting frequency, and news or forum controversy.
handle, platform, depth, include
/v1/prism/korea-gapGap between global and Korean talk about a topic: which Naver surfaces carry it, channel map, and translated example quotes.
query, include, date_from, date_to, display
/v1/prism/review-integrityA to F grade on whether product ratings look trustworthy across Amazon, Google Shopping, Trustpilot, and the open web. Deterministic, no LLM.
query or asin or gid, sources, country
/v1/prism/post-statsPOST up to 100 mixed-platform post URLs. Returns view, like, comment, share, and save counts one row per URL in input order.
body urls (1-100), include
/v1/prism/comment-lookupPOST up to 25 known comments to re-check current state. Per-item found, not found, errored, or deferred status.
body items (1-25)
/v1/prism/profilesPOST up to 50 platform and handle pairs. Returns each profile in input order with per-row status, same shape as single profile calls.
body items (1-50)
Returns the data behind any social or shopping link you paste in: the post, profile, video, or product that URL points to, in one response.
Use it when you have a URL but do not know which platform endpoint fits, so you can skip writing your own link parsing and routing.
0 credits
url · Absolute http(s) URL of a single post, video, product or repo. Profile, channel and storefront URLs are NOT accepted: use that platform's own `/profile` endpoint for those.
$ curl https://www.socialcrawl.dev/v1/prism/lookup?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ \
-H "x-api-key: sc_YOUR_API_KEY"// Running this live needs your own API key. Hit "Try it" to see an example responsePrism is SocialCrawl's composite layer under /v1/prism. You call GET or POST with one API key, spend credits on live work, and get the shared JSON envelope. No second SDK and no per-platform OAuth for these composites.
Send your key in the x-api-key header. The same SocialCrawl key works for every /v1/prism recipe and the rest of the platform catalog.
Most Prism routes are GET with query params. post-stats, comment-lookup, and profiles are POST with JSON bodies. We validate before charging.
Composites bill by recipe: flat tiers, per-probe meters, or per-item batch costs. Cache hits cost 0. Empty or hard failures refund. Bad params return 400 with no charge.
Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. Many composites also surface legs[] or per-item status for audit.
Most products start with a URL or handle, deepen into creator or voice context, then run brand or crisis intelligence when monitoring is the job.
GET /v1/prism/lookup?url=…lookup: resolved platform path plus post or profile payload
You have a link but not the platform endpoint. Prism routes and bills the resolved leg.
GET /v1/prism/creator-card?handle=…&platforms=…creator-card: one author card per platform for a handle
Confirm presence and follower counts before a deeper pull or partnership.
GET /v1/prism/handle-audit?handle=…handle-audit: scored verdict plus projected pull cost
Pre-flight risk and credit estimate before you spend on full collection.
GET /v1/prism/brand-mentions?keyword=…&date_from=…brand-mentions: volume timeline, sentiment, sources
Keyword monitoring after the identity is known.
GET /v1/prism/lookup
?url=https://www.tiktok.com/@…/video/…
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
# multi-platform handle
GET /v1/prism/creator-card?handle=mrbeast&platforms=tiktok,instagram,youtube
GET /v1/prism/handle-audit?handle=mrbeast{
"success": true,
"data": {
"resolved": {
"platform": "tiktok",
"resource": "post",
"path": "/v1/tiktok/post"
},
"result": {
"id": "7123456789",
"url": "https://www.tiktok.com/@…/video/…",
"content": { "text": "Example caption" }
}
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}Prism returns finished composite objects, not raw multi-scraper glue. Field names stay close to SocialCrawl archetypes where a social leaf applies.
lookup resolved path + result; creator-card and handle-audit per-platform cards, scores, and nulls where missing
volume timelines, sentiment splits, share metrics, campaign lift windows, blended reputation with themes and quotes
engine answers with citations, agreement maps, brand mention rates in AI replies, cited domain ranks
post-stats, profiles, comment-lookup: per-item rows in input order with status and engagement or profile leaves
Same request lifecycle as every other /v1 surface. Prism is composite orchestration on top of registry endpoints, not a separate product auth path.
Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit and concurrency for the key.
Registry lookup finds the prism resource. Required params and body shape checks run first. Invalid input returns 400 with no charge. Valid calls debit the recipe cost (or hold for metered batches) before fan-out.
A deterministic cache key is built from platform, resource, and params. Hit: return with credits_used = 0. Miss: parallel platform legs, content analysis, or AI probes run under the recipe, with retries and circuit breakers where policy allows.
Legs merge into one Analytics or batch result, validate against the response contract, wrap the success envelope, attach leg receipts when the recipe bills per leg, and log for billing audit.
Billing rules that matter in production
Prism is a composite layer over SocialCrawl social reads, content analysis, app stores, marketplaces, and AI answer engines. One key and one envelope instead of many scrapers.
Finished composite jobs: resolve a URL, audit a handle, monitor a brand, grade reviews, probe AI visibility, or refresh a batch of posts. Read-only. No posting and no private inbox access.
Each recipe fans out to registered platform endpoints and analysis legs in parallel, then fuses and scores in code. Deterministic grades where the contract says so. LLM only where the recipe documents narrative or clustering.
The unified JSON envelope: success, data, credits_used, request_id, cached. Composite data objects plus optional legs[] receipts so you can audit which sources contributed.
No write endpoints. No per-platform profile/full under /v1/prism (those live on each platform hub). No guaranteed private or authenticated social content.
The jobs this API is most often used for.
Cross-platform resolve, brand intelligence, and creator pre-flight
Callers concentrate on lookup, creator-card, handle-audit, brand-mentions, and the flagship intelligence recipes (share-of-voice, review-integrity, ai-visibility, crisis). Batch post-stats shows up in monitoring loops. One composite layer for URL routing, multi-platform handles, brand and crisis intelligence, GEO probes, and metered batch refreshes under a single API key.
Simple resolve and handle cards are typically a few seconds on live miss. Multi-source intelligence recipes are slower because they fan out and fuse several legs.
The jobs Prism data is most often used for. Each one is a full recipe with the endpoint chain and pricing.
Common ways teams put this data to work, and the stack each one tends to run.
Run brand-mentions, crisis-radar, and earned-media on a fixed cadence. Escalate to crisis-postmortem when status leaves calm.
creator-card and handle-audit first, then creator-vet or audience-overlap before spend. Same key as the rest of SocialCrawl.
lookup for URL routing, post-stats and profiles for batch refresh, intelligence recipes when a finished grade or SOV number is the product output.
Start with lookup or creator-card. Cache hits are free. Intelligence recipes and POST batches use the higher rungs documented per endpoint.
curl "https://www.socialcrawl.dev/v1/prism/lookup?url=https://www.tiktok.com/@mrbeast/video/7123456789" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/prism/creator-card?handle=mrbeast&platforms=tiktok,instagram,youtube" \
-H "x-api-key: sc_your_api_key_here"Same key as the rest of the catalog
Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.
Same Prism data, two very different paths. Auth, rate limits, schema, and cost, side by side.
| Feature | SocialCrawl | Calling each endpoint by hand |
|---|---|---|
| Platform detection | Sniffs the platform and endpoint from the URL automatically | You map every URL pattern to the right endpoint yourself |
| Calls to learn | One request shape for any of 15 supported URL types | A different request to learn and wire up per platform |
| Pricing | Pass-through: the underlying endpoint's price, no markup | Same per-endpoint cost, plus the routing logic you maintain |
| Response shape | Unified JSON with a resolved{} routing block and legs[] transparency | Each platform hands back its own raw payload to normalize |
| Maintenance | Routing stays current as endpoints and URL shapes change | Your URL parsing breaks when a platform changes its links |
Platform detection
Calls to learn
Pricing
Response shape
Maintenance
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usAsk AI about SocialCrawl