youtube/
community-post-comments

링크로 YouTube 커뮤니티 게시물에 달린 댓글을 수집해 댓글 텍스트, 작성자 채널, 좋아요 수, 답글 수, 각 댓글로 바로 가는 링크를 반환합니다.

YouTube Community Post Comments API

게시물 URL 입력
최대 1,000개 댓글
좋아요·답글 수
결과당 0.3 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

YouTube Community Post Comments

커뮤니티 게시물 댓글은 팬들이 크리에이터의 게시물 탭 소식 아래에 남기는 반응으로, 댓글마다 텍스트, 작성자 채널, 좋아요 수, 이어진 답글 수가 있습니다. 이 대화는 동영상 댓글과 따로 모이기 때문에, 업로드 사이사이 올라오는 투표, 공지, 비하인드 게시물에 시청자가 어떻게 반응하는지 보여 줍니다.

YouTube Community Post Comments API 주요 기능

  • 게시물 링크로 댓글 수집게시물의 /post/ 링크나 ?lb=가 붙은 게시물 탭 링크를 보내면, results_limit 값(최대 1,000)에 도달할 때까지 댓글을 차례로 가져옵니다.
  • 모든 행에 작성자 채널 정보author 필드에 댓글 작성자의 채널 ID, 핸들, 채널 URL, 아바타, 인증 여부가 담깁니다.
  • 좋아요 수와 스레드 규모metrics.likes_count와 metrics.replies_count 값으로 어떤 댓글이 공감을 얻었고 어떤 댓글이 토론을 열었는지 알 수 있습니다.
  • 댓글로 바로 연결되는 링크각 url은 해당 댓글이 강조된 상태로 게시물을 열고, post_id 값으로 행을 원래 게시물과 연결합니다.

YouTube Community Post Comments API 매개변수

매개변수필수설명
url필수커뮤니티 게시물 링크입니다. https://www.youtube.com/post/{post_id} 형식이나 ?lb={post_id}가 붙은 채널 게시물 탭 링크를 사용합니다.
results_limit선택반환할 댓글 수로, 1~1,000 사이에서 지정합니다. 기본값은 100입니다.

YouTube Community Post Comments API 사용 방법

게시물 링크를 보내고 댓글을 페이지 단위로 읽어 옵니다.

  1. {"url": "https://www.youtube.com/post/Ugkx...", "results_limit": 100}을 /v1/youtube/community-post-comments로 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. results.items에서 댓글을 읽고, has_more가 true인 동안 results.next_cursor 값을 넘겨 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/youtube/community-post-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ","results_limit":100}'

# Each item is one comment with author, metrics.likes_count and metrics.replies_count.

YouTube Community Post Comments API 추천 활용 사례

  • 투표·공지에 대한 의견 읽기: 크리에이터의 투표나 출시 게시물에 달린 댓글 텍스트를 가져와, 투표 수만으로는 알 수 없는 팬들의 실제 의견을 확인합니다.
  • 열성 팬 찾기: 채널의 여러 게시물에서 수집한 댓글을 author.id 기준으로 묶어 반복해서 등장하는 시청자를 파악합니다.
  • 주목할 댓글 골라내기: likes_count와 replies_count 기준으로 정렬해 커뮤니티가 지지했거나 논쟁을 벌인 댓글을 추려 냅니다.

YouTube Community Post Comments API 활용 팁

  • 댓글이 수천 개인 게시물은 results_limit 값을 적당히 잡아 시작하고, 첫 배치가 쓸모 있을 때만 늘리세요.
  • 댓글 id 값을 저장해 두고, 나중에 같은 게시물을 다시 수집할 때 중복을 제거하세요.
  • 댓글과 함께 게시물 텍스트가 필요하다면 같은 링크로 YouTube Community Post를 실행하세요.

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

  • YouTube Channel Videos API — 채널 URL에서 쇼츠와 라이브 방송을 제외한 일반 공개 동영상을 수집합니다.
  • YouTube Comments API — 공개 댓글, 작성자, 참여도, 원본 동영상, 대화 맥락을 수집합니다.
  • YouTube Channels API — 공개 채널 정보, 이미지, 인증 여부, 공개된 오디언스 통계를 가져옵니다.
  • YouTube Comment Replies API — 답글 토큰으로 알고 있는 YouTube 댓글 스레드를 이어서 조회하고, 공개 답글, 작성자, 참여도, 상위 댓글 맥락을 반환합니다.
  • YouTube Community Posts API — 채널 URL에서 공개 커뮤니티 탭 게시물을 수집하며, 텍스트, 채널 정보, 타임스탬프, 이미지 참조, 출처 맥락을 포함합니다.
  • YouTube Community Post API — 링크로 커뮤니티 게시물 하나를 읽으며, 전체 텍스트, 첨부 이미지, 좋아요 수, 게시 채널을 포함합니다.

다른 플랫폼 둘러보기

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

YouTube Community Post Comments API — 자주 묻는 질문

YouTube Community Post Comments API는 게시물 링크로 YouTube 커뮤니티 게시물에 달린 댓글을 수집하는 프로그래밍 인터페이스입니다. 댓글 텍스트, 작성자 채널, 좋아요 수, 답글 수를 반환합니다.

results_limit 값으로 작업당 최대 1,000개까지 수집할 수 있으며, 기본값은 100입니다. 댓글이 그보다 적은 게시물은 전체 댓글을 반환합니다.

이 엔드포인트는 커뮤니티 게시물 댓글만 읽습니다. 동영상 댓글이 필요하면 동영상 URL로 YouTube Comments를 사용하세요.

반환된 댓글 1건당 0.3 크레딧이 차감되므로, 기본값인 댓글 100개는 30 크레딧입니다.