TikTok Hashtag Views
TikTok 해시태그 페이지는 그 태그를 쓴 모든 공개 동영상을 태그가 달린 동영상이 몇 개인지, 그 영상들이 조회수를 얼마나 모았는지라는 두 개의 누적 수치로 보여 줍니다. 두 수치를 함께 보면 주제의 크기와 경쟁 정도가 보이고, 영상당 조회수로는 그 태그를 단 콘텐츠의 평균적인 반응을 가늠할 수 있습니다.
TikTok Hashtag Views API 주요 기능
- 요청 한 번에 해시태그 최대 20개#가 있든 없든 1~20개 이름을 보내면, 존재하는 해시태그마다 레코드 1건씩 돌아옵니다.
- 합계를 정수로 제공metrics.posts_count와 metrics.views_count가 축약 표기 문자열이 아닌 정수로 오기 때문에 바로 정렬하고 나눌 수 있습니다.
- 해시태그 ID와 태그 페이지 링크id에는 TikTok의 숫자형 해시태그 ID가, url에는 태그 페이지가 들어 있어 실행할 때마다 레코드를 이어 붙일 수 있는 키가 됩니다.
TikTok Hashtag Views API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
hashtags | 필수 | 해시태그 이름 1~20개이며, 앞의 # 기호는 있어도 없어도 됩니다. |
TikTok Hashtag Views API 사용 방법
해시태그 목록을 보내고 태그마다 레코드 1건씩 읽습니다.
- {"hashtags": ["cooking", "booktok"]}을 /v1/tiktok/hashtag-detail로 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- results.items에서 해시태그별 name, metrics.posts_count, metrics.views_count를 읽습니다.
curl -X POST "https://api.socq.ai/v1/tiktok/hashtag-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtags":["cooking","booktok"]}'
# metrics.posts_count is the video count; metrics.views_count is the total views.TikTok Hashtag Views API 추천 활용 사례
- 캠페인 해시태그 후보 추리기: 후보 태그를 한 번에 조회해, 경쟁 정도는 posts_count로, 도달 규모는 views_count로 견준 뒤 사용할 조합을 확정합니다.
- 브랜드 해시태그 모니터링: 캠페인 태그를 일정 주기로 조회해, 프로모션을 집행할 때마다 동영상 수와 총 조회수가 어떻게 오르는지 그래프로 그립니다.
- 주제 규모 조사: 니치나 유행, 사회적 이슈를 대표하는 태그를 조회해 합계를 비교하면, 그 주제의 콘텐츠가 어디에 몰려 있는지 알 수 있습니다.
TikTok Hashtag Views API 활용 팁
- 주제의 크기를 잴 때 해시태그별 views_count를 더하지 마세요. 여러 태그를 함께 단 영상은 태그마다 중복 집계됩니다. 태그끼리 나란히 비교하거나 가장 큰 값을 쓰세요.
- views_count를 posts_count로 나누는 계산은 posts_count가 있고 0보다 클 때만 하세요. 영상당 평균 조회수로 순위를 매기면 규모가 크게 다른 태그도 비교할 수 있습니다.
- 태그를 추적할 때는 결과마다 collected_at 시각과 함께 저장하세요. 요청할 때마다 현재 합계만 돌아오므로, 이전 스냅샷을 쌓아 두어야 증가 추이를 볼 수 있습니다.
- 결과는 순서가 아니라 name이나 id로 입력 목록과 맞추세요. 존재하지 않는 해시태그는 건너뛰기 때문에 결과가 입력보다 짧을 수 있습니다.
관련 API
TikTok Hashtag Views API 외에 TikTok의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Hashtags API — 지정한 해시태그의 공개 동영상, 크리에이터, 미디어, 사운드, 참여도를 수집합니다.
- TikTok Search API — 키워드로 공개 동영상을 검색하며, 지원되는 정렬 및 게시 기간 필터를 사용할 수 있습니다.
- TikTok Live Room Info API — 방 ID와 소유자 ID 쌍으로 알고 있는 라이브 방송 하나를 조회하며, 상태, 소유자 맥락, 커버 미디어, 시청자 수를 반환합니다.
- TikTok Search Users API — 키워드로 공개 TikTok 계정을 검색합니다.
- TikTok Top Search API — 키워드로 동영상과 이미지 게시물을 검색하며, 캡션, 크리에이터, 상호작용 수를 포함합니다.
- TikTok Trending Searches API — 오늘 TikTok에서 트렌드 중인 검색어를 순위대로 가져옵니다.
- TikTok Profiles API
- TikTok Comments API
- TikTok Videos API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API