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 사용 방법
검색어를 비동기 작업으로 제출하고, 작업을 폴링해 정규화된 크리에이터 레코드를 가져옵니다.
- 검색 키워드 query를 정하고, 선택 사항으로 최대 2,000까지 results_limit을 지정합니다.
- SocQ API 키와 함께 /v1/tiktok/search-users로 POST 요청을 보냅니다.
- status가 succeeded가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 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로 이어서 조회하세요.
관련 API
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 Comments API
- TikTok Videos API
- TikTok Comment Replies API
- TikTok Following List API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API