tiktok-creative-center/
trending-hashtags

TikTok Creative Center에서 국가별로 뜨는 해시태그 순위를 받습니다. 게시물 수, 조회수, 7일·30일·90일 기간의 일별 인기도 곡선을 함께 제공합니다.

TikTok Creative Center Trending Hashtags API

국가별 순위
7일·30일·90일
일별 인기도 곡선
결과당 0.5 크레딧
준비됨
README

SocQ 작성 · 업데이트

TikTok Creative Center Trending Hashtags

Creative Center의 트렌딩 해시태그는 한 국가에서 최근 7일, 30일, 90일 동안 가장 큰 관심을 얻은 태그의 순위로, 태그마다 순위, 게시물 수, 조회수, 하루 단위 인기도 곡선이 붙습니다. 이 순위를 보면 시장에서 어떤 주제가 뜨는지, 태그마다 얼마나 가파르게 올랐는지, 아직 오르는 중에 올라탈 만한 트렌드가 무엇인지 알 수 있습니다.

TikTok Creative Center Trending Hashtags API 주요 기능

  • 국가마다 따로 매겨진 순위country에 US, GB, JP 같은 두 글자 코드를 넣으면, 시장마다 각자의 순위 순서가 돌아옵니다.
  • 7일·30일·90일 목록time_range가 순위를 산정하는 기간을 정하며, 기간마다 별도의 목록입니다.
  • 게시물 수와 조회수metrics.posts_count와 metrics.views_count는 Creative Center가 태그별로 보고하는 규모입니다.
  • 일별 인기도 곡선popularity_curve가 날짜별로 0~100 척도의 값을 하나씩 돌려주므로, 태그의 흐름이 순위 행과 함께 옵니다.
  • 태그 이름, 링크, ID행마다 #를 뺀 name, tiktok.com/tag url, Hashtag Insights가 hashtag_id로 받는 id가 들어 있습니다.

TikTok Creative Center Trending Hashtags API 매개변수

매개변수필수설명
country선택시장의 두 글자 국가 코드이며, US, GB, JP 등이 있습니다. 기본값은 US입니다.
time_range선택순위가 다루는 기간으로, 7d(기본값), 30d, 90d 중 하나입니다.
results_limit선택반환할 해시태그의 개수로, 1~100 사이 값입니다. 기본값은 20입니다.

TikTok Creative Center Trending Hashtags API 사용 방법

국가와 기간을 고르고 순위를 읽습니다.

  1. {"country": "US", "time_range": "7d", "results_limit": 20}을 /v1/tiktok-creative-center/trending-hashtags로 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-creative-center/trending-hashtags" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"US","time_range":"7d","results_limit":20}'

# Each item has rank, metrics and a dated popularity_curve.

TikTok Creative Center Trending Hashtags API 추천 활용 사례

  • 매일 신규 진입 태그 추적: 날마다 목록을 collected_at과 함께 저장하고 이전 스냅샷과 id를 비교하면, 어떤 해시태그가 국가 순위에 새로 들어오거나 빠졌는지 알 수 있습니다.
  • 시장별 해시태그 후보 목록: 목표 국가마다 같은 time_range로 요청해 목록을 나란히 놓고, 현지화 캠페인에 쓸 태그를 고릅니다.
  • 반짝 유행인지 오래 가는지 가리기: 한 국가의 7d 목록과 90d 목록을 비교합니다. 짧은 기간 목록에만 있는 태그는 일주일짜리 반짝 유행이고, 두 목록 모두 상위인 태그는 몇 달째 관심을 유지한 것입니다.

TikTok Creative Center Trending Hashtags API 활용 팁

  • 스냅샷마다 country, time_range, collected_at을 함께 저장하세요. 순위는 그 순위가 나온 목록 안에서만 의미가 있습니다.
  • id를 Hashtag Insights로 넘길 때는 같은 country와 time_range를 다시 쓰세요.
  • 100개 전체를 한 번만 가져와 로컬에서 필터링하세요. results_limit을 바꿔 가며 반복 요청하면, 요청마다 반환된 행 수만큼 청구됩니다.

TikTok Creative Center Trending Hashtags API 외에 TikTok Creative Center의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

다른 플랫폼 둘러보기

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

TikTok Creative Center Trending Hashtags API — 자주 묻는 질문

TikTok Creative Center Trending Hashtags API는 TikTok Creative Center에서 한 국가의 7일, 30일, 90일 트렌딩 해시태그 순위를 가져오는 프로그래밍 인터페이스입니다. 해시태그별 순위, 게시물 수, 조회수, 일별 인기도 곡선을 반환합니다.

country에 US, GB, JP 같은 두 글자 코드를 보내세요. 기본값은 US이며 시장마다 순위가 따로 있습니다. 공개된 순위가 없는 시장은 결과가 0건이고 청구되지 않습니다.

지금 오르는 것을 보려면 7d, 몇 달간 관심을 유지한 태그를 보려면 90d를 쓰세요. 기간마다 별도의 목록이라서 같은 해시태그도 기간별로 순위가 다를 수 있습니다.

국가와 기간마다 최대 100개이며 results_limit으로 정하고 기본값은 20입니다. 반환된 행 1개당 0.5 크레딧으로 청구되므로 100개를 모두 받으면 50 크레딧입니다.

popularity_curve의 끝부분을 보세요. 0~100 값이 하루에 하나씩 들어 있습니다. 마지막 날에도 값이 오르는 중이면 상승세이고, 이전 최고점에서 내려왔다면 순위와 관계없이 식고 있는 것입니다.

아니요. 요청은 country, time_range, results_limit만 받습니다. 신규 진입 태그를 찾으려면 날마다 목록을 저장해 이전 목록과 해시태그 id를 비교하세요.

TikTok은 갱신 주기를 공개하지 않습니다. 인기도 곡선은 하루 단위로 움직이고 모든 레코드에 collected_at이 있으므로, 국가별로 하루 한 번 요청하면 흐름을 따라갈 수 있습니다.

아니요. 필요한 인증은 SocQ API 키 하나뿐입니다.