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 사용 방법
게시물 링크를 보내고 댓글을 페이지 단위로 읽어 옵니다.
- {"url": "https://www.youtube.com/post/Ugkx...", "results_limit": 100}을 /v1/youtube/community-post-comments로 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- 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를 실행하세요.
관련 API
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 Transcripts API
- YouTube Videos API
- YouTube Shorts API
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts 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