Prism Find Accounts API
Scrape Prism Find Accounts data with one API call. 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.
Last updated September 2026Maintained by the SocialCrawl team
Returns the candidate public accounts for a person's or a company's name on Instagram, TikTok, X and LinkedIn, ranked per platform, each platform with a match level that includes an explicit none.
Use it when you have a name but no handles and want a shortlist to review, instead of searching each platform and comparing profiles by hand. It never states who runs an account; your reviewer decides.
Searching 67 platforms in parallel
What can you do with the Find Accounts API?
The Find Accounts endpoint gives you structured Prism data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/prism/find-accounts?name=Ogilvy&type=company&website=ogilvy.com"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/prism/find-accounts",
params={
'name': 'Ogilvy',
'type': 'company',
'website': 'ogilvy.com',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/prism/find-accounts?name=Ogilvy&type=company&website=ogilvy.com",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();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. |
What does the Prism Find Accounts API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "instagram",
"endpoint": "/v1/instagram/engagement",
"data": {
"engagement_rate_percentages": 38.33,
"recent_posts": 12,
"followers": 87608035,
"comments": 528912,
"likes": 33049046,
"recent_posts_explanation": "Statistics based on the last 12 posts",
"id_user": "2278169415",
"username": "mrbeast",
"is_private": false,
"posts_details": [
{
"likes": 5636982,
"comments": 69484,
"taken_at": 1781457954,
"datetime": "2026-06-14 20:25:54",
"hours_since_post": 461,
"time_ago": "19 days ago",
"likes_per_hour": 12228,
"comments_per_hour": 151
},
{
"likes": 20000768,
"comments": 223510,
"taken_at": 1732824650,
"datetime": "2024-11-28 23:10:50",
"hours_since_post": 13971,
"time_ago": "2 years ago",
"likes_per_hour": 1432,
"comments_per_hour": 16
},
{
"likes": 929226,
"comments": 30633,
"taken_at": 1782232475,
"datetime": "2026-06-23 19:34:35",
"hours_since_post": 246,
"time_ago": "10 days ago",
"likes_per_hour": 3777,
"comments_per_hour": 125
},
{
"likes": 487761,
"comments": 22482,
"taken_at": 1781799425,
"datetime": "2026-06-18 19:17:05",
"hours_since_post": 366,
"time_ago": "15 days ago",
"likes_per_hour": 1333,
"comments_per_hour": 61
},
{
"likes": 712265,
"comments": 15716,
"taken_at": 1781366405,
"datetime": "2026-06-13 19:00:05",
"hours_since_post": 487,
"time_ago": "20 days ago",
"likes_per_hour": 1463,
"comments_per_hour": 32
},
{
"likes": 1475116,
"comments": 35386,
"taken_at": 1781277094,
"datetime": "2026-06-12 18:11:34",
"hours_since_post": 512,
"time_ago": "21 days ago",
"likes_per_hour": 2881,
"comments_per_hour": 69
},
{
"likes": 1108220,
"comments": 26632,
"taken_at": 1780160249,
"datetime": "2026-05-30 19:57:29",
"hours_since_post": 822,
"time_ago": "1 months ago",
"likes_per_hour": 1348,
"comments_per_hour": 32
},
{
"likes": 542948,
"comments": 28476,
"taken_at": 1779375582,
"datetime": "2026-05-21 17:59:42",
"hours_since_post": 1040,
"time_ago": "1 months ago",
"likes_per_hour": 522,
"comments_per_hour": 27
},
{
"likes": 698514,
"comments": 24401,
"taken_at": 1779120014,
"datetime": "2026-05-18 19:00:14",
"hours_since_post": 1111,
"time_ago": "2 months ago",
"likes_per_hour": 629,
"comments_per_hour": 22
},
{
"likes": 468000,
"comments": 13548,
"taken_at": 1778947209,
"datetime": "2026-05-16 19:00:09",
"hours_since_post": 1159,
"time_ago": "2 months ago",
"likes_per_hour": 404,
"comments_per_hour": 12
},
{
"likes": 526594,
"comments": 24411,
"taken_at": 1777737719,
"datetime": "2026-05-02 19:01:59",
"hours_since_post": 1495,
"time_ago": "2 months ago",
"likes_per_hour": 352,
"comments_per_hour": 16
},
{
"likes": 462652,
"comments": 14233,
"taken_at": 1777580305,
"datetime": "2026-04-30 23:18:25",
"hours_since_post": 1538,
"time_ago": "2 months ago",
"likes_per_hour": 301,
"comments_per_hour": 9
}
]
},
"credits_used": 5,
"credits_remaining": 9999,
"request_id": "req-8Kq2ZmR4vT9xLb3P",
"cached": false
}Example captured from the Instagram API. Every SocialCrawl endpoint returns this same unified schema, so your Prism Find Accounts response has the same fields.
How does the Prism Find Accounts API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 67 platforms covering 10B+ monthly active users.
One schema, every platform
Query 67 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.
See your data before you code
Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Ready to scrape Prism Find Accounts data?
Get your API key and start pulling Prism data in under 60 seconds.
