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을 직접 지정하고 비동기 작업을 제출한 뒤, 해당 작업에 저장된 정규화된 댓글을 읽습니다.
- DOUYIN_VIDEO_URL을 /video/{numeric_id} 경로가 있는 공개 douyin.com 또는 iesdouyin.com URL로 설정합니다.
- url과 선택 항목 results_limit을 /v1/douyin/video-comments로 POST하고, task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 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 trueDouyin 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에 넣기 전에 댓글 본문을 이스케이프하세요.
관련 API
Douyin Video Comments API 외에 Douyin의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Douyin Live Room Detail API — 숫자형 방 ID로 알고 있는 Douyin 라이브 방송 하나를 가져오며, 정규화된 방송 맥락, 호스트 정보, 미디어, 공개된 시청자 수를 포함합니다.
- Douyin User Profile API
- Douyin User Videos API
- Douyin Video Detail API
- Douyin Video Search API