TikTok Creator Search Insights
Creator Search Insights는 사람들이 무엇을 검색하는지 보여 주는 TikTok의 목록으로, 검색어마다 0에서 100 사이의 인기 점수, 짧은 추이선, 그 검색어를 위해 이미 만들어진 동영상 수가 붙습니다. 검색은 많이 되는데 영상이 적은 검색어는 콘텐츠 갭으로 표시되어, 크리에이터와 브랜드가 수요가 공급을 앞서는 곳과 관심이 오르는지 식는지를 확인할 수 있습니다.
TikTok Creator Search Insights API 주요 기능
- 0~100 척도의 인기 점수popularity는 TikTok 목록 안의 다른 검색어와 견준 상대 점수라서, 검색어끼리 바로 순위를 비교할 수 있습니다.
- 7개 시점의 추이popularity_trend는 popularity와 같은 0~100 척도로 최근 점수 7개를 오래된 순서대로 돌려줍니다.
- 콘텐츠 갭 필터filter_by를 content_gap으로 하면 관심은 높고 동영상은 적은 검색어만 반환되며, 해당 검색어의 labels에는 content_gap이 들어갑니다.
- 수요와 공급을 한 레코드에videos_count는 TikTok이 그 검색어에 연결하는 동영상 수이고 category는 콘텐츠 영역을 나타내어, 관심도와 경쟁 정도를 한 레코드에서 볼 수 있습니다.
- 12개 언어, 6개 카테고리language는 en, id, de, es, fr, pt, vi, tr, ar, th, ja, ko를 받고, category로 gaming, fashion, tourism, science, food, sports 중 하나로 목록을 좁힐 수 있습니다.
TikTok Creator Search Insights API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
language | 선택 | 반환할 검색어의 언어입니다. 기본값은 en입니다. |
category | 선택 | 검색어를 콘텐츠 카테고리 하나로 제한합니다: gaming, fashion, tourism, science, food, sports. |
filter_by | 선택 | all은 인기 검색어(기본값), content_gap은 아직 동영상이 적은 검색어입니다. |
TikTok Creator Search Insights API 사용 방법
언어, 카테고리, 필터를 고른 뒤 검색어를 읽습니다.
- {"language": "en", "category": "food", "filter_by": "content_gap"}을 /v1/tiktok/search-insights로 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- results.items에서 TikTok이 나열한 순서 그대로 검색어 20개를 읽습니다.
curl -X POST "https://api.socq.ai/v1/tiktok/search-insights" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"language":"en","category":"food","filter_by":"content_gap"}'
# popularity is 0-100; popularity_trend lists recent scores oldest first.TikTok Creator Search Insights API 추천 활용 사례
- 콘텐츠 갭을 기준으로 영상 기획: 내 카테고리의 content_gap 검색어를 가져와 popularity는 높고 videos_count는 낮은 검색어를 골라 영상을 기획합니다.
- 주간 주제 리포트 만들기: 카테고리별로 일정 주기마다 실행해 목록을 저장하면, 주마다 어떤 검색어가 새로 들어오고 오르고 빠지는지 볼 수 있습니다.
- 언어별 오디언스 비교: 같은 카테고리를 두세 개 언어로 요청해, 콘텐츠를 현지화하기 전에 시장마다 어떤 주제가 앞서는지 비교합니다.
- TikTok SEO 키워드 정하기: 목록을 바탕으로 만드는 영상의 캡션, 화면 속 텍스트, 제목에 각 결과의 keyword를 넣어 줍니다.
TikTok Creator Search Insights API 활용 팁
- popularity는 한 응답 안에서만 비교하고, 언어와 카테고리 조합마다 별개의 목록으로 취급하세요.
- 가져올 때마다 collected_at을 함께 저장하세요. 이 엔드포인트는 현재 목록만 반환하므로, 주 단위 변화는 직접 쌓아 둔 스냅샷으로 알 수 있습니다.
- 눈여겨본 키워드는 TikTok Search로 보내 이미 상위에 있는 영상을 먼저 확인한 뒤, 어떻게 차별화할지 정하세요.
관련 API
TikTok Creator Search Insights API 외에 TikTok의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Hashtags API — 지정한 해시태그의 공개 동영상, 크리에이터, 미디어, 사운드, 참여도를 수집합니다.
- TikTok Search API — 키워드로 공개 동영상을 검색하며, 지원되는 정렬 및 게시 기간 필터를 사용할 수 있습니다.
- TikTok Live Room Info API — 방 ID와 소유자 ID 쌍으로 알고 있는 라이브 방송 하나를 조회하며, 상태, 소유자 맥락, 커버 미디어, 시청자 수를 반환합니다.
- TikTok Search Users API — 키워드로 공개 TikTok 계정을 검색합니다.
- TikTok Hashtag Views API — 해시태그를 최대 20개까지 한 번에 지정해 총 동영상 수와 조회수를 조회합니다.
- TikTok Trending Searches API — 오늘 TikTok에서 트렌드 중인 검색어를 순위대로 가져옵니다.
- TikTok Profiles API
- TikTok Comments API
- TikTok Videos API
- 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 Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API