# 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. A handle existing on a platform does not mean it is the same creator there: send `verify=true` to get an `identity` verdict per platform (same, possible, different) with the evidence, at the same price.

TL;DR: `GET /v1/prism/creator-card` costs 5 credits covering any 4 platforms, plus 1 credit per platform beyond 4. The default selection is 4 platforms, so the 7-platform maximum is 8 credits 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). |
| `verify` | no | Send `true` to add an `identity` block that says whether each found profile is the same person or organisation as the anchor profile, not only that the handle exists there. Each platform gets a verdict with `level` (`same`, `possible`, `different`, or `uncertain` when the answer is not confident), a `score`, a `confidence` and the `evidence` behind it (`cross_link`, `bio_consistent`, `fan_or_parody`, `website_match`). A `null` verdict means that profile was not judged, not that it is different. `identity.verified_on` lists the anchor plus every `same` platform, and with it `totals.combined_followers` adds only those platforms while `totals.unverified_followers` holds the followers of the found profiles not judged `same`. Public profile text only, no image comparison. Same price; adds well under a second. |
| `anchor` | no | With `verify=true`, the platform whose profile you already trust; every other found profile is compared against it. Omit it and the anchor is the platform-verified profile with the largest audience. If the chosen platform has no card in the response the anchor is picked automatically and `_warnings` says so. (tiktok \| instagram \| youtube \| twitter \| threads \| bluesky \| truthsocial) |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/prism/creator-card" \
  --data-urlencode "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?