tiktok/
hashtag-detail

최대 20개 TikTok 해시태그의 동영상 수와 총 조회수를 한 번에 확인하고, 해시태그별 ID와 태그 페이지 링크를 반환해 나란히 비교할 수 있습니다.

TikTok Hashtag Views API

해시태그 최대 20개
총 조회수
동영상 수
결과당 0.5 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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건씩 읽습니다.

  1. {"hashtags": ["cooking", "booktok"]}을 /v1/tiktok/hashtag-detail로 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. 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로 입력 목록과 맞추세요. 존재하지 않는 해시태그는 건너뛰기 때문에 결과가 입력보다 짧을 수 있습니다.

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 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

TikTok Hashtag Views API — 자주 묻는 질문

TikTok Hashtag Views API는 이름으로 최대 20개 TikTok 해시태그의 합계 수치를 조회하는 프로그래밍 인터페이스입니다. 해시태그별 ID, 페이지 URL, 동영상 수, 총 조회수를 반환합니다.

해시태그 이름을 보낸 뒤 총 조회수는 metrics.views_count에서, 그 태그를 쓴 동영상 수는 metrics.posts_count에서 읽으면 됩니다. 두 값 모두 해시태그 전체의 누적 수치입니다.

응답에는 해시태그마다 metrics.views_count가 metrics.posts_count와 함께 들어 있습니다. TikTok이 해당 태그에 대해 제공하지 않는 수치는 null로 옵니다.

최대 20개이며 #는 붙여도 되고 빼도 됩니다. 존재하는 해시태그마다 레코드가 따로 오기 때문에, 후보 목록 전체를 결과 하나로 비교할 수 있습니다.

결과에서 빠지고 요금도 청구되지 않으며, 같은 요청의 다른 해시태그는 정상적으로 반환됩니다. 요청한 해시태그가 모두 없으면 비용이 들지 않습니다.

이 엔드포인트는 collected_at 시각이 붙은 현재 합계만 반환하며 과거 내역은 없습니다. 일정 주기로 실행해 스냅샷을 모아 두면 증가 추이를 그릴 수 있습니다.

아니요, 해시태그의 합계와 식별자만 반환합니다. 동영상 자체를 수집하려면 TikTok Hashtags를 사용하세요.

존재하는 해시태그 1개당 0.5 크레딧입니다. 존재하는 태그 20개를 조회하면 10 크레딧이고, 일치하는 태그가 없는 요청은 비용이 들지 않습니다.