tiktok-creative-center/
trending-hashtag-detail

Creative Center ID로 뜨는 TikTok 해시태그 하나를 조회해 게시물 수, 조회수, 일별 인기도 곡선, 점수 기준 상위 국가, 예시 영상 ID를 받습니다.

TikTok Creative Center Hashtag Insights API

해시태그 ID 입력
상위 국가
예시 영상
요청당 0.5 크레딧
준비됨
README

SocQ 작성 · 업데이트

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를 가져와 인사이트를 읽습니다.

  1. TikTok Creative Center Trending Hashtags로 해시태그를 수집한 뒤 id를 복사합니다.
  2. {"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"}를 /v1/tiktok-creative-center/trending-hashtag-detail로 POST합니다.
  3. 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는 국가 규모에 비례한 값이어서 작은 시장이 큰 시장보다 위에 있을 수 있습니다.

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

다른 플랫폼 둘러보기

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

TikTok Creative Center Hashtag Insights API — 자주 묻는 질문

TikTok Creative Center Hashtag Insights API는 Creative Center ID, 국가, 기간으로 뜨는 TikTok 해시태그 하나의 인사이트 레코드를 가져오는 프로그래밍 인터페이스입니다. 게시물 수, 조회수, 일별 인기도 곡선, 점수 기준 상위 국가, 예시 영상 ID를 반환합니다.

조회할 국가의 순위에서 가져온 Trending Hashtags 결과의 id 필드입니다. 5~32자리 숫자 문자열이며, 다른 형식은 400 오류로 거부됩니다.

여기서는 안 됩니다. 이 엔드포인트는 숫자 ID만 받습니다. 이름으로 태그의 동영상 수와 총 조회수를 확인하려면 TikTok Hashtag Views API를 사용하세요.

순위 행에서는 null인 top_countries와 video_ids입니다. 여기서 rank는 null인데, 순위는 순위 목록에 속한 정보이기 때문입니다. rank는 Trending Hashtags 결과의 값을 보관하세요.

해당 국가의 규모에 비해 그 해시태그가 얼마나 인기 있는지를 나타내는 값이며, 목록은 score가 높은 순입니다. 그래서 작은 시장이 큰 시장보다 위에 올 수 있습니다.

작업이 실패하고 전액 환불됩니다. 성공한 요청은 video_ids가 몇 개 오든 한 번에 0.5 크레딧이 청구됩니다.