# 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. With `website`, an account in the search results whose own website is that domain is always among the candidates, in place of the lowest one without that link. For a company with `website`, a LinkedIn company search that fails is answered by `linkedin/company/by-domain`, whose page is then the one LinkedIn candidate. 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. Threads (`threads/search/users`) and YouTube (`youtube/search` with `type=channels`, whose channel rows carry the description and subscribers) are searched only when named in `platforms`. Each platform's `match` also carries `match_confidence` (0 to 1, null when there is no candidate), how sure the response is that `handle` is the target's own account, and `accepted`, true when `match_confidence` is at or above `match_confidence_floor` (0.6). `data.items` lists the accepted accounts, one per platform at most, as canonical author rows with their `match`; a platform below the floor lists no item, so a reader of `items` gets no match rather than a guess. With `website`, `match.evidence` adds `domain` (the site checked), `domain_match` and `domain_source` (`external_url` or `bio`): whether the leading account's own website, or else a link or a domain in its bio, is that domain or a subdomain of it. The account's own website is the strong evidence: it lifts a flat ranking (`uncertain`) or a `same` to at least 0.9. A link or domain in the bio is weaker, because a reseller or a fan names the site too: it lifts only a `same`, to at least 0.75. An email address at the domain is not a domain match, an own website on another domain overrules the bio, and a `possible` or `different` account is never lifted. A profile, link-in-bio or site-builder page given as `website` (LinkedIn, a Google Site, a link page) is not checked. With `profile_check=true`, the leading candidate on Instagram, TikTok, Threads and (for a company) LinkedIn, whose search results carry no bio or website, is looked up on its profile before the check, so the domain check and the check read its bio and website; X search results already carry both. 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). Threads or YouTube, when named, is 1 credit for its search plus 1 for its judging. With profile_check=true each profile lookup is added at its own price (1 credit on Instagram, TikTok and Threads, 5 for a company page on LinkedIn). For a company with `website`, a LinkedIn search that fails is answered by `linkedin/company/by-domain` at its 5 credits instead of the search's 10, and nothing when it fails too. A search that fails, a platform that could not be judged and a lookup that was not made or failed 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, threads, youtube. Default: instagram, tiktok, twitter for a person; linkedin, instagram, tiktok, twitter for a company. Threads and YouTube are searched only when named. 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. With `website`, an account whose own website is that domain is always included. | | `profile_check` | no | Optional, default false. When true, the leading candidate on Instagram, TikTok, Threads and (for a company) LinkedIn is looked up on its profile before the check, so the domain check reads its bio and website: 1 credit a lookup (5 for a LinkedIn company page), refunded when it fails. | ## Code example ```bash curl -G "https://www.socialcrawl.dev/v1/prism/find-accounts" \ --data-urlencode "name=Ogilvy" \ -H "x-api-key: sc_YOUR_API_KEY" ``` ## FAQ ### What does the Prism Find Accounts API return? Returns candidate public accounts for a person's or a company's name on Instagram, TikTok, X, LinkedIn and Threads, ranked per platform, each with a match level and a match confidence. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields. ### When should I use the Prism Find Accounts endpoint? Use it when you have a name, and perhaps a domain, but no handles and want a shortlist to review. It never states who runs an account; your reviewer decides. ### How much does the Prism Find Accounts API cost? The price depends on the request, from 2 to 29 credits per call. Every new account gets 100 free credits. Credits for failed or empty calls are refunded automatically, and there is no subscription. ### What parameters does the Prism Find Accounts API need? The one required parameter is name (the person's or the company's name, 2 to 120 characters). It also accepts 7 optional parameters, all listed on this page. ### How do I call the Prism Find Accounts API? Send a GET request to https://www.socialcrawl.dev/v1/prism/find-accounts?name=Ogilvy with your API key in the x-api-key header. An Authorization: Bearer header works too. 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: - What does the SocialCrawl Prism Find Accounts API return? - How do I get Prism Find Accounts data with the SocialCrawl API?