Universal Search Creators API
API 한 번의 호출로 Universal Search Creators 데이터를 받아 가세요. Fans a niche query across TikTok user search, Threads user search, and Instagram profile search by default, then merges matching creators into one deterministically ranked list. Ranking is a published formula of query relevance, follower scale, and verification. No LLM rerank by default. Pass `sources=youtube`, `twitter`, or `facebook` (or a CSV of any of the six) to add those profile searches; omitting `sources` keeps the original three-platform walk so existing callers do not change. Pass `brief=` (what you are looking for, in your own words) to have the first 40 creators judged from their name, handle and bio: each gets `brief_match` ({ fits_brief, account_kind, account_kind_confidence, brief_score }) and the list is re-ranked so creators who post about your brief lead, with brands, shops, academies and repost pages below them; `data.brief` reports what was judged and the ranking version. `relevance=filter` also drops creators that do not fit and lists them in `data.brief.dropped_ids`. Flat 10 credits with a coverage-based partial refund.
2026년 10월 업데이트SocialCrawl 팀이 직접 관리해요
TikTok, Threads, Instagram에서 주제에 맞는 크리에이터를 핸들 기준으로 합치고 팔로워·인증 점수로 순위를 매긴 목록 하나로 반환합니다. 계정마다 개인, 브랜드, 매체 구분도 표시합니다.
게시물이 아니라 크리에이터 계정을 찾을 때 사용하세요. 게시물 전반은 search/everywhere가 맞습니다.
68개 플랫폼을 병렬로 검색합니다
TikTok·
Instagram·
YouTube·
Facebook·
X·
LinkedIn·
Reddit·
Threads·
Pinterest·
Twitch·
Truth Social·
Snapchat·
Kick·
Bluesky·
Kwai·
Rumble·
Spotify·
Apple Music·TikTok Shop·
Amazon Shop·
Google Shopping·
Trustpilot·
TripAdvisor·
Yelp·
Linktree·
Komi·
Pillar·
lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·
Finance·
Polymarket·
Tavily·
Hacker News·
GitHub·
Perplexity·
Naver·
Utility·Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchCreators API로 무엇을 할 수 있을까요
Creators 엔드포인트가 통합 스키마와 계산 필드를 담은 Universal Search 데이터를 한 번의 요청으로 보내드려요. 스크래핑 인프라를 직접 만들거나 유지할 필요가 없어요.
요청 예시
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/search/creators?query=skincare+routine&sources=tiktok%2Cinstagram&min_followers=50000&verified_only=false&sort=relevance"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/search/creators",
params={
'query': 'skincare routine',
'sources': 'tiktok,instagram',
'min_followers': '50000',
'verified_only': 'false',
'sort': 'relevance',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/search/creators?query=skincare+routine&sources=tiktok%2Cinstagram&min_followers=50000&verified_only=false&sort=relevance",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
| query | 예 | Niche or topic (2-256 chars), forwarded to every profile search. |
| sources | 아니오 | Optional CSV allowlist of creator sources (tiktok, threads, instagram, youtube, twitter, facebook). Mutually exclusive with exclude. Omit to keep the default TikTok + Threads + Instagram walk. |
| exclude | 아니오 | Optional CSV blocklist of creator sources. Mutually exclusive with sources. |
| min_followers | 아니오 | Drop fused creators whose follower count is below this integer floor. |
| verified_only | 아니오 | When true, keep only verified creators after fusion. |
| sort | 아니오 | Which axis dominates rank: relevance (default), followers, or verification. (relevance | followers | verification) |
| brief | 아니오 | Optional. What you want to find, in your own words (3-300 chars), for example brief=Korean creators who review skincare products. The first 40 creators are judged from their name, handle and bio: does the account post about your brief (fits_brief, 0 to 1), and what kind of account is it (individual_creator, brand_or_business, media_or_publisher, fan_or_repost_page, cannot_tell; null when unsure). With sort=relevance (the default) they are re-ranked so creators who fit and are individual people lead; other sorts keep their order and only gain the labels. These are signals to review, not a finding. Adds 2 credits. |
| relevance | 아니오 | Optional, only with brief. score (default) ranks and labels; filter also drops judged creators that do not fit the brief and lists them in data.brief.dropped_ids. A creator that could not be judged is never dropped. (score | filter) |
| judgments | 아니오 | Optional. on (default) or off. On, the first 40 creators also carry account ({ account_kind: individual_creator, brand_or_business, media_or_publisher, fan_or_repost_page, cannot_tell or null when unsure, account_kind_confidence, named_person }), judged from their name, handle and bio, and data.account_kinds reports how many were judged. The order is unchanged and it is free. off returns the response without it. (on | off) |
Universal Search Creators API는 무엇을 돌려주나요
모든 응답은 하나의 통합 스키마를 따라요. 크레딧을 쓰기 전에 어떤 필드가 돌아오는지, 실제 응답 본문 그대로 확인해 보세요.
응답 예시 보기
{
"success": true,
"platform": "search",
"endpoint": "/v1/search/creators",
"data": {
"creators": [
{
"author": {
"id": "user_058794",
"username": "user_1cb194",
"display_name": "user_a15759",
"bio": null,
"followers": 6045690,
"verified": false,
"avatar_url": "https://example.com/avatars/user_805cd1.png",
"url": "https://example.com/user_d7235c"
},
"sources": [
"tiktok"
],
"relevance": 0.45,
"follower_rank": 1,
"verified": false,
"rrf_score": 0.017897727272727273,
"account": {
"account_kind": "individual_creator",
"account_kind_confidence": 1,
"named_person": 0.87
}
}
],
"creators_by_source": {
"tiktok": [
{
"id": "user_b598dc",
"username": "user_4d9b4a",
"display_name": "user_67c672",
"bio": null,
"followers": 36,
"verified": false,
"avatar_url": "https://example.com/avatars/user_ea00c5.png",
"url": "https://example.com/user_c06400"
},
{
"id": "user_a8ec20",
"username": "user_7b906f",
"display_name": "user_3af5a8",
"bio": null,
"followers": 5085,
"verified": false,
"avatar_url": "https://example.com/avatars/user_676794.png",
"url": "https://example.com/user_e80546"
}
],
"threads": [],
"instagram": [
{
"id": "user_d64a0b",
"username": "user_c1e003",
"display_name": "user_2c8d0f",
"bio": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"followers": 22456,
"verified": false,
"avatar_url": "https://example.com/avatars/user_99e358.png",
"url": "https://example.com/user_60d233"
},
{
"id": "user_9a0493",
"username": "user_d61117",
"display_name": "user_c043e7",
"bio": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"followers": 28396,
"verified": false,
"avatar_url": "https://example.com/avatars/user_88de7a.png",
"url": "https://example.com/user_995add"
}
],
"youtube": [],
"twitter": [],
"facebook": []
},
"computed": {
"platform_spread": {
"tiktok": 30,
"instagram": 44
},
"verified_share": 0,
"follower_distribution": {
"p50": 6045690,
"p90": 6045690
}
},
"legs": [
{
"endpoint": "/v1/tiktok/search/users",
"status": 200,
"credits_used": 1,
"latency_ms": 1941,
"error": null
},
{
"endpoint": "/v1/instagram/search/profiles",
"status": 200,
"credits_used": 1,
"latency_ms": 7963,
"error": null
}
],
"sources_called": [
"tiktok",
"instagram"
],
"sources_succeeded": [
"tiktok",
"instagram"
],
"coverage": 1,
"partial_failure": false,
"methodology_version": "search-creators/1.0",
"account_kinds": {
"methodology_version": "creators-account-kind/1",
"status": "complete",
"judged": 1,
"unjudged": 0
}
},
"credits_used": 10,
"request_id": "req_example000000",
"cached": false,
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-02T12:48:35.176Z",
"redacted": true
}통합 응답 구조를 보여 주는 실제 샘플이에요. 필드 값은 조회한 대상에 따라 달라져요.
Universal Search Creators API는 어떻게 동작하나요
API 키와 함께 GET 요청을 보내면, 통합 스키마와 계산 필드를 담은 깔끔한 JSON이 돌아와요.
메서드
GET
응답 형식
JSON
소셜 미디어 데이터를 몇 초 만에 수집하는 방법
개발자를 위한 가장 빠른 소셜 미디어 스크래핑 API. 월간 활성 사용자 100억 명 이상을 포괄하는 68개 플랫폼에서 프로필, 게시물, 댓글, 분석 데이터를 수집하세요.
모든 플랫폼을 하나의 스키마로
동일한 응답 구조로 68개 플랫폼을 조회하세요. 연동은 한 번이면 충분합니다.
단순 수집을 넘어 계산된 필드 제공
엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때, 정규화된 레코드에 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"
}
}
}Universal Search Creators 데이터, 가져올 준비 되셨어요?
API 키 받고 60초 안에 Universal Search 데이터를 받아 가세요.