youtube/
comments

하나 이상의 동영상 URL에서 공개된 YouTube 댓글을 수집하고, 정규화된 텍스트, 작성자, 좋아요 수, 답글 수, 원본 동영상, 대화 컨텍스트를 반환합니다.

YouTube Comments API

댓글
토론 데이터
동영상 URL
결과당 0.3 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 사용 방법

최신 반응과 주목도 중 무엇이 중요한지 정하고, 동영상별 샘플링 한도를 설정하세요. 댓글을 분석 파이프라인에 넣을 때도 반환된 관계는 그대로 유지합니다.

  1. 공개 동영상 URL을 고르고, 최신 반응이 필요한지 YouTube가 정렬한 토론이 필요한지 정합니다.
  2. urls, results_limit, sort_by를 /v1/youtube/comments로 POST합니다. 한도는 모든 동영상에 각각 적용됩니다.
  3. /v1/tasks/{task_id}를 폴링합니다. 댓글이 활성화된 동영상과 댓글을 볼 수 없는 동영상이 같은 배치 안에서 각각 처리됩니다.
  4. 성공하면 댓글 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=50

YouTube Comments API 추천 활용 사례

  • 오디언스 피드백 분석: 공개 댓글 텍스트를 분석해 감성, 반복되는 질문, 주제, 콘텐츠 아이디어를 파악합니다.
  • 캠페인·이벤트 모니터링: 크리에이터, 제품 출시, 캠페인, 발표, 이벤트에 대한 공개 반응을 추적합니다.
  • 토론 조사: 좋아요 수, 답글 수, 상위 댓글 참조를 활용해 참여도가 높은 댓글과 활발한 스레드를 연구합니다.
  • 텍스트 분석 데이터셋: 정규화된 댓글을 분류, 클러스터링, 요약, 모더레이션 보조, 알림 워크플로에 제공합니다.

YouTube Comments API 활용 팁

  • 분석 전에 sort_by를 먼저 정하세요. relevance에서 newest로 바꾸면 표본 자체가 달라지므로, 두 내보내기를 순서만 다른 것처럼 비교해서는 안 됩니다.
  • results_limit은 동영상별 상한으로 취급하세요. 댓글 비활성화, 모더레이션, 정렬 방식, 제한, 낮은 활동량 모두 반환 건수를 줄일 수 있습니다.
  • 중복 제거에는 댓글 ID를, 연결에는 parent_comment_id를 사용하되, 보이는 모든 답글이 같은 결과 페이지에 들어 있다고 가정하지 마세요.
  • 좋아요 수와 답글 수는 수집 시점의 관측값이며, 감성이나 중요도를 나타내는 고정된 척도가 아닙니다.
  • 댓글 텍스트와 작성자 필드는 신뢰할 수 없는 공개 입력입니다. 화면에 표시할 때 이스케이프하고, 포함된 URL은 사용하기 전에 검증하세요.
  • 키워드가 일치한다고 해서 감성 분석이 되는 것은 아닙니다. 라벨이나 요약을 적용할 때는 원문 텍스트와 출처 컨텍스트를 함께 보존하세요.
  • 분석가가 어떤 대화 표본을 검토했는지 재현할 수 있도록 모든 행에 동영상 ID와 collected_at을 유지하세요.

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 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

YouTube Comments API — 자주 묻는 질문

YouTube Comments API는 하나 이상의 YouTube 동영상 URL에서 공개된 댓글을 수집합니다. 정규화된 텍스트, 작성자 정보, 게시 시각, 좋아요 수, 답글 수, 원본 동영상 참조, 상위 댓글 ID, 수집 시각을 반환합니다.

공개 YouTube 동영상 URL을 하나 이상 제출하며, 선택 항목으로 results_limit과 sort_by 값을 지정할 수 있습니다.

최신 댓글부터 받으려면 newest를, YouTube의 공개 관련순으로 받으려면 relevance를 사용합니다. 기본값은 newest입니다.

답글 레코드에는 parent_comment_id가 포함될 수 있으며, replies_count는 댓글에 연결된 공개 답글 수를 보여 줍니다.

results_limit은 동영상별 최대값입니다. 댓글이 비활성화되었거나, 필터링되었거나, 제한되었거나, 공개된 댓글이 적은 동영상은 더 적은 레코드를 반환하거나 빈 결과를 반환할 수 있습니다.

반환된 정규화 댓글 결과 1건당 0.3 크레딧이 차감됩니다.