TikTok Search
TikTok 검색 결과는 키워드나 문구와 일치하는 공개 동영상으로, 크리에이터 정보, 캡션, 미디어, 게시 맥락, 공개된 참여도가 함께 담겨 있습니다. 이러한 레코드는 주제 발굴, 트렌드 조사, 경쟁사 모니터링, 콘텐츠 기회 분석에 활용할 수 있습니다.
TikTok Search API 주요 기능
- 키워드 기반 동영상 탐색주제, 브랜드, 상품, 이벤트 키워드를 후보 동영상 세트로 바꿉니다.
- 관련도·최신순 정렬관련도, 날짜, 좋아요 수 정렬을 전환해 주제별, 최신순, 좋아요 많은 순으로 살펴볼 수 있습니다.
- 게시 기간 지정day, week, month, three_months, six_months로 조사 기간을 정합니다.
- 콘텐츠 및 크리에이터 필드동영상, 크리에이터, 참여도, 해시태그, 음악 필드를 일관된 검색 결과 구조로 반환합니다.
- 추적 가능한 검색 스냅샷search_query와 collected_at으로 모든 검색 실험을 기록합니다.
TikTok Search API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
query | 필수 | 공개 TikTok 동영상을 찾기 위한 키워드 검색어로, 비어 있지 않아야 하는 필수 값입니다. |
results_limit | 선택 | 요청할 동영상 결과 수의 상한으로, 양수여야 합니다. 기본값은 100입니다. |
sort_by | 선택 | 결과 정렬 기준으로 relevance, date, likes 중에서 선택합니다. 기본값은 relevance입니다. |
published_within | 선택 | 게시 기간 선택 값으로, day, week, month, three_months, six_months 중에서 선택합니다. |
TikTok Search API 사용 방법
먼저 조사하려는 질문을 정한 뒤, 키워드와 정렬 목적, 게시 기간을 선택합니다.
- 조사 주제를 구체적인 query로 바꾸고, results_limit, sort_by, published_within을 정합니다.
- 요청을 /v1/tiktok/search로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 succeeded 또는 failed 상태가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽습니다. has_more가 true이면 next_cursor로 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/tiktok/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"space exploration","results_limit":100,"sort_by":"relevance","published_within":"month"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueTikTok Search API 추천 활용 사례
- 시장·카테고리 탐색: 상품, 카테고리, 활용 사례와 관련된 용어로 TikTok 콘텐츠 지형과 크리에이터 표본을 파악합니다.
- 이벤트 확산 추적: date 정렬에 day 또는 week 기간을 조합해 출시, 이벤트, 뉴스 시점을 둘러싼 최근 콘텐츠를 따라갑니다.
- 좋아요 많은 크리에이티브 조사: 좋아요 순으로 정렬해 반복되는 후크, 캡션, 음악 선택, 해시태그 조합을 연구합니다.
- 브랜드 언급 모니터링: 브랜드와 상품 검색어를 일정에 맞춰 실행하고 스냅샷을 저장해 콘텐츠·커뮤니케이션 팀에 제공합니다.
TikTok Search API 활용 팁
- 넓은 주제는 브랜드, 니즈, 상황, 트렌드 검색어로 나누어 조회한 뒤 결과 동영상 세트를 병합하세요.
- 주제를 파악하려면 relevance, 새 게시물을 추적하려면 date, 인기 있는 크리에이티브 패턴을 연구하려면 likes를 선택하세요.
- 정기 보고서에 week을 쓰는 것처럼, published_within으로 표본의 시간 척도를 일정하게 유지하세요.
- 검색을 재현할 수 있도록 query, sort_by, published_within, collected_at을 함께 저장하세요.
- 동영상 id를 기준으로 검색어 간 중복을 제거하되, 해당 동영상과 일치한 search_query는 모두 보관하세요.
- 핵심 검색어를 일정에 맞춰 반복 실행해 크리에이터, 주제, 참여도의 변화를 비교하세요.
관련 API
TikTok Search API 외에 TikTok의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 계정 속성, 오디언스 수치를 가져옵니다.
- TikTok Hashtags API — 지정한 해시태그의 공개 동영상, 크리에이터, 미디어, 사운드, 참여도를 수집합니다.
- TikTok Comments API — 공개된 최상위 댓글, 작성자, 참여도, 멘션, 크리에이터 상호작용 플래그를 수집합니다.
- TikTok Videos API — 동영상 URL에서 크리에이터, 캡션, 미디어, 음악, 태그, 멘션, 참여도를 가져옵니다.
- TikTok Live Room Info API — 방 ID와 소유자 ID 쌍으로 알고 있는 라이브 방송 하나를 조회하며, 상태, 소유자 맥락, 커버 미디어, 시청자 수를 반환합니다.
- TikTok Search Users API — 키워드로 공개 TikTok 계정을 검색합니다.
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos 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