Prism Find Accounts API
API 한 번의 호출로 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.
2026년 9월 업데이트SocialCrawl 팀이 직접 관리해요
사람이나 회사 이름으로 Instagram, TikTok, X, LinkedIn의 공개 계정 후보를 찾아 플랫폼별 순위로 반환합니다. 플랫폼마다 일치 수준이 붙고, 해당하는 계정이 없으면 none으로 표시됩니다.
핸들은 모르고 이름만 알 때 검토할 후보 목록을 받으려면 사용하세요. 플랫폼마다 검색해 프로필을 직접 비교하지 않아도 됩니다. 계정의 실제 운영자를 확정하지는 않으며 최종 판단은 검토 담당자가 합니다.
67개 플랫폼을 병렬로 검색합니다
Find Accounts API로 무엇을 할 수 있을까요
Find Accounts 엔드포인트가 통합 스키마와 계산 필드를 담은 Prism 데이터를 한 번의 요청으로 보내드려요. 스크래핑 인프라를 직접 만들거나 유지할 필요가 없어요.
요청 예시
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();파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
| name | 예 | The person's or the company's name, 2 to 120 characters. |
| type | 아니오 | `person` (default) or `company`. Sets the default platforms and the LinkedIn search used. (person | company) |
| platforms | 아니오 | 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 | 아니오 | Optional current employer of the person, used only as context for the judgment (type=person only). |
| location | 아니오 | Optional city or country, used only as context for the judgment. |
| website | 아니오 | Optional official website or domain (e.g. ogilvy.com). A platform-verified account linking to it is taken as the match without judging. |
| candidates | 아니오 | Accounts judged per platform, 1 to 5 (default 5), taken from the top of each search. |
Prism Find Accounts API는 무엇을 돌려주나요
모든 응답은 하나의 통합 스키마를 따라요. 크레딧을 쓰기 전에 어떤 필드가 돌아오는지, 실제 응답 본문 그대로 확인해 보세요.
응답 예시 보기
{
"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
}Instagram API에서 가져온 예시예요. 모든 SocialCrawl 엔드포인트가 똑같은 통합 스키마를 돌려주기 때문에, Prism Find Accounts 응답도 같은 필드로 구성돼요.
Prism Find Accounts API는 어떻게 동작하나요
API 키와 함께 GET 요청을 보내면, 통합 스키마와 계산 필드를 담은 깔끔한 JSON이 돌아와요.
메서드
GET
응답 형식
JSON
소셜 미디어 데이터를 몇 초 만에 수집하는 방법
개발자를 위한 가장 빠른 소셜 미디어 스크래핑 API. 월간 활성 사용자 100억 명 이상을 포괄하는 67개 플랫폼에서 프로필, 게시물, 댓글, 분석 데이터를 수집하세요.
모든 플랫폼을 하나의 스키마로
동일한 응답 구조로 67개 플랫폼을 조회하세요. 연동은 한 번이면 충분합니다.
단순 수집을 넘어 계산된 필드 제공
엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때, 정규화된 레코드에 engagement_rate, estimated_reach, content_category, language를 함께 담아 바로 활용할 수 있습니다.
코드 한 줄 쓰기 전에, 데이터부터
Visual Data Explorer에 URL만 붙여넣으면 결과 카드와 정형화된 테이블, CSV 내보내기를 바로 사용할 수 있습니다.
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"
}
}
}Prism Find Accounts 데이터, 가져올 준비 되셨어요?
API 키 받고 60초 안에 Prism 데이터를 받아 가세요.
