tiktok/
similar-users

공개 TikTok 크리에이터의 사용자 이름으로 TikTok이 직접 추천하는 비슷한 계정을 찾고, 핸들, 소개, 팔로워 수, 동영상 수, 인증 여부를 반환합니다.

TikTok Similar Accounts API

사용자 이름 입력
TikTok 추천 계정
최대 300개 계정
결과당 0.5 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

TikTok Similar Accounts

비슷한 계정이란 TikTok이 한 크리에이터와 나란히 추천하는 프로필로, 핸들, 표시 이름, 소개, 인증 여부, 팔로워·팔로잉·동영상 수가 함께 담깁니다. 키워드 매칭이 아니라 TikTok이 직접 묶은 목록이어서, 인플루언서를 발굴하거나 경쟁 구도를 그릴 때 닮은 크리에이터를 빠르게 찾는 지름길이 됩니다.

TikTok Similar Accounts API 주요 기능

  • TikTok이 추천하는 순서 그대로사용자 이름 하나를 보내면 TikTok이 그 크리에이터 옆에 노출하는 계정들이 TikTok의 추천 순서대로 돌아옵니다.
  • 행마다 규모와 신뢰도 정보계정마다 followers_count, following_count, posts_count, is_verified가 함께 와서, 프로필을 하나도 열어 보기 전에 규모와 인증 여부로 먼저 추릴 수 있습니다.
  • 기준 계정 하나당 최대 300개results_limit으로 1~300개를 요청할 수 있으며 기본값은 30입니다. 많은 결과는 next_cursor로 페이지를 넘기며 읽습니다.

TikTok Similar Accounts API 매개변수

매개변수필수설명
username필수비슷한 계정을 찾을 기준 TikTok 사용자 이름이며, 맨 앞의 @는 있어도 없어도 됩니다.
results_limit선택반환할 비슷한 계정의 개수로, 1~300 사이 값입니다. 기본값은 30입니다.

TikTok Similar Accounts API 사용 방법

크리에이터 한 명에서 출발해 TikTok이 추천하는 계정을 페이지 단위로 읽어 갑니다.

  1. {"username": "khaby.lame", "results_limit": 30}을 /v1/tiktok/similar-users로 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. results.items에서 계정을 읽고, has_more가 true인 동안 results.next_cursor를 다시 보내 다음 페이지를 가져옵니다.
curl -X POST "https://api.socq.ai/v1/tiktok/similar-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"khaby.lame","results_limit":30}'

# Each item is one recommended account with username, name and metrics.followers_count.

TikTok Similar Accounts API 추천 활용 사례

  • 성과가 좋았던 크리에이터 주변으로 후보 넓히기: 캠페인이 잘 풀린 크리에이터를 기준 계정으로 넣고, 추천 계정 중 followers_count가 예산 구간에 맞는 곳만 남깁니다.
  • 경쟁사 파트너 옆에 누가 있는지 보기: 경쟁 브랜드가 이미 협업하는 크리에이터를 기준 계정으로 삼아, TikTok이 이웃으로 보여 주는 계정과 그 규모를 함께 살펴봅니다.
  • 겹치는 계정으로 니치 지도 그리기: 카테고리를 대표하는 계정 여러 곳을 기준으로 조회해 목록을 합치면, 여러 기준 계정에서 반복해 나오는 계정이 그 니치의 중심입니다.

TikTok Similar Accounts API 활용 팁

  • 여러 기준 계정의 목록을 합칠 때는 username이 아니라 id로 병합하세요. 연관된 기준 계정에서 같은 계정이 반복해서 나오고, 핸들은 바뀔 수 있습니다.
  • 반환된 username을 새 기준 계정으로 다시 넣으면 한 단계 더 멀리 확장됩니다. 새 결과가 이미 가진 계정 위주로 반복되면 멈추세요.
  • 먼저 기본값 30으로 시작하고, 돌아온 계정 대부분이 아직 처음 보는 계정일 때만 results_limit을 올리세요. 반환된 계정마다 비용이 청구되기 때문입니다.

TikTok Similar Accounts API 외에 TikTok의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • TikTok Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 계정 속성, 오디언스 수치를 가져옵니다.
  • TikTok Followers List API — 공개 팔로워 목록에 표시되는 프로필을 정규화해 수집하며, 출처 맥락과 지원되는 지표를 유지합니다.
  • TikTok Following List API — TikTok 계정이 팔로우하는 공개 프로필을 수집하며, 정규화된 계정 정보, 소개글, 공개된 지표, 출처 계정 맥락을 포함합니다.
  • TikTok User Videos API — 사용자 이름으로 공개 프로필 피드 동영상을 수집하며, 캡션, 크리에이터, 미디어, 타임스탬프, 참여도, 출처 계정 맥락을 포함합니다.
  • TikTok Audience Demographics API — 사용자 이름으로 크리에이터의 팔로워가 어느 국가에 있는지 확인하며, 국가별 오디언스 비중을 포함합니다.
  • TikTok Live Ranking API — 일간 LIVE 크리에이터 순위를 순위, 선물 기반 점수, 팔로워 수와 함께 가져옵니다.

다른 플랫폼 둘러보기

TikTok 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

TikTok Similar Accounts API — 자주 묻는 질문

TikTok Similar Accounts API는 공개 사용자 이름을 기준으로 TikTok이 비슷하다고 추천하는 계정을 조회하는 프로그래밍 인터페이스입니다. 계정별 핸들, 표시 이름, 소개, 아바타, 인증 여부, 팔로워·팔로잉·동영상 수를 반환합니다.

그 크리에이터의 사용자 이름을 보내면 TikTok이 해당 프로필에 추천하는 계정이 돌아옵니다. followers_count와 is_verified로 거르면 기획 의도에 맞는 계정만 남길 수 있습니다.

TikTok은 기준을 공개하지 않으며, 응답에도 유사도 점수는 없습니다. 계정은 TikTok이 주는 순서대로 오기 때문에, 목록에서의 위치가 얼마나 가까운지를 알려 주는 유일한 단서입니다.

아니요, 입력값은 username과 results_limit뿐입니다. 반환된 행은 followers_count로 직접 거르고, 후보로 추린 크리에이터의 국가는 TikTok Audience Demographics로 확인하세요.

최대 300개이고 기본값은 30개입니다. 실제로 반환된 계정 1개당 0.5 크레딧이 차감되므로, 목록이 짧게 끝나면 설정한 한도보다 적게 듭니다.

아니요, 이메일 필드는 없습니다. 소개글이 텍스트로 제공되고, 프로필에 웹사이트가 있으면 그 주소도 함께 옵니다.