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를 비동기 작업으로 제출한 뒤, 완료된 작업에서 정규화된 답글 레코드를 읽습니다.
- 공개 YouTube 동영상 URL과, 해당 동영상에서 반환된 최상위 댓글 ID를 선택합니다.
- url, comment_id, results_limit을 /v1/youtube/comment-replies로 POST합니다.
- 반환된 task_id를 보관하고, 작업이 queued, running, retrying 상태인 동안 GET /v1/tasks/{task_id}를 폴링합니다.
- 성공하면 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 trueYouTube 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일 수 있다고 가정하고, 공개 답글 텍스트는 다른 화면에 표시하기 전에 이스케이프하세요.
관련 API
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 Shorts API
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API