# Prism Data API (https://www.socialcrawl.dev/platforms/prism)

> GET /v1/prism/lookup turns any social or commerce URL into structured data in one call. Hand it a TikTok video, an Instagram reel, a YouTube link, a Reddit thread, a GitHub repo, or an Amazon product page — Prism detects the platform, calls the right endpoint, and returns SocialCrawl's unified JSON. No surcharge: you pay the underlying endpoint's price, nothing more.

TL;DR: SocialCrawl's Prism API exposes 33 endpoints, 0 to 50 credits per call, all returning one unified JSON schema with AI-enriched fields. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Lookup | GET | `/v1/prism/lookup` | 0 | Universal URL dispatcher: any social/commerce URL → the right detail endpoint's unified response. |
| Comments | GET | `/v1/prism/comments` | 1 | Every comment on a post, replies nested, server-paginated to completion. |
| Brand Mentions | GET | `/v1/prism/brand-mentions` | 50 | Brand mention volume time-series, sentiment split, top sources, and recent mentions for one keyword. |
| Demand Signals | GET | `/v1/prism/demand-signals` | 30 | Consumer-demand nowcast: app-review velocity, web mention slope, Reddit velocity, and commerce review levels, fused into a published demand index. |
| Campaign | GET | `/v1/prism/campaign` | 35 | Campaign tracker: pre/during/post volume lift, cross-platform engagement, and ranked top amplifiers for a hashtag or phrase. |
| Ai Visibility | GET | `/v1/prism/ai-visibility` | 2 | AI Share-of-Voice / GEO monitoring: prompt set x reruns to per-brand appearance-% per AI engine plus a cited-domain ranking. |
| Crisis Postmortem | GET | `/v1/prism/crisis-postmortem` | 35 | Crisis post-mortem: a who-said-what-first timeline across web, Reddit, Hacker News, and social, with an origin, peak, propagation sequence, and a grounded narrative. |
| Crisis Radar | GET | `/v1/prism/crisis-radar` | 15 | Stateless crisis breach check: a z-score on daily mention volume and negative share, with on-breach confirmation and a severity grade. |
| Devtool Pulse | GET | `/v1/prism/devtool-pulse` | 20 | Developer-brand health: a devtool's repo dossier + Hacker News reaction + Reddit chatter + dev-blog echo, in one call. |
| Leads | GET | `/v1/prism/leads` | 50 | Ranked feed of public conversations where people seek alternatives to or are switching from a competitor. |
| Earned Media | GET | `/v1/prism/earned-media` | 25 | A brand's earned-media footprint — news + tech-press + fresh-web clips, deduped and ranked, with an outlet-coverage rollup. |
| Truthsocial Pulse | GET | `/v1/prism/truthsocial-pulse` | 20 | A Truth Social handle's pulse — profile, recent posts, per-post detail drill, and the news echo, in one call. |
| Launch Echo | GET | `/v1/prism/launch-echo` | 20 | How a launch landed — the Hacker News reaction (top threads + comments), the dev-blog echo, and an optional repo dossier. |
| Audience Overlap | GET | `/v1/prism/audience-overlap` | 20 | How much two TikTok creators' commenter audiences overlap — Jaccard, shared-fan count, and a confidence label. |
| Reputation | GET | `/v1/prism/reputation` | 30 | A brand's cross-source reputation — Trustpilot + app stores + Google Business + web sentiment, blended into one weighted score with themed pros/cons. |
| Employer Brand | GET | `/v1/prism/employer-brand` | 30 | A company's employer brand — what people say about working there across Reddit, the web, YouTube, Naver, and the company's own LinkedIn voice. |
| Audience Questions | GET | `/v1/prism/audience-questions` | 30 | The real questions a topic's audience asks — harvested from Reddit + YouTube threads and clustered by intent (who/what/why/how/vs). |
| Product Reviews | GET | `/v1/prism/product-reviews` | 30 | A product's reviews across Amazon + Google Shopping + Trustpilot, folded into a cross-marketplace rating + themed pros/cons report. |
| Apps Lookup | GET | `/v1/prism/apps-lookup` | 30 | One app across Google Play + the App Store — resolved, title-matched, and compared into a cross-store rating + listing report. |
| Org Radar | GET | `/v1/prism/org-radar` | 26 | A GitHub org's footprint — its top repos each expanded into a full dossier (releases, issue load, top request/complaint), rolled up. |
| Creator Vet | GET | `/v1/prism/creator-vet` | 50 | Vet a creator before partnering — engagement quality, commenter authenticity, posting cadence, and controversy signals, optionally across platforms. |
| Korea Gap | GET | `/v1/prism/korea-gap` | 40 | What the world is talking about that Korea isn't (and vice versa) — the global vs Korean (Naver) conversation gap for a brand/topic. |
| Share Of Voice | GET | `/v1/prism/share-of-voice` | 40 | Engagement-weighted Share of Voice across 2-5 brands, with web+social split, emotion overlay, and ESOV. |
| Review Integrity | GET | `/v1/prism/review-integrity` | 30 | Cross-source review integrity verdict (statistical, deterministic). |
| Answers | GET | `/v1/prism/answers` | 15 | Multi-engine AI consensus: one question → Perplexity + Grok + Tavily answers verbatim, merged citations, and an agreement matrix. |
| Video Intel | GET | `/v1/prism/video-intel` | 5 | One video URL → detail + stats + transcript + top comments + commenter sample, across YouTube/TikTok/Rumble/Instagram. |
| Voice | GET | `/v1/prism/voice` | 5 | One person's public posts across X, Threads, Bluesky, and Truth Social, time-merged. |
| App Reviews | GET | `/v1/prism/app-reviews` | 15 | Cross-store app review intelligence (Google Play + App Store) — translated, clustered, sentiment-scored. |
| Creator Card | GET | `/v1/prism/creator-card` | 5 | One handle, unified author cards across TikTok, Instagram, YouTube, X (and more). |
| Handle Audit | GET | `/v1/prism/handle-audit` | 5 | Should you pull this handle? One call scores a handle across platforms, ranks the best ones, and projects the data volume + credit cost to pull it. |
| Post Stats | POST | `/v1/prism/post-stats` | 1 | Up to 100 mixed-platform post URLs → current engagement per URL, failed URLs refunded. |
| Comment Lookup | POST | `/v1/prism/comment-lookup` | 2 | Re-check up to 25 known comments in one call — per-item results, failed items refunded. |
| Profiles | POST | `/v1/prism/profiles` | 1 | Up to 50 (platform, handle) pairs → one canonical Author per row, failed handles refunded. |

## Code example

```bash
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"
```

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## SocialCrawl vs Calling each endpoint by hand

| 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 |

## FAQ

### What is the SocialCrawl social media URL API?

GET /v1/prism/lookup is SocialCrawl's social media URL API: it takes any supported social or commerce URL, detects the platform and the right detail endpoint, and returns that endpoint's unified JSON in one call. You hand it a link and get back structured data — no need to know which of SocialCrawl's endpoints to call.

### Which URLs does the lookup API support?

Fifteen URL types today: TikTok videos, Instagram posts and reels, YouTube watch links, X/Twitter status URLs, Facebook posts, LinkedIn posts, Bluesky posts, Pinterest pins, Reddit threads, Threads posts, Rumble videos, Truth Social posts, GitHub repos, Amazon product pages, and Spotify tracks. Unsupported hosts return a 400 with the accepted list and cost nothing.

### How much does a URL lookup cost?

There is no routing surcharge — you pay the underlying endpoint's normal price. A social URL costs 1 credit; an Amazon product URL costs 5 credits because it dispatches the advanced commerce endpoint. The credits_used field always reports the resolved cost.

### What does the response look like?

You get SocialCrawl's standard envelope with a resolved{} block naming the platform, endpoint, and archetype it routed to, the dispatched endpoint's unified data spread in, and a legs[] array showing the leg's status, credits, and latency. The archetype tells you whether to expect a Post, Author, Product, or CommentList shape.

### Why use one URL endpoint instead of calling each platform directly?

You stop maintaining URL-to-endpoint routing yourself. Prism sniffs the platform from the link, handles per-platform quirks like Truth Social's URL shape and Amazon's ASIN extraction, and keeps the routing table current as endpoints change. One request shape covers every supported link.

### Do I need to send the platform name with the URL?

No. The url parameter is the only required input — Prism infers the platform and endpoint from the host and path. That makes it the ideal first call for AI agents and integrations that hold a link but don't know which platform it belongs to.

### Does SocialCrawl offer a cross-platform social data API?

Yes, SocialCrawl is that cross-platform data API, and Prism is its one-call front door. Hand GET /v1/prism/lookup any supported social or commerce URL and it detects the platform, routes to the right detail endpoint, and returns unified JSON, so you read a TikTok video, an Instagram reel, a Reddit thread, a GitHub repo, or an Amazon product page through one request shape. There is no routing surcharge: you pay the underlying endpoint's normal price.

## 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

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- What API turns any social media URL into structured JSON?
- How do I get data from a social media link with one API call?
- Which SocialCrawl endpoint detects the platform from a URL and returns unified data?