# Prism Creator Card API (https://www.socialcrawl.dev/platforms/prism/creator-card)

> Looks up a single handle across multiple platforms in parallel and returns one unified author card per platform — followers, verified flag, bio, ids — with null for the platforms the handle isn't found on, plus combined follower totals and an any-verified flag. The default set is TikTok, Instagram, YouTube, and Twitter; Threads, Bluesky, and Truth Social can be added via `platforms`. A handle existing on only some platforms is a successful, complete answer (the nulls are the product); only an all-platform miss refunds. Flat 5 credits for up to 4 platforms, +1 credit per extra platform. `legs[]` reports each platform leg's status, cost, and latency.

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

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `handle` | yes | The handle to look up across every requested platform (a single leading @ is stripped). |
| `platforms` | no | CSV subset of tiktok,instagram,youtube,twitter,threads,bluesky,truthsocial (default the first four). Unknown platforms are ignored. |
| `include` | no | CSV subset of cards,totals to trim the payload (cards is always returned). |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/prism/creator-card?handle=mrbeast" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I look up a creator across multiple platforms at once?

Send GET /v1/prism/creator-card?handle=<handle> with your API key. The creator profile API queries that handle on TikTok, Instagram, YouTube, and X in parallel and returns one unified author card per platform, with null where the handle isn't found.

### What if the handle only exists on some platforms?

That's the normal case and a complete answer, not an error. Platforms where the handle isn't found come back as null and are listed in found_on, and you still get cards plus combined follower totals for the platforms that resolved. You are not charged extra for the misses.

### Which platforms can the creator profile API check?

TikTok, Instagram, YouTube, and X by default, plus Threads, Bluesky, and Truth Social on request through the platforms parameter — up to eight. An unknown platform name is dropped with a warning rather than failing the whole call.

### How is the creator profile API priced?

It is a flat 5 credits for up to four platforms, plus 1 credit per extra platform. A handle that exists on only two of four platforms still costs 5 credits because the nulls are the answer; if the handle is found on zero platforms, the call is refunded in full.

### What's in each author card?

Each card carries the follower count, a verified flag, display name, bio, and the platform's own ids, on one shared schema. A totals block adds the combined follower count across the platforms where the handle was found and an any-verified flag.

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:

- Which API returns a creator's follower counts across TikTok, Instagram, and YouTube at once?
- How do I check if a handle exists on multiple social platforms with one API call?