tiktok/
comment-replies

동영상 URL과 댓글 ID로 댓글 하나의 TikTok 공개 답글을 수집하고, 텍스트, 작성자, 타임스탬프, 참여 수치, 부모 맥락을 정규화된 레코드로 반환합니다.

TikTok Comment Replies API

알고 있는 댓글의 답글
작성자 맥락
부모 참조
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

TikTok Comment Replies

TikTok 댓글 답글은 알고 있는 동영상 댓글 아래에 달린 공개 반응으로, 답글 텍스트, 작성자 정보, 타임스탬프, 공개된 좋아요 수와 답글 수, 부모 댓글 참조를 담고 있습니다. 이러한 대화 레코드는 스레드 재구성, 참여자 검토, 반응 조사, 답글 단위 모니터링에 활용할 수 있습니다.

TikTok Comment Replies API 주요 기능

  • 댓글 지정 답글 범위지원되는 TikTok 동영상 URL 하나를 알고 있는 comment_id와 짝지어, 동영상의 최상위 댓글이 아니라 해당 댓글의 공개 답글 피드를 수집합니다.
  • 답글, 작성자, 참여 필드답글 ID와 텍스트, 공개 작성자 정보와 계정 속성, 타임스탬프, 공개된 좋아요 수와 답글 수, 멘션, 원본 동영상 맥락을 받습니다.
  • 제한된 범위의 중복 제거 순회제공되는 답글 커서를 따라가며 중복된 댓글 ID를 제거하고, 요청한 한도, 스레드의 끝, 100페이지 수집 상한 중 먼저 도달하는 지점에서 멈춥니다.

TikTok Comment Replies API 매개변수

매개변수필수설명
url필수/video/{numeric_id} 경로를 가진 tiktok.com, www.tiktok.com 또는 m.tiktok.com의 TikTok 동영상 URL로, 필수 값입니다.
comment_id필수같은 동영상에서 선택한 최상위 댓글의 공개 댓글 ID로, 비어 있지 않아야 하는 필수 값입니다.
results_limit선택댓글 하나에 대해 요청할 답글의 최대 개수입니다. 기본값은 100이며 20~2,000 범위의 정수를 받습니다.

TikTok Comment Replies API 사용 방법

TikTok 동영상 하나의 최상위 댓글 ID로 시작해 비동기 답글 작업을 제출하고, 정규화된 레코드를 결과 커서 페이지네이션으로 읽습니다.

  1. 해당 동영상에 TikTok Comments API를 실행해, 답글이 필요한 최상위 댓글의 id를 선택합니다.
  2. 같은 동영상 url, 그 comment_id, 선택 사항인 results_limit을 /v1/tiktok/comment-replies로 POST합니다.
  3. 상태가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. /v1/tasks/{task_id}?limit=50에서 data.results.items를 읽고, results.has_more가 true인 동안 results.next_cursor를 전달합니다.
curl -X POST "https://api.socq.ai/v1/tiktok/comment-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/@loganpaul/video/7411198650782731563","comment_id":"7411205662439736097","results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.

TikTok Comment Replies API 추천 활용 사례

  • 알고 있는 댓글의 스레드 재구성: 답글 ID, extra.parent_comment_id, extra.input_url을 조합해, 선택한 최상위 댓글 아래의 공개 답글 스레드를 재구성합니다.
  • 답글 단위 반응 검토: 답글 텍스트, 타임스탬프, 공개된 좋아요 수와 답글 수를 활용해 특정 대화 안의 공개 반응을 검토하고 비교합니다.
  • 대화 참여자 매핑: 공개 작성자 ID, 사용자 이름, 프로필 링크, 아바타, 계정 속성을 활용해 반환된 답글 피드에 나타난 참여자를 매핑합니다.

TikTok Comment Replies API 활용 팁

  • comment_id는 TikTok Comments 결과 중 최상위 댓글의 정규화된 id에서 가져오고 그 결과의 동영상 URL을 그대로 사용하세요. 동영상 ID는 댓글 ID가 아닙니다.
  • 단축 링크, 프로필, 동영상이 아닌 링크가 입력 검사에서 실패하지 않도록, 제출하기 전에 URL 호스트와 숫자 /video/ 경로를 검증하세요.
  • 필요한 답글 수에 맞게 results_limit을 설정하세요. 공개 스레드가 한도 전에 끝날 수 있으며, 수집은 원본 100페이지 이후 멈춥니다.
  • 여러 작업을 합칠 때는 답글 id 기준으로 중복을 제거하되, 답글이 올바른 대화에 연결되도록 extra.parent_comment_id와 extra.input_url을 함께 보관하세요.
  • 답글 텍스트, 작성자 필드, 지표, 멘션, 타임스탬프는 null 허용 값으로 취급하고, 사용자가 작성한 텍스트는 후속 도구에 표시하기 전에 이스케이프하세요.

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

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

다른 플랫폼 둘러보기

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

TikTok Comment Replies API — 자주 묻는 질문

TikTok Comment Replies API는 동영상 URL과 댓글 ID로 알고 있는 TikTok 동영상 댓글 아래의 공개 답글을 수집하는 프로그래밍 인터페이스입니다. 정규화된 답글 텍스트, 작성자 정보, 타임스탬프, 공개된 참여 수치, 부모 댓글 맥락을 반환합니다.

같은 동영상에 TikTok Comments API를 실행해, 선택한 최상위 댓글의 정규화된 id를 사용하세요. 답글 작업을 제출할 때는 그 id를 원본 동영상 URL과 짝지어 함께 보내야 합니다.

경로에 /video/와 숫자 동영상 ID가 이어서 포함된 tiktok.com, www.tiktok.com 또는 m.tiktok.com의 URL을 사용합니다. 단축 링크, 프로필 URL, 비어 있지 않은 comment_id가 없는 동영상 URL은 요청 사양을 충족하지 못합니다.

레코드에는 답글 ID와 텍스트, 원본 동영상 URL, 공개 작성자 정보와 계정 속성, 좋아요 수와 답글 수, 멘션, created_at, collected_at, extra.parent_comment_id, extra.input_url이 포함될 수 있습니다.

results_limit은 보장된 개수가 아니라 최대값입니다. 공개 답글 피드가 끝나거나, 새로운 고유 답글 ID가 더 반환되지 않거나, 피드의 커서가 더 이상 진행되지 않거나, 100페이지 상한에 도달하면 수집이 끝날 수 있습니다.

저장된 정규화된 답글 1개당 0.5 크레딧이 차감되며 기본 작업 요금은 없습니다. 최초 예상치는 results_limit 또는 기본값 100을 기준으로 하고, 최종 사용량은 실제로 저장된 레코드를 따릅니다. 저장된 답글이 없으면 결과 요금이 부과되지 않습니다.