douyin/
video-comments

Douyin 동영상 URL에서 공개 댓글 한 페이지를 수집하여 정규화된 본문, 작성자, 관계, 시각, 공개된 참여도 필드를 반환합니다.

Douyin Video Comments API

동영상 URL 직접 입력
원본 1페이지
CommentItem 1.0
요청당 0.1 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Douyin Video Comments

Douyin 동영상 댓글은 동영상에 달린 공개 반응으로, 본문, 작성자 정보, 게시 맥락, 공개된 좋아요·답글 지표를 담고 있습니다. 이러한 레코드는 시청자 반응 검토, 대화 구조 파악, 특정 시점의 참여도 비교에 활용할 수 있습니다.

Douyin Video Comments API 주요 기능

  • 동영상 직접 지정경로에 /video/{numeric_id}가 포함된 공개 douyin.com 또는 iesdouyin.com URL 하나에서 숫자형 동영상 ID를 추출합니다.
  • 범위가 정해진 1페이지 수집첫 번째 원본 페이지에서 댓글 행을 최대 20개 요청하며, results_limit이 저장할 부분 집합을 1~20개로 제어합니다.
  • 정형화된 댓글 정보본문, 작성자 정보, 동영상·부모 댓글 관계, 게시·수집 시각, 공개된 좋아요·답글 수를 담은 CommentItem 1.0 레코드를 반환합니다.

Douyin Video Comments API 매개변수

매개변수필수설명
url필수douyin.com, iesdouyin.com 또는 그 서브도메인의 공개 URL로, 필수 값입니다. 경로에는 /video/ 뒤에 숫자형 동영상 ID가 포함되어야 합니다.
results_limit선택1~20 범위의 정수이며 선택 항목입니다. 생략하면 기본값 20이 적용되고, 연동은 첫 번째 원본 페이지만 요청합니다.

Douyin Video Comments API 사용 방법

공개 Douyin 동영상 URL을 직접 지정하고 비동기 작업을 제출한 뒤, 해당 작업에 저장된 정규화된 댓글을 읽습니다.

  1. DOUYIN_VIDEO_URL을 /video/{numeric_id} 경로가 있는 공개 douyin.com 또는 iesdouyin.com URL로 설정합니다.
  2. url과 선택 항목 results_limit을 /v1/douyin/video-comments로 POST하고, task_id를 저장합니다.
  3. 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽고, SocQ에 이미 저장된 레코드를 이어서 보려면 has_more가 true인 동안에만 next_cursor를 따라갑니다.
curl -X POST "https://api.socq.ai/v1/douyin/video-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"${DOUYIN_VIDEO_URL}\",\"results_limit\":20}"

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

Douyin Video Comments API 추천 활용 사례

  • 시청자 반응 검토: 댓글 본문, 작성자 정보, 공개된 좋아요·답글 수로 알고 있는 공개 동영상에 대한 반응을 검토합니다.
  • 댓글 관계 매핑: 반환된 댓글을 post_id와 parent_id로 원본 동영상 및 제공된 부모 참조와 연결합니다.
  • 참여도 스냅샷 비교: collected_at을 관측 타임스탬프로 유지한 채, 선택한 동영상이나 수집 시점별 공개 댓글 지표를 비교합니다.

Douyin Video Comments API 활용 팁

  • 공유 링크나 리디렉션 링크는 최종적으로 허용되는 /video/{numeric_id} URL로 확인한 뒤 제출해야 호스트와 경로 검증을 통과할 수 있습니다.
  • 20개 행을 요청하려면 results_limit을 생략하고, 반환되는 원본 1페이지 중 일부만 필요하면 더 작은 정수를 선택하세요.
  • 처음 받은 task_id를 그대로 사용하고 has_more가 true일 때만 next_cursor를 따라가세요. 이 커서는 저장된 행을 읽을 뿐 다른 원본 페이지를 가져오지 않습니다.
  • 댓글 id를 기본 중복 제거 키로 사용하고, 원본 행에 관계 정보가 없으면 parent_id나 post_id는 null로 두세요.
  • 작성자 정보, published_at, 개별 지표는 선택 항목으로 취급하고, 결과 스냅샷마다 collected_at으로 시각을 기록하세요.
  • 공개 댓글은 사용자가 작성한 콘텐츠이므로 HTML에 넣기 전에 댓글 본문을 이스케이프하세요.

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

다른 플랫폼 둘러보기

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

Douyin Video Comments API — 자주 묻는 질문

Douyin Video Comments API는 숫자형 동영상 경로가 있는 Douyin 동영상 URL에서 공개 댓글 한 페이지를 수집해, 정규화된 본문, 작성자, 관계, 시각, 공개된 좋아요·답글 수 필드를 반환합니다.

url은 douyin.com, iesdouyin.com 또는 그 서브도메인을 사용해야 하고, 경로에 /video/ 뒤로 숫자형 ID가 포함되어야 합니다. 프로필, 검색, 동영상이 아닌 경로는 거부됩니다.

results_limit은 1~20 범위의 정수를 받으며 기본값은 20입니다. 작업은 원본 1페이지만 요청하므로 추가 원본 페이지로 이어서 수집할 수 없습니다.

CommentItem 1.0에는 기본 식별·시각 필드와 함께 본문, 작성자, parent_id, post_id, likes_count와 replies_count를 담은 metrics가 포함됩니다. 선택적인 원본 필드는 사용할 수 없으면 null로 유지됩니다.

별도의 답글 페이지 요청은 보내지 않습니다. 반환된 행에는 원본이 제공하는 경우 replies_count와 parent_id가 나타날 수 있지만, 이 필드가 있다고 해서 답글 본문까지 수집되었다는 뜻은 아닙니다.

next_cursor는 GET /v1/tasks/{task_id}에 속하며, 작업이 성공한 뒤 SocQ에 이미 저장된 레코드를 페이지네이션합니다. 다음 Douyin 원본 페이지를 요청하지는 않습니다.

작업이 성공할 때마다 results_limit이나 반환된 항목 수와 관계없이 고정 0.10 SocQ 크레딧이 차감되며, 실패한 작업은 런타임의 환불 경로를 따릅니다.