틱톡 유사 계정 찾기, 핸들 하나로 비슷한 계정 받기
틱톡 유사 계정 찾기는 핸들 하나를 GET /v1/tiktok/similar에 넣으면 끝나요. 비슷한 크리에이터 약 30개를 팔로워 수와 함께 5크레딧에 받아요.
틱톡 유사 계정 찾기는 GET /v1/tiktok/similar?handle=에 크리에이터 핸들 하나를 넣으면 돼요. 비슷한 계정이 약 30개 돌아오고 호출 한 번에 5크레딧이에요. 행마다 팔로워 수, 바이오, 인증 여부가 이미 들어 있어서 따로 조회하지 않고 바로 정렬하고 걸러요.
여기서 말하는 유사 계정은 시드 계정 하나와 비슷한 크리에이터예요. 지인이나 내 다른 계정을 찾는 기능은 아니에요. 틱톡의 추천은 보는 사람마다 다르게 뜨고(틱톡 공식 도움말) 핸들을 넣어 조회하는 기능은 공개돼 있지 않아요. 크리에이터를 발굴하거나 경쟁 계정을 추적하거나 협업 후보 목록을 꾸릴 때 쓰면 돼요.
틱톡 유사 계정 API는 무엇을 돌려주나요?
시드 핸들 하나를 넣으면 비슷한 계정 목록이 와요. 각 행은 통합 작성자 스키마예요. username, display_name, bio, verified, followers, following, posts_count, likes_count, url, private가 들어 있어요.
목록은 시드에 맞춰 달라져요. 요리사를 넣으면 다른 요리사와 음식 크리에이터가 나오고 댄서를 넣으면 다른 댄서가 나와요.
핸들 하나로 비슷한 틱톡 계정은 어떻게 찾나요?
@ 없이 유저네임만 handle에 넣으세요.
curl -s -H "x-api-key: $SOCIALCRAWL_API_KEY" \
"https://www.socialcrawl.dev/v1/tiktok/similar?handle=your_seed_handle"응답을 줄이면 이래요.
{
"success": true,
"platform": "tiktok",
"endpoint": "/v1/tiktok/similar",
"credits_used": 5,
"data": {
"items": [
{ "author": { "username": "example_chef", "verified": true, "followers": 9821569, "bio": "Official account" } },
{ "author": { "username": "example_baker", "verified": false, "followers": 112637, "bio": "Weeknight dinners" } }
],
"total": 30
}
}모든 행에 followers와 verified가 있어서 거르는 코드가 짧아요.
import os
import requests
r = requests.get(
"https://www.socialcrawl.dev/v1/tiktok/similar",
params={"handle": "your_seed_handle"},
headers={"x-api-key": os.environ["SOCIALCRAWL_API_KEY"]},
timeout=60,
)
rows = [item["author"] for item in r.json()["data"]["items"]]
mid_tier = [a for a in rows if 10_000 <= a["followers"] <= 500_000]
mid_tier.sort(key=lambda a: a["followers"], reverse=True)범위를 넓히려면 돌아온 유저네임 하나를 다음 handle로 넣어 다시 부르세요. 한 단계마다 5크레딧이 들어요.
유사 계정은 어디서 가져오나요?
기본은 틱톡이 그 시드에 직접 추천하는 관련 계정이에요. 틱톡에 그 크리에이터의 추천 목록이 없으면 다른 두 경로에서 채워요. 행마다 어느 경로에서 왔는지 표시돼요.
| 출처 | 행에 붙는 표시 |
|---|---|
| 틱톡이 직접 추천한 계정 | author.ext.similar_source 없음 |
| 시드가 들어 있는 틱톡 목록에서 모은 계정. 그 목록에 많이 등장하는 순서로 정렬 | author.ext.similar_source: "tiktok_graph"와 author.ext.similar_via(시드를 목록에 올린 계정) |
| 인스타그램이 같은 크리에이터에 추천하는 계정을 틱톡 계정에 맞춘 것 | author.ext.similar_source: "instagram"와 author.ext.instagram_username |
인스타그램에서 온 후보는 틱톡 계정이 인증됐거나 팔로워가 1만 명 이상이어야 남아요. 팔로워가 1,000명 이상이면 표시 이름이 인스타그램 계정과 단어 하나를 공유할 때도 남아요. 시드의 인스타그램 계정은 틱톡 바이오에 걸린 링크나 적힌 이름으로 찾아요.
틱톡 목록 경로는 이 엔드포인트가 그동안 돌려준 목록에서 찾아요. 그래서 엔드포인트가 쓰일수록 찾을 수 있는 크리에이터도 늘어요. 출처가 중요하면 similar_source를 확인하세요. 이 필드가 없는 행이 틱톡의 직접 추천이에요.
틱톡 유사 계정 엔드포인트는 크레딧이 얼마나 드나요?
목록 길이와 관계없이 한 번에 5크레딧이에요. 아래 세 경우는 크레딧이 나가지 않아요.
- 틱톡이 모르는 핸들은 404를 돌려주고 과금하지 않아요.
- 어느 경로에서도 추천이 없는 크리에이터는 빈 목록이 오고 환불돼요. 이 빈 결과는 15분 동안 기억해 두니 그 안에 다시 물으면 바로 답이 오고 크레딧도 들지 않아요.
- 같은 요청을 캐시 기간인 15분 안에 다시 보내면 0크레딧이에요.
캐시 덕분에 같은 시드로 팔로워 하한이나 정렬 기준을 바꿔 가며 코드를 다듬어도 크레딧이 더 들지 않아요.
이 엔드포인트가 하지 않는 일은 무엇인가요?
항상 30개가 오지는 않아요. 몇 개만 오는 크리에이터도, 하나도 없는 크리에이터도 있으니 짧은 목록도 처리하게 만들어 두세요. 목록은 고정된 한 묶음이라 cursor도 없어요.
국가 정보도 주지 않아요. 이 엔드포인트의 모든 행에서 author.location은 null이에요. 계정 하나의 지역은 GET /v1/tiktok/profile(1크레딧)로 확인하세요. 한 시장의 크리에이터만 모으려면 틱톡 유저 검색, country로 한국 크리에이터만 찾기를 보세요.
입력은 시드 핸들 하나뿐이라 키워드나 니치는 받지 않아요. 키워드에서 출발하려면 틱톡 영상 검색 API나 유저 검색을 쓰세요.
어떻게 시작하나요?
- 가입해요. 새 계정에는 무료 크레딧 100개가 들어오고 카드는 필요 없어요(요금). API 키 하나로 모든 엔드포인트를 불러요.
- 잘 아는 시드로
GET /v1/tiktok/similar를 불러서 목록이 그 니치와 맞는지 확인해요. followers,verified,bio로 거르고 남긴 유저네임을GET /v1/tiktok/profile에 넣으면 지역과 전체 프로필까지 받아요.- 필드 전체는 틱톡 유사 계정 레퍼런스에 있어요. 코드 한 줄 쓰기 전에 응답부터 보려면 익스플로러를 열어 보세요.
자주 묻는 질문
틱톡 유사 계정은 한 번 호출로 몇 개나 나오나요?
보통 약 30개지만 정해진 개수는 아니에요. 몇 개만 오는 크리에이터도 있고 하나도 없는 크리에이터도 있어요. 목록은 고정된 한 묶음이고 cursor가 없어요.
틱톡에 추천 목록이 없는 크리에이터는 어떻게 되나요?
먼저 이 엔드포인트가 이미 돌려준 틱톡 목록 가운데 그 크리에이터가 들어 있는 목록으로 후보를 만들어요. 남는 자리는 인스타그램이 같은 크리에이터에 추천하는 계정을 틱톡 계정에 맞춰 채워요. 이 행들에는 author.ext.similar_source가 tiktok_graph 또는 instagram으로 붙어요. 틱톡이 직접 추천한 행에는 둘 다 없어요.
틱톡 유사 계정 엔드포인트는 크레딧이 얼마나 드나요?
한 번에 5크레딧이에요. 모르는 핸들은 404로 끝나 무료이고 빈 목록은 환불돼요. 같은 요청을 15분 안에 다시 보내면 0크레딧이에요.
유사 계정 목록에 팔로워 수도 들어 있나요?
네. 모든 행에 followers, following, posts_count, likes_count, verified가 있고 username, bio, url, private도 함께 와요. author.location은 모든 행에서 null이라 계정 하나의 지역은 GET /v1/tiktok/profile로 확인해야 해요.
특정 국가의 유사 계정만 찾을 수 있나요?
바로는 안 돼요. 이 엔드포인트는 시드 핸들만 받고 지역은 돌려주지 않아요. 목록을 받은 뒤 추린 유저네임을 GET /v1/tiktok/profile로 확인하세요. 아니면 국가 필터 유저 검색에서 나온 크리에이터 하나를 시드로 쓰세요.
함께 읽으면 좋은 글
페이스북 댓글 크롤링, 게시물 25개를 한 번에 읽어요
페이스북, 인스타그램, 틱톡, 유튜브 게시물 25개의 댓글을 API 호출 한 번으로 읽어요. since를 넣으면 새 댓글만 읽고 새 댓글이 없으면 크레딧도 들지 않아요.
인플루언서 검색 API: 팔로워가 아니라 조회수로 크리에이터 고르기
인플루언서 검색 API 한 번으로 주제와 국가, 규모에 맞는 크리에이터를 찾아요. 최근 게시물에서 잰 중간 조회수로 순위를 매기고 드라이런으로 비용도 미리 확인해요.
틱톡과 유튜브 이메일 찾기 API, include=contacts 한 줄로
프로필 호출에 include=contacts를 붙이면 크리에이터가 공개한 비즈니스 이메일과 출처가 와요. 결과 상태 다섯 가지와 재시도, 크레딧 규칙까지 담았어요.
