tiktok/
search-users

키워드로 공개 TikTok 크리에이터와 계정을 검색해 정규화된 프로필 정보, 팔로워 수, 소개글 정보를 수집합니다.

TikTok Search Users API

크리에이터 검색
정규화된 프로필
인재 발굴
결과당 0.6 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

TikTok Search Users

키워드로 공개 크리에이터 계정을 검색하면 틈새 인플루언서, 브랜드 프로필, 화제 주제의 크리에이터를 폭넓게 발굴할 수 있습니다. 정규화된 계정 레코드에는 프로필 핸들, 표시 이름, 소개글, 수집 시점의 팔로워 수가 담겨 있어 인재 발굴에 활용할 수 있습니다.

TikTok Search Users API 주요 기능

  • 키워드 기반 계정 탐색원하는 검색어를 제출해 공개 TikTok 계정, 크리에이터 핸들, 관련 커뮤니티 프로필을 찾습니다.
  • 정규화된 크리에이터 프로필사용자 이름, 표시 이름, 아바타, 소개글 텍스트, 인증 계정 배지가 담긴 구조화된 레코드를 받습니다.
  • 오디언스 지표공개된 팔로워 수, 팔로잉 수, 게시한 전체 동영상 수를 수집 시점 기준으로 가져옵니다.
  • 결과 수 제한 설정내부에서 커서 페이지네이션이 자동으로 이루어지며, 한 번에 가져올 결과 크기를 최대 2,000명까지 조절할 수 있습니다.

TikTok Search Users API 매개변수

매개변수필수설명
query필수일치하는 공개 TikTok 크리에이터 계정을 찾기 위한 검색 키워드 또는 이름입니다.
results_limit선택반환할 크리에이터 프로필의 최대 개수입니다. 기본값은 100이며 범위는 1~2,000입니다.

TikTok Search Users API 사용 방법

검색어를 비동기 작업으로 제출하고, 작업을 폴링해 정규화된 크리에이터 레코드를 가져옵니다.

  1. 검색 키워드 query를 정하고, 선택 사항으로 최대 2,000까지 results_limit을 지정합니다.
  2. SocQ API 키와 함께 /v1/tiktok/search-users로 POST 요청을 보냅니다.
  3. status가 succeeded가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items에서 정규화된 프로필 항목을 가져옵니다.
curl -X POST "https://api.socq.ai/v1/tiktok/search-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"taylor swift","results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then inspect data.results.items.

TikTok Search Users API 추천 활용 사례

  • 인플루언서·크리에이터 검증: 특정 틈새 분야에서 관련 크리에이터를 찾고 현재의 오디언스 지표를 평가합니다.
  • 브랜드 모니터링과 위조 계정 탐지: 브랜드 이름을 검색해 비공식 계정, 사칭 계정, 팬 커뮤니티를 찾습니다.
  • 인재 데이터베이스 인덱싱: 최신 크리에이터 식별 정보와 팔로워 메타데이터를 CRM이나 분석 플랫폼에 공급합니다.

TikTok Search Users API 활용 팁

  • 구체적인 틈새 키워드나 핸들의 일부를 사용하면 검색 결과를 효과적으로 좁힐 수 있습니다.
  • results_limit 값이 클수록 여러 개의 원본 페이지를 자동으로 페이지네이션하며 가져옵니다.
  • is_verified 불리언 값을 확인해 인증된 유명인 계정과 팬 페이지를 구분하세요.
  • 상위 일치 계정의 최근 콘텐츠 성과를 분석하려면 TikTok User Videos로 이어서 조회하세요.

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

  • TikTok Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 계정 속성, 오디언스 수치를 가져옵니다.
  • TikTok Hashtags API — 지정한 해시태그의 공개 동영상, 크리에이터, 미디어, 사운드, 참여도를 수집합니다.
  • TikTok Search API — 키워드로 공개 동영상을 검색하며, 지원되는 정렬 및 게시 기간 필터를 사용할 수 있습니다.
  • TikTok Followers List API — 공개 팔로워 목록에 표시되는 프로필을 정규화해 수집하며, 출처 맥락과 지원되는 지표를 유지합니다.
  • TikTok User Videos API — 사용자 이름으로 공개 프로필 피드 동영상을 수집하며, 캡션, 크리에이터, 미디어, 타임스탬프, 참여도, 출처 계정 맥락을 포함합니다.
  • TikTok Live Room Info API — 방 ID와 소유자 ID 쌍으로 알고 있는 라이브 방송 하나를 조회하며, 상태, 소유자 맥락, 커버 미디어, 시청자 수를 반환합니다.

다른 플랫폼 둘러보기

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

TikTok Search Users API — 자주 묻는 질문

TikTok Search Users API는 TikTok의 공개 크리에이터 계정과 프로필을 키워드로 탐색할 수 있게 해 줍니다. 사용자 세션 인증 없이 정규화된 사용자 이름, 표시 이름, 팔로워 수, 계정 인증 플래그를 반환합니다.

아니요. 모든 요청은 SocQ API 키로 인증하며, TikTok 공식 개발자 계정이나 사용자 OAuth는 필요하지 않습니다.

TikTok Search 엔드포인트는 검색어와 일치하는 공개 동영상 게시물을 반환하는 반면, TikTok Search Users는 크리에이터 계정과 채널 프로필을 찾는 데 특화되어 있습니다.