# Prism Find Accounts API (https://www.socialcrawl.dev/platforms/prism/find-accounts)

> Runs the existing account searches for `name` on each platform (`instagram/search/profiles`, `tiktok/search/users`, `twitter/search/users`, and `linkedin/search/people` for a person or `linkedin/search/companies` for a company), keeps the top `candidates` public accounts of each (private accounts are dropped), and ranks them. Each platform returns `candidates` (rank, handle, display name, profile URL, followers, verified flag, a bio excerpt and `choice_probability`, the judged probability that this account is the target's own) and one `match`: `handle` is the leading candidate, `level` is `same`, `possible` (connected but not shown to be the target's own, such as a fan or regional account), `different`, `uncertain` (the ranking was flat or the check was unsure), or `none` (none of the candidates is the target's own account, or the search found nothing), with `confidence` (the weaker of the ranking and the check), `basis` and `evidence` (`website_match`, `cross_link`, `bio_consistent`, `fan_or_parody`). The leading candidate is always checked a second time against the name and context you sent; a ranking alone is never a match. With `website`, an account that links to that site and is platform-verified is taken as the match without judging (`basis: exact_link`); an unverified account linking to it is judged like the rest. `employer` (person only) and `location` give the judgment context. These are automated labels for a human reviewer, not an identification: `automated_decision` is false and the response never states who runs an account. If the judgment is unavailable, candidates come back in search order with `match.level` null, `_warnings` says why, and the judging credits are refunded. LinkedIn is included by default for a company only, because its search costs 10 credits.

TL;DR: `GET /v1/prism/find-accounts` costs The searches at their own prices (1 credit each for Instagram, TikTok and X, 10 for LinkedIn) plus 1 credit per platform judged: 6 credits for a person by default, 17 for a company (LinkedIn included). A search that fails and a platform that could not be judged are refunded and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `name` | yes | The person's or the company's name, 2 to 120 characters. |
| `type` | no | `person` (default) or `company`. Sets the default platforms and the LinkedIn search used. (person \| company) |
| `platforms` | no | Comma-separated subset of linkedin, instagram, tiktok, twitter. Default: instagram, tiktok, twitter for a person; all four for a company. An unknown member is a 400. |
| `employer` | no | Optional current employer of the person, used only as context for the judgment (type=person only). |
| `location` | no | Optional city or country, used only as context for the judgment. |
| `website` | no | Optional official website or domain (e.g. ogilvy.com). A platform-verified account linking to it is taken as the match without judging. |
| `candidates` | no | Accounts judged per platform, 1 to 5 (default 5), taken from the top of each search. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/prism/find-accounts?name=Ogilvy" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

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