tiktok/
comments

동영상 URL에서 공개된 TikTok 최상위 댓글을 수집하고, 정규화된 텍스트, 작성자, 좋아요 수, 답글 수, 멘션, 크리에이터 상호작용 플래그를 반환합니다.

TikTok Comments API

오디언스의 목소리
피드백 조사
댓글 우선순위
결과당 0.25 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

TikTok Comments

TikTok 댓글은 동영상에 달린 공개 반응으로, 텍스트와 작성자 정보, 공개된 좋아요 수, 답글 수, 멘션, 크리에이터 상호작용 신호를 담고 있습니다. 이러한 대화는 오디언스 피드백 분석, 반복되는 주제 조사, 감성 검토, 콘텐츠 반응 모니터링에 활용할 수 있습니다.

TikTok Comments API 주요 기능

  • 여러 동영상의 댓글 수집TikTok 동영상 URL 여러 개를 한 번의 요청으로 보내 공개된 최상위 댓글을 수집합니다.
  • 추적 가능한 댓글 레코드댓글 ID, 원본 동영상, 작성자, 게시 시각을 함께 제공하므로 피드백의 출처를 추적할 수 있습니다.
  • 댓글 텍스트와 멘션댓글 텍스트와 멘션을 추출해 주제, 감성, 니즈 분석에 활용할 수 있습니다.
  • 공개된 상호작용 신호댓글마다 공개된 좋아요 수, 답글 수, 고정 여부, 크리에이터 좋아요 여부를 함께 담습니다.
  • 동영상별 결과 수 제한results_limit 값으로 동영상마다 표본 크기를 정할 수 있습니다.

TikTok Comments API 매개변수

매개변수필수설명
urls필수공개된 최상위 댓글을 수집할 TikTok 동영상 URL의 목록으로, 필수 값입니다.
results_limit선택동영상 URL마다 요청할 최상위 댓글 수의 상한으로, 양수여야 합니다. 기본값은 100입니다.

TikTok Comments API 사용 방법

분석할 동영상과 동영상별 댓글 표본 크기를 정한 뒤, 오디언스 피드백 수집을 시작합니다.

  1. 콘텐츠 표본을 고르고 동영상별 results_limit 값을 정합니다.
  2. urls와 results_limit을 /v1/tiktok/comments로 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/comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.tiktok.com/@nasa/video/7412345678901234567"],"results_limit":100}'

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

TikTok Comments API 추천 활용 사례

  • 고객의 소리(VoC) 조사: 오디언스가 쓰는 표현 그대로 반복되는 니즈, 질문, 칭찬, 제안을 찾아냅니다.
  • 토론 검토 대기열: 댓글 텍스트, 공개된 좋아요 수, 답글 수를 기준으로 고객 지원, 조사, 소셜 리스닝 검토용 댓글을 정리합니다.
  • 크리에이티브 반응 분석: 동영상별 반응을 비교해 공감, 논쟁, 대화를 이끌어내는 아이디어를 찾습니다.
  • 크리에이터 상호작용 검토: 고정 댓글, 크리에이터 좋아요, 답글 수를 살펴보며 크리에이터가 댓글 영역을 어떻게 이끌어 가는지 파악합니다.

TikTok Comments API 활용 팁

  • 동영상의 중요도에 따라 results_limit 값을 배분하고, 여기에 URL 개수를 곱해 배치 규모를 예상하세요.
  • likes_count는 공감의 정도로, replies_count는 논의의 깊이로 보고 각각 별도로 분석하세요.
  • is_pinned와 creator_liked는 크리에이터가 직접 부각한 피드백을 가리키는 신호로 활용하세요.
  • 댓글 id 기준으로 중복을 제거하고, 출처를 분명히 하도록 동영상 URL과 collected_at을 함께 보관하세요.
  • 댓글 텍스트를 대시보드, 티켓, 보고서에 넣기 전에 이스케이프 처리하고, 검토를 위해 원문도 보관하세요.
  • 상호작용 신호로 검토 순서를 정한 뒤, 원본 댓글 텍스트를 주제나 감성별로 분류하세요.

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

  • TikTok Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 계정 속성, 오디언스 수치를 가져옵니다.
  • TikTok Hashtags API — 지정한 해시태그의 공개 동영상, 크리에이터, 미디어, 사운드, 참여도를 수집합니다.
  • TikTok Videos API — 동영상 URL에서 크리에이터, 캡션, 미디어, 음악, 태그, 멘션, 참여도를 가져옵니다.
  • TikTok Search API — 키워드로 공개 동영상을 검색하며, 지원되는 정렬 및 게시 기간 필터를 사용할 수 있습니다.
  • TikTok Comment Replies API — TikTok 동영상 URL과 댓글 ID로 특정 댓글의 공개 답글을 수집하며, 작성자, 참여도, 타임스탬프, 상위 댓글 맥락을 포함합니다.
  • TikTok Comment Keywords API — 동영상 댓글에서 가장 많이 등장하는 키워드를 찾으며, 그 근거가 된 댓글을 포함합니다.

다른 플랫폼 둘러보기

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

TikTok Comments API — 자주 묻는 질문

TikTok Comments API는 TikTok 동영상 URL에서 공개적으로 볼 수 있는 최상위 댓글을 수집합니다. 정규화된 텍스트, 작성자 정보, 좋아요 수와 답글 수, 멘션, 크리에이터 상호작용 플래그를 반환하며, 답글 본문은 포함되지 않습니다.

urls 배열에 TikTok 동영상 URL을 하나 이상 제출하고, results_limit으로 동영상마다 요청할 댓글 수를 지정합니다.

네. urls에는 여러 동영상 링크를 넣을 수 있으며, 하나의 비동기 작업이 각 동영상의 공개된 최상위 댓글을 처리합니다.

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

결과에는 댓글 ID, 텍스트, 게시 시각, 원본 동영상 URL과 함께 ID, 사용자 이름, 표시 이름, 프로필 URL, 아바타, 인증 여부 같은 공개 작성자 필드가 포함됩니다.

공개 상호작용 분석에 쓸 수 있도록 좋아요 수, 답글 수, 멘션, 크리에이터 좋아요 여부, 고정 여부가 결과에 포함될 수 있습니다.

공개된 좋아요 수와 답글 수로 정렬하거나 필터링한 뒤, 고정 여부와 크리에이터 좋아요 여부를 추가 맥락으로 활용하세요. 이 신호들은 공개된 상호작용을 보여 줄 뿐, 그 자체로 댓글의 감성을 판단하지는 않습니다.

정규화된 댓글 결과 1건이 반환될 때마다 0.25 크레딧이 차감됩니다.