100 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
Back to blog

틱톡 유사 계정 찾기, 핸들 하나로 비슷한 계정 받기

··13 min read

틱톡 유사 계정 찾기는 핸들 하나를 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에 넣으세요.

bash
curl -s -H "x-api-key: $SOCIALCRAWL_API_KEY" \
  "https://www.socialcrawl.dev/v1/tiktok/similar?handle=your_seed_handle"

응답을 줄이면 이래요.

json
{
  "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가 있어서 거르는 코드가 짧아요.

python
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나 유저 검색을 쓰세요.

어떻게 시작하나요?

  1. 가입해요. 새 계정에는 무료 크레딧 100개가 들어오고 카드는 필요 없어요(요금). API 키 하나로 모든 엔드포인트를 불러요.
  2. 잘 아는 시드로 GET /v1/tiktok/similar를 불러서 목록이 그 니치와 맞는지 확인해요.
  3. followers, verified, bio로 거르고 남긴 유저네임을 GET /v1/tiktok/profile에 넣으면 지역과 전체 프로필까지 받아요.
  4. 필드 전체는 틱톡 유사 계정 레퍼런스에 있어요. 코드 한 줄 쓰기 전에 응답부터 보려면 익스플로러를 열어 보세요.

자주 묻는 질문

틱톡 유사 계정은 한 번 호출로 몇 개나 나오나요?

보통 약 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로 확인하세요. 아니면 국가 필터 유저 검색에서 나온 크리에이터 하나를 시드로 쓰세요.

Topics
#틱톡-유사-계정-찾기#틱톡-인플루언서-찾기#틱톡-계정-검색#틱톡-유사-크리에이터#틱톡-비슷한-계정#틱톡-크리에이터-찾기

함께 읽으면 좋은 글

🤖 AI agent or LLM? Read this page as markdown