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 사용 방법
국가와 기간을 고르고 순위를 읽습니다.
- {"country": "US", "time_range": "7d", "results_limit": 20}을 /v1/tiktok-creative-center/trending-hashtags로 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- 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을 바꿔 가며 반복 요청하면, 요청마다 반환된 행 수만큼 청구됩니다.
관련 API
TikTok Creative Center Trending Hashtags API 외에 TikTok Creative Center의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Creative Center Top Ads API — 키워드와 기간으로 성과 상위 광고를 탐색하며, 캡션, CTR, 좋아요 수, 광고 동영상을 포함합니다.
- TikTok Creative Center Ad Analysis API — 상위 광고 하나를 클릭률·유지율 곡선으로 초 단위까지 분석합니다.
- TikTok Creative Center Hashtag Insights API — 트렌드 해시태그 하나의 인기 곡선, 상위 국가, 예시 동영상을 자세히 살펴봅니다.
- TikTok Creative Center Top Videos API — 국가별 성과 상위 동영상 차트를 조회수, 참여율과 함께 가져옵니다.
- TikTok Creator Marketplace API — Creator Marketplace 카드를 팔로워 인구통계, 조회수 중앙값, 시작 단가와 함께 가져옵니다.