youtube/
comment-replies

고정된 동영상 URL과 상위 댓글 ID로 공개 YouTube 답글을 수집하고, 텍스트, 작성자, 참여도, 타임스탬프, 스레드 컨텍스트를 반환합니다.

YouTube Comment Replies API

고정된 댓글 입력
공개 답글
스레드 컨텍스트
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

YouTube Comment Replies

YouTube 댓글 답글은 최상위 동영상 댓글 아래에 달린 공개 응답으로, 답글 텍스트, 작성자 정보, 공개된 좋아요 수, 게시 시각, 상위 댓글 및 동영상 정보를 담고 있습니다. 이러한 스레드 레코드는 대화 재구성, 응답 검토, 공개 토론 데이터셋 준비에 활용할 수 있습니다.

YouTube Comment Replies API 주요 기능

  • 고정된 댓글 참조공개 동영상 URL과 상위 댓글 ID만 있으면 시작할 수 있으며, 현재의 답글 continuation 토큰은 SocQ가 내부에서 처리합니다.
  • 답글 및 작성자 레코드답글 ID, 공개 텍스트, 관련 URL, 게시 시각, 정규화된 작성자 또는 채널 정보를 반환합니다.
  • 스레드 및 크리에이터 컨텍스트공개된 좋아요 수, 중첩 답글 수, 상위 댓글·동영상 참조, 채널 소유자 및 크리에이터 하트 표시를 함께 유지합니다.
  • 상한이 있는 continuation 수집소스의 후속 continuation 토큰을 따라가며 중복된 답글 ID를 제거하고, 지정한 한도에 도달하거나 스레드가 끝나거나 100페이지 상한에 이르면 멈춥니다.

YouTube Comment Replies API 매개변수

매개변수필수설명
url필수상위 댓글이 포함된, 고정된 공개 YouTube 동영상 URL로 필수 값입니다.
comment_id필수제출한 동영상 URL에 속한 최상위 댓글 ID로 필수 값입니다.
results_limit선택이 스레드에서 수집할 공개 답글의 최대 개수입니다. 문서의 예시는 20을 사용하며, 허용 범위는 20~2000입니다.

YouTube Comment Replies API 사용 방법

고정된 동영상 URL과 상위 댓글 ID를 비동기 작업으로 제출한 뒤, 완료된 작업에서 정규화된 답글 레코드를 읽습니다.

  1. 공개 YouTube 동영상 URL과, 해당 동영상에서 반환된 최상위 댓글 ID를 선택합니다.
  2. url, comment_id, results_limit을 /v1/youtube/comment-replies로 POST합니다.
  3. 반환된 task_id를 보관하고, 작업이 queued, running, retrying 상태인 동안 GET /v1/tasks/{task_id}를 폴링합니다.
  4. 성공하면 data.results.items를 읽고, data.results.has_more가 true인 동안 data.results.next_cursor를 작업 요청의 cursor로 전달합니다.
curl -X POST "https://api.socq.ai/v1/youtube/comment-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","comment_id":"Ugzge340dBgB75hWBm54AaABAg","results_limit":20}'

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

YouTube Comment Replies API 추천 활용 사례

  • 알고 있는 스레드 재구성: 답글 ID, parent_comment_id, video_id, URL, 타임스탬프로 저장해 둔 답글을 선택한 최상위 댓글에 다시 연결합니다.
  • 답글 단위 오디언스 검토: 알고 있는 하나의 스레드 안에서 공개 답글 텍스트, 작성자 정보, 공개 좋아요 수, 중첩 답글 수, 크리에이터 상호작용 표시를 비교합니다.
  • 공개 토론 데이터셋 준비: 정규화된 답글 텍스트, 작성자, 타임스탬프, 스레드 컨텍스트를 수작업 검토나 후속 텍스트 처리용 레코드로 결합합니다.

YouTube Comment Replies API 활용 팁

  • 답글 스레드와 원본 동영상의 정합성을 유지하려면 동영상 URL과 최상위 댓글 ID를 항상 한 쌍으로 보관하세요.
  • SocQ가 현재의 continuation 토큰을 내부에서 처리합니다. 업스트림 토큰이 만료되면 같은 고정 참조로 다시 시도하세요.
  • 원본 댓글 ID와 GET /v1/tasks/{task_id}가 반환하는 cursor는 서로 다른 값으로 관리하세요. 전자는 YouTube 답글 스레드를 선택하고, 후자는 저장된 작업 결과를 페이지 단위로 넘깁니다.
  • results_limit은 예상되는 스레드 크기로 설정하되 상한으로만 취급하세요. 공개 여부와 스레드 소진에 따라 반환 건수가 더 적을 수 있습니다.
  • 저장한 레코드는 답글 ID로 중복을 제거하고, 답글을 원본 댓글에 다시 조인할 때는 parent_comment_id, video_id, extra.reply_token을 함께 보관하세요.
  • 작성자, 타임스탬프, 지표, 크리에이터 표시 필드는 null일 수 있다고 가정하고, 공개 답글 텍스트는 다른 화면에 표시하기 전에 이스케이프하세요.

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

  • YouTube Channel Videos API — 채널 URL에서 쇼츠와 라이브 방송을 제외한 일반 공개 동영상을 수집합니다.
  • YouTube Comments API — 공개 댓글, 작성자, 참여도, 원본 동영상, 대화 맥락을 수집합니다.
  • YouTube Transcripts API — 제공되는 일반 텍스트 스크립트를 가져오며, 언어를 선택할 수 있습니다.
  • YouTube Channels API — 공개 채널 정보, 이미지, 인증 여부, 공개된 오디언스 통계를 가져옵니다.
  • YouTube Videos API — 알고 있는 동영상 또는 쇼츠 URL의 메타데이터, 썸네일, 길이, 참여도를 가져옵니다.
  • YouTube Community Post Comments API — 커뮤니티 게시물 링크에 달린 댓글을 수집하며, 댓글 작성자 채널, 좋아요 수, 답글 수를 포함합니다.

다른 플랫폼 둘러보기

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

YouTube Comment Replies API — 자주 묻는 질문

YouTube Comment Replies API는 최상위 YouTube 댓글 하나에 달린 공개 답글을 수집하는 프로그래밍 인터페이스입니다. 고정된 동영상 URL과 댓글 ID를 제출하면 답글 텍스트, 작성자 정보, 공개된 참여 지표, 타임스탬프, 스레드 컨텍스트를 받을 수 있습니다.

공개 동영상 URL로 YouTube Comments API를 실행한 뒤, 같은 동영상에서 반환된 호환 가능한 최상위 댓글의 ID를 사용하세요.

아니요. SocQ가 제출한 동영상 URL과 댓글 ID로 현재의 continuation 토큰을 처리합니다. 레거시 토큰 입력은 API 호환용 경로로 남아 있지만 이 플레이그라운드에서는 사용하지 않습니다.

results_limit은 20~2000의 정수를 받으며, 문서의 플레이그라운드 예시는 20을 제출합니다. 수집은 그 상한에 도달하거나, 공개 스레드가 끝나거나, 소스 100페이지를 읽으면 멈춥니다.

답글에는 ID, URL, 텍스트, 공개된 작성자 또는 채널 정보, 공개 좋아요 수와 중첩 답글 수, 게시 시각과 수집 시각이 포함될 수 있으며, 동영상·상위 댓글·크리에이터 표시·토큰 컨텍스트는 extra에 담깁니다.

아니요. comment_id는 원본 YouTube 답글 스레드를 선택하고, cursor는 성공한 SocQ 작업에 이미 저장된 정규화 레코드를 페이지 단위로 넘깁니다.

상위 댓글이 답글 토큰을 제공하지 않을 수 있고, 스레드가 results_limit에 도달하기 전에 끝날 수 있으며, 답글이 삭제·숨김·검토 보류·멤버 전용·비활성화되었거나 그 밖의 이유로 공개되지 않을 수 있습니다.

저장된 정규화 답글 1건당 0.5 크레딧입니다. 요금은 실제로 저장된 레코드 수에 따라 부과되므로, 결과가 비어 있으면 결과 단위 요금이 발생하지 않습니다.