tiktok/
trending-keywords

키워드 입력 없이 호출 한 번으로 TikTok의 오늘 인기 검색어 약 100개를 TikTok 순위 그대로 받고, 검색어마다 검색 결과 링크를 함께 반환합니다.

TikTok Trending Searches API

입력값 없음
검색어 약 100개
매일 갱신
요청당 0.5 크레딧
준비됨
README

SocQ 작성 · 업데이트

TikTok Trending Searches

TikTok 인기 검색어는 지금 가장 화제라고 플랫폼이 내세우는 문구들로, 연예계 이슈와 밈부터 챌린지, 시즌 주제까지 폭넓게 담깁니다. 목록은 매일 바뀌기 때문에 날마다 읽어 보면 사람들이 지금 무엇을 찾는지 알 수 있고, 콘텐츠 기획, 이슈 대응 게시물, 키워드 조사에 바로 활용할 수 있습니다.

TikTok Trending Searches API 주요 기능

  • 입력 없이 오늘의 목록요청에 키워드나 필터가 없으며, 인기 검색어 약 100개가 TikTok이 정한 순서 그대로 돌아옵니다.
  • 검색어, 순위, 검색 링크keyword는 검색어, rank는 목록에서의 위치이고, url을 열면 그 검색어의 TikTok 검색 결과로 이동합니다.

TikTok Trending Searches API 매개변수

바로 실행 가능

이 엔드포인트는 요청 매개변수가 필요하지 않습니다. 빈 JSON 객체를 그대로 전송하세요.

{}

TikTok Trending Searches API 사용 방법

빈 요청을 보내고 순위가 매겨진 목록을 읽습니다.

  1. {}를 /v1/tiktok/trending-keywords로 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. results.items에서 순위가 매겨진 검색어를 읽고, has_more가 true인 동안 results.next_cursor를 다시 보내 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/tiktok/trending-keywords" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

# Each item has keyword, rank and a TikTok search url.

TikTok Trending Searches API 추천 활용 사례

  • 매일 아침 콘텐츠 브리프: 아침마다 목록을 가져와 우리 분야와 맞는 검색어를 고르고, url을 열어 이미 어떤 영상이 상위에 있는지 확인한 뒤 당일 게시물이나 이슈 대응 콘텐츠를 기획합니다.
  • 트렌드 수명 기록: 하루하루의 목록을 저장해 두면, 검색어가 며칠 동안 목록에 머물렀는지와 떨어지기 전까지 순위가 얼마나 올랐는지를 그래프로 볼 수 있습니다.

TikTok Trending Searches API 활용 팁

  • 하루에 한 번, 정해진 시각에 요청하세요. TikTok이 목록을 하루 단위로 갱신하므로 같은 날 두 번째로 가져와도 얻는 것이 적습니다.
  • 가져올 때마다 collected_at과 함께 저장하고 행은 id를 키로 삼으세요. id는 소문자로 바꾼 검색어라서, 대소문자가 달라져 다시 올라온 검색어도 이전 날짜와 연결됩니다.
  • 요청에는 필터가 없으므로, 결과를 받은 뒤 keyword를 우리 브랜드·주제 용어와 대조해 직접 추리세요.

TikTok Trending Searches 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 Creator Search Insights API — 인기 검색어를 인기 점수, 짧은 추이선, 콘텐츠 공백 라벨과 함께 가져옵니다.

다른 플랫폼 둘러보기

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

TikTok Trending Searches API — 자주 묻는 질문

TikTok Trending Searches API는 입력값 없이 TikTok이 오늘의 인기 검색어로 올린 검색어를 수집하는 프로그래밍 인터페이스입니다. 검색어마다 순위와 TikTok 검색 결과 링크를 반환합니다.

약 100개이며 TikTok이 정한 순위 순서입니다. 한 페이지에 다 담기지 않으면 next_cursor를 계속 따라가세요. 전체 목록이 요청 한 번이며 0.5 크레딧이 청구됩니다.

TikTok이 하루에 한 번 갱신하므로, 하루 한 번 요청하면 새 목록을 빠짐없이 받을 수 있습니다.

아니요. 목록에는 순위와 검색 링크만 있으며, 순위는 위치일 뿐 검색 횟수가 아닙니다. 검색어별 인기 점수와 7개 시점의 추이가 필요하면 TikTok Creator Search Insights를 사용하세요.

아니요. 요청에 입력값이 없으므로, 국가나 카테고리로 좁히는 작업은 반환된 검색어에서 직접 하셔야 합니다.