tiktok/
search-insights

언어와 카테고리별 TikTok Creator Search Insights 데이터를 받습니다. 0~100 인기 점수, 7개 시점의 추이, 동영상 수, 콘텐츠 갭 필터를 지원하는 인기 검색어 목록입니다.

TikTok Creator Search Insights API

인기 점수
콘텐츠 갭 필터
12개 언어
요청당 1 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 사용 방법

언어, 카테고리, 필터를 고른 뒤 검색어를 읽습니다.

  1. {"language": "en", "category": "food", "filter_by": "content_gap"}을 /v1/tiktok/search-insights로 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. 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로 보내 이미 상위에 있는 영상을 먼저 확인한 뒤, 어떻게 차별화할지 정하세요.

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 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

TikTok Creator Search Insights API — 자주 묻는 질문

TikTok Creator Search Insights API는 TikTok Creator Search Insights에 나오는 인기 검색어를 언어, 카테고리, 콘텐츠 갭으로 걸러 조회하는 프로그래밍 인터페이스입니다. 검색어별 인기 점수, 7개 시점의 추이, 동영상 수, 카테고리, labels를 반환합니다.

아니요. popularity는 검색어끼리 순위를 비교하기 위한 0~100의 상대 점수이며, 검색이 몇 번 일어났는지는 알려 주지 않습니다.

사람들이 자주 검색하지만 아직 영상이 상대적으로 적은 검색어입니다. 카테고리 지정 여부와 관계없이 filter_by를 content_gap으로 설정하면 그런 검색어만 목록에 담깁니다.

오래된 순서로 점수 7개가 들어 있는 popularity_trend를 읽으세요. 마지막 값이 처음 값보다 크면 관심이 오르는 중이고, 작으면 식은 것입니다.

아니요. 이 엔드포인트는 지정한 언어, 카테고리, 필터에 맞춰 TikTok이 나열하는 검색어를 반환할 뿐, 검색어를 직접 조회하지는 않습니다. 어떤 검색어로 이미 상위에 있는 영상을 보려면 TikTok Search를 사용하세요.

language는 en, id, de, es, fr, pt, vi, tr, ar, th, ja, ko를 받고 기본값은 en입니다. category는 gaming, fashion, tourism, science, food, sports를 받으며 생략할 수 있습니다.

요청 한 번에 20개가 반환되며 요금은 1 크레딧으로 일정합니다. 더 많은 검색어를 보려면 language, category, filter_by를 바꾸세요. 조합마다 별도의 목록이 나옵니다.

아니요. 요청에는 API 키와 선택 사항인 language, category, filter_by 값만 있으면 되며, TikTok 로그인은 사용하지 않습니다.