tiktok/
hashtags

하나 이상의 해시태그에 대한 공개 TikTok 동영상을 수집하고, 정규화된 크리에이터, 캡션, 미디어, 사운드, 참여도, 일치한 해시태그 정보를 반환합니다.

TikTok Hashtags API

캠페인 트래킹
커뮤니티 콘텐츠
태그 비교
결과당 0.7 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

TikTok Hashtags

TikTok 해시태그는 공통된 문구, 캠페인, 이벤트, 관심사를 중심으로 공개 동영상을 묶어 주는 주제 라벨이며, 크리에이터·콘텐츠·미디어·사운드·참여도 신호가 함께 담겨 있습니다. 이러한 레코드는 트렌드 발굴, 주제 모니터링, 캠페인 조사, 오디언스 분석에 활용할 수 있습니다.

TikTok Hashtags API 주요 기능

  • 해시태그 병렬 수집캠페인, 브랜드, 커뮤니티 해시태그 여러 개를 동시에 제출할 수 있습니다.
  • 해시태그 입력 정규화#campaign과 campaign을 일관된 태그 형식으로 정규화합니다.
  • 태그별 결과 수 제한results_limit을 태그마다 적용해 표본 규모를 명확하게 계획할 수 있습니다.
  • 일치한 해시태그 정보모든 동영상에 matched_hashtag를 남겨 제출한 그룹 정보를 보존합니다.
  • 비교 가능한 동영상 레코드해시태그 조회수, 크리에이터, 크리에이티브 요소, 동영상 참여도를 하나의 데이터 구조로 비교할 수 있습니다.

TikTok Hashtags API 매개변수

매개변수필수설명
hashtags필수명시적인 해시태그 값의 목록으로, 필수 값입니다. 앞의 #는 있어도 없어도 됩니다.
results_limit선택해시태그마다 요청할 동영상 수의 상한으로, 양수여야 합니다. 기본값은 100입니다.

TikTok Hashtags API 사용 방법

추적할 태그를 정리하고 태그별 동영상 표본 크기를 정해, 그룹 비교에 바로 쓸 수 있는 데이터셋을 만듭니다.

  1. 캠페인, 브랜드, 커뮤니티 태그를 모아 space와 #space를 같은 형태로 정규화한 뒤 중복을 제거합니다.
  2. hashtags와 results_limit을 /v1/tiktok/hashtags로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽습니다. has_more가 true이면 next_cursor로 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/tiktok/hashtags" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["space","#astronomy"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

TikTok Hashtags API 추천 활용 사례

  • UGC 캠페인 트래킹: 공식 캠페인 태그로 참여한 콘텐츠를 수집해 크리에이터의 도달 범위, 콘텐츠 방향, 참여도 분포를 살펴봅니다.
  • 브랜드 태그 에셋 목록 구축: 브랜드·상품 해시태그 동영상을 마케팅·소셜 팀이 검색할 수 있는 라이브러리로 만듭니다.
  • 관심사 커뮤니티 프로필 파악: 크리에이터, 캡션, 음악, 참여도를 활용해 관심사 태그를 둘러싼 콘텐츠 문화를 이해합니다.
  • 해시태그 코호트 비교: 여러 태그를 동시에 수집해 그룹별 크리에이터 구성, 크리에이티브 요소, 성과를 비교합니다.

TikTok Hashtags API 활용 팁

  • 앞의 #를 제거하고 대소문자를 통일하며 중복을 정리해, 태그마다 표본 그룹이 분명하게 나뉘도록 하세요.
  • 태그 수에 results_limit을 곱한 값은 요청한 최댓값일 뿐, 결과 총량이 보장되는 값은 아닙니다.
  • 여러 그룹으로 수집된 동영상의 출처를 온전히 유지하도록 matched_hashtag를 보관하세요.
  • 해시태그 코호트를 비교할 때는 같은 results_limit과 수집 시점을 사용하세요.
  • 해시태그 조회수와 각 동영상의 참여도 수치는 서로 다른 시점의 값으로 구분해서 다루세요.
  • 자주 등장하는 크리에이터는 Profiles 데이터로 보강해, 각 태그가 끌어들이는 크리에이터 구성을 파악하세요.

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

  • TikTok Comments API — 공개된 최상위 댓글, 작성자, 참여도, 멘션, 크리에이터 상호작용 플래그를 수집합니다.
  • TikTok Videos API — 동영상 URL에서 크리에이터, 캡션, 미디어, 음악, 태그, 멘션, 참여도를 가져옵니다.
  • TikTok Search API — 키워드로 공개 동영상을 검색하며, 지원되는 정렬 및 게시 기간 필터를 사용할 수 있습니다.
  • TikTok Live Room Info API — 방 ID와 소유자 ID 쌍으로 알고 있는 라이브 방송 하나를 조회하며, 상태, 소유자 맥락, 커버 미디어, 시청자 수를 반환합니다.
  • TikTok Search Users API — 키워드로 공개 TikTok 계정을 검색합니다.
  • TikTok Hashtag Views API — 해시태그를 최대 20개까지 한 번에 지정해 총 동영상 수와 조회수를 조회합니다.

다른 플랫폼 둘러보기

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

TikTok Hashtags API — 자주 묻는 질문

TikTok Hashtags API는 지정한 하나 이상의 TikTok 해시태그에 대해 공개적으로 접근할 수 있는 동영상을 수집합니다. 정규화된 동영상, 크리에이터, 캡션, 미디어, 사운드, 참여도, 일치한 해시태그 데이터를 반환합니다.

hashtags 배열에 태그 이름을 넣습니다. fyp와 #fyp 두 형식을 모두 사용할 수 있으며, 앞의 #는 수집 전에 정규화됩니다.

네. hashtags에는 태그 이름을 여러 개 넣을 수 있으며, 같은 비동기 작업 안에서 태그별로 따로 수집됩니다.

results_limit은 입력한 태그마다 따로 적용되며 기본값은 100입니다. 태그 3개에 100을 지정하면 태그별로 동영상을 최대 100개씩 요청합니다.

matched_hashtag에는 해당 동영상이 수집되게 한 입력 태그가 기록되며, 공개된 해시태그 조회수와 함께 출처 귀속과 그룹별 분석에 활용할 수 있습니다.

결과에는 동영상 ID, URL, 캡션, 게시 시각, 크리에이터, 공개 참여도, 해시태그, 멘션, 미디어, 음악, 수집 시각이 포함됩니다.

결과를 matched_hashtag로 그룹화한 뒤, 그룹별로 크리에이터 구성, 캡션, 음악, 해시태그 조회수, 동영상 참여도를 비교하세요.

정규화된 해시태그 동영상 결과 1건이 반환될 때마다 0.7 크레딧이 차감됩니다.