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

> Sniffs the platform + endpoint from a URL and returns that endpoint's unified data, with no surcharge — you pay the resolved endpoint's own cost. The join key the whole API runs on is `url`. Supports TikTok, Instagram, YouTube, X/Twitter, Facebook, LinkedIn, Bluesky, Pinterest, Reddit, Threads, Rumble, Truth Social, GitHub, Amazon, and Spotify links. The `resolved` block names the platform, endpoint, and archetype of the response so agents know the shape that follows; `legs[]` reports the dispatched call's status, cost, and latency.

TL;DR: `GET /v1/prism/lookup` costs 0 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Absolute http(s) URL of the post / profile / product to resolve. |
| `include` | no | CSV of optional flags to forward verbatim to the resolved endpoint (e.g. `trim`). Each member must be an optional param of that endpoint. |

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

## FAQ

### How do I use the social media URL API?

Send GET /v1/prism/lookup?url=<your-link> with your API key and SocialCrawl's social media URL API detects the platform and endpoint from the URL and returns that endpoint's unified data. The url parameter is the only required input — no platform name needed.

### What parameters does /v1/prism/lookup accept?

url is required and must be an absolute http(s) link to a supported host. The optional include parameter forwards the dispatched endpoint's own optional flags (like trim or get_comments) verbatim; unknown members return a 400 naming the accepted set.

### How is a Reddit URL handled?

A reddit.com/r/.../comments/... link resolves to the reddit/post/comments endpoint, so the response is a CommentList of the thread's comments rather than a single post object. The resolved.archetype field says CommentList so you know the shape before parsing.

### What happens if the URL is dead or unsupported?

An unsupported host returns 400 with the accepted host list and costs zero credits. A supported but dead link returns 404 and the credits are refunded automatically, so you are never charged for a URL that returns no data.

### Can AI agents use this endpoint?

Yes — it is built for it. An agent that holds a link but doesn't know the platform can pass it straight to /v1/prism/lookup and get structured data back. It is the single best one-call shape for MCP tools and coding agents working with social and commerce URLs.

See the full Prism API: https://www.socialcrawl.dev/platforms/prism

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

- How to get data from any social media URL with one API call
- What does SocialCrawl's GET /v1/prism/lookup return?