YouTube Comments
YouTube 댓글은 동영상에 달린 시청자의 공개 반응으로, 텍스트, 작성자 정보, 게시 시각, 공개된 좋아요 수, 답글 수, 원본 동영상 정보, 대화 관계를 담고 있습니다. 이러한 토론 신호는 피드백 분석, 오디언스 조사, 주제 검토, 반응 모니터링에 활용할 수 있습니다.
YouTube Comments API 주요 기능
- 여러 동영상 댓글 수집한 번의 요청으로 여러 동영상 URL의 공개 댓글을 수집합니다.
- 동영상별 한도와 정렬동영상별 results_limit 값을 설정하고, 최신순 또는 관련순 정렬을 선택합니다.
- 댓글 및 작성자 필드댓글 ID, 텍스트, 공개된 작성자 정보, 게시 시각, 원본 동영상 정보를 반환합니다.
- 스레드 관계구조화된 토론 분석을 위해 공개 좋아요 수, 답글 수, 상위 댓글 ID를 포함합니다.
- 크리에이터 상호작용 표시공개 결과에 채널 소유자 및 크리에이터 하트 표시가 있으면 그대로 보존합니다.
YouTube Comments API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 댓글이 공개된 YouTube 동영상 URL로, 쉼표 또는 줄바꿈으로 구분합니다. |
results_limit | 선택 | 입력 URL마다 요청할 대상 레코드의 최대 개수입니다. 양의 정수여야 하며 기본값은 100입니다. |
sort_by | 선택 | 댓글 정렬 방식입니다. 기본값은 newest이며, relevance는 YouTube의 공개 순위를 사용합니다. |
YouTube Comments API 사용 방법
최신 반응과 주목도 중 무엇이 중요한지 정하고, 동영상별 샘플링 한도를 설정하세요. 댓글을 분석 파이프라인에 넣을 때도 반환된 관계는 그대로 유지합니다.
- 공개 동영상 URL을 고르고, 최신 반응이 필요한지 YouTube가 정렬한 토론이 필요한지 정합니다.
- urls, results_limit, sort_by를 /v1/youtube/comments로 POST합니다. 한도는 모든 동영상에 각각 적용됩니다.
- /v1/tasks/{task_id}를 폴링합니다. 댓글이 활성화된 동영상과 댓글을 볼 수 없는 동영상이 같은 배치 안에서 각각 처리됩니다.
- 성공하면 댓글 ID로 중복을 제거하고, parent_comment_id로 답글을 연결하며, has_more가 true인 동안 페이지네이션합니다.
curl -X POST "https://api.socq.ai/v1/youtube/comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],"results_limit":10,"sort_by":"newest"}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50YouTube Comments API 추천 활용 사례
- 오디언스 피드백 분석: 공개 댓글 텍스트를 분석해 감성, 반복되는 질문, 주제, 콘텐츠 아이디어를 파악합니다.
- 캠페인·이벤트 모니터링: 크리에이터, 제품 출시, 캠페인, 발표, 이벤트에 대한 공개 반응을 추적합니다.
- 토론 조사: 좋아요 수, 답글 수, 상위 댓글 참조를 활용해 참여도가 높은 댓글과 활발한 스레드를 연구합니다.
- 텍스트 분석 데이터셋: 정규화된 댓글을 분류, 클러스터링, 요약, 모더레이션 보조, 알림 워크플로에 제공합니다.
YouTube Comments API 활용 팁
- 분석 전에 sort_by를 먼저 정하세요. relevance에서 newest로 바꾸면 표본 자체가 달라지므로, 두 내보내기를 순서만 다른 것처럼 비교해서는 안 됩니다.
- results_limit은 동영상별 상한으로 취급하세요. 댓글 비활성화, 모더레이션, 정렬 방식, 제한, 낮은 활동량 모두 반환 건수를 줄일 수 있습니다.
- 중복 제거에는 댓글 ID를, 연결에는 parent_comment_id를 사용하되, 보이는 모든 답글이 같은 결과 페이지에 들어 있다고 가정하지 마세요.
- 좋아요 수와 답글 수는 수집 시점의 관측값이며, 감성이나 중요도를 나타내는 고정된 척도가 아닙니다.
- 댓글 텍스트와 작성자 필드는 신뢰할 수 없는 공개 입력입니다. 화면에 표시할 때 이스케이프하고, 포함된 URL은 사용하기 전에 검증하세요.
- 키워드가 일치한다고 해서 감성 분석이 되는 것은 아닙니다. 라벨이나 요약을 적용할 때는 원문 텍스트와 출처 컨텍스트를 함께 보존하세요.
- 분석가가 어떤 대화 표본을 검토했는지 재현할 수 있도록 모든 행에 동영상 ID와 collected_at을 유지하세요.
관련 API
YouTube Comments API 외에 YouTube의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- YouTube Channel Videos API — 채널 URL에서 쇼츠와 라이브 방송을 제외한 일반 공개 동영상을 수집합니다.
- YouTube Transcripts API — 제공되는 일반 텍스트 스크립트를 가져오며, 언어를 선택할 수 있습니다.
- YouTube Channels API — 공개 채널 정보, 이미지, 인증 여부, 공개된 오디언스 통계를 가져옵니다.
- YouTube Videos API — 알고 있는 동영상 또는 쇼츠 URL의 메타데이터, 썸네일, 길이, 참여도를 가져옵니다.
- YouTube Comment Replies API — 답글 토큰으로 알고 있는 YouTube 댓글 스레드를 이어서 조회하고, 공개 답글, 작성자, 참여도, 상위 댓글 맥락을 반환합니다.
- 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