TikTok Creative Center Hashtag Insights
Creative Center의 해시태그 인사이트는 한 시장에서 뜨는 태그 하나를 상세하게 보여 주는 프로필로, 게시물 수와 조회수, 일별 인기도 곡선, 국가 규모 대비 가장 인기 있는 국가, 그 태그를 쓴 예시 영상이 담깁니다. 이 정보를 함께 보면 트렌드가 어떻게 움직이는지, 다른 어느 나라에서 반응이 있는지, 어떤 콘텐츠가 트렌드를 끌고 가는지 알 수 있습니다.
TikTok Creative Center Hashtag Insights API 주요 기능
- ID 하나로 태그 하나를 조회hashtag_id에 Trending Hashtags 결과의 id를 넣으면, 선택한 country와 time_range 기준으로 그 태그의 레코드 1건이 돌아옵니다.
- 해당 기간의 곡선과 수치popularity_curve가 날짜별로 0~100 값을 하나씩 알려 주고, metrics.posts_count와 metrics.views_count가 함께 옵니다.
- 점수 순으로 나열된 국가top_countries에 country_code와 score가 높은 순으로 나열되며, score는 국가 규모에 비례한 인기도를 반영합니다.
- 예시 영상 IDvideo_ids에 그 태그를 쓴 영상이 나열되어, 트렌드가 어떤 콘텐츠 위에 세워졌는지 알 수 있습니다.
TikTok Creative Center Hashtag Insights API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
hashtag_id | 필수 | TikTok Creative Center Trending Hashtags 결과에서 가져온 해시태그 ID입니다. |
country | 선택 | 시장의 두 글자 국가 코드이며, US, GB, JP 등이 있습니다. 기본값은 US입니다. |
time_range | 선택 | 분석할 기간으로, 7d(기본값), 30d, 90d 중 하나입니다. |
TikTok Creative Center Hashtag Insights API 사용 방법
트렌딩 순위에서 해시태그 ID를 가져와 인사이트를 읽습니다.
- TikTok Creative Center Trending Hashtags로 해시태그를 수집한 뒤 id를 복사합니다.
- {"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"}를 /v1/tiktok-creative-center/trending-hashtag-detail로 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링한 뒤 results.items의 레코드 1건을 읽습니다.
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtag-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtag_id":"7155204034885287979","country":"US","time_range":"7d"}'
# top_countries lists {country_code, score}; video_ids lists example videos.TikTok Creative Center Hashtag Insights API 추천 활용 사례
- 트렌드에 올라탈지 판단: 캠페인을 태그 하나에 걸기 전에 popularity_curve와 metrics의 수치를 읽고, 곡선이 마지막 날에도 오르는 중인지 확인합니다.
- 확장할 시장 선별: 자국에서 뜨는 태그가 다른 어느 나라에서 가장 높은 점수를 받는지 top_countries로 확인하고, 현지화 게시물을 만들 국가를 추립니다.
TikTok Creative Center Hashtag Insights API 활용 팁
- id가 나온 순위와 같은 country와 time_range를 넘기세요. 그래야 수치가 태그를 고른 그 목록을 설명합니다.
- top_countries를 규모순 순위로 읽지 마세요. score는 국가 규모에 비례한 값이어서 작은 시장이 큰 시장보다 위에 있을 수 있습니다.
관련 API
TikTok Creative Center Hashtag Insights API 외에 TikTok Creative Center의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Creative Center Top Ads API — 키워드와 기간으로 성과 상위 광고를 탐색하며, 캡션, CTR, 좋아요 수, 광고 동영상을 포함합니다.
- TikTok Creative Center Ad Analysis API — 상위 광고 하나를 클릭률·유지율 곡선으로 초 단위까지 분석합니다.
- TikTok Creative Center Trending Hashtags API — 국가별 트렌드 해시태그 순위를 게시물 수, 조회수, 인기 곡선과 함께 가져옵니다.
- TikTok Creative Center Top Videos API — 국가별 성과 상위 동영상 차트를 조회수, 참여율과 함께 가져옵니다.
- TikTok Creator Marketplace API — Creator Marketplace 카드를 팔로워 인구통계, 조회수 중앙값, 시작 단가와 함께 가져옵니다.