youtube/
community-post

링크로 YouTube 커뮤니티 게시물 하나를 가져와 게시물 전체 텍스트, 첨부된 모든 이미지, 좋아요 수, 게시한 채널 정보를 반환합니다.

YouTube Community Post API

게시물 URL 입력
전체 텍스트와 이미지
좋아요 수
요청당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

YouTube Community Post

커뮤니티 게시물은 크리에이터가 채널의 게시물 탭에 올리는 공지, 질문, 이미지 묶음, 링크 같은 소식으로, 자체 텍스트와 첨부 이미지, 좋아요 수를 가집니다. 게시물 전체를 확보하면 크리에이터가 남긴 말을 보관하고, 개별 소식에 대한 팬들의 반응을 측정하고, 그 게시물에 달린 댓글을 맥락 속에서 읽을 수 있습니다.

YouTube Community Post API 주요 기능

  • 두 가지 게시물 링크 지원youtube.com/post/{post_id} 링크나 ?lb={post_id}로 끝나는 채널 게시물 탭 링크를 붙여 넣으면 둘 다 같은 게시물로 확인됩니다.
  • 전체 텍스트와 모든 이미지text 필드에는 줄바꿈까지 그대로 담긴 게시물 본문 전체가, media 필드에는 첫 장만이 아니라 첨부된 이미지 전부가 들어 있습니다.
  • 좋아요 수와 게시 채널metrics.likes_count 값으로 좋아요 합계를, author 필드로 채널 ID, 핸들, 이름, URL을 확인합니다.

YouTube Community Post API 매개변수

매개변수필수설명
url필수커뮤니티 게시물 링크입니다. https://www.youtube.com/post/{post_id} 형식이나 ?lb={post_id}가 붙은 채널 게시물 탭 링크를 사용합니다.

YouTube Community Post API 사용 방법

게시물 링크 하나를 보내고 게시물 레코드를 읽어 옵니다.

  1. YouTube Community Posts 결과나 공유 링크 등에서 커뮤니티 게시물 링크를 복사합니다.
  2. {"url": "https://www.youtube.com/post/Ugkx..."}를 /v1/youtube/community-post로 POST합니다.
  3. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링한 뒤, results.items에 담긴 게시물 1건을 읽습니다.
curl -X POST "https://api.socq.ai/v1/youtube/community-post" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/post/Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8"}'

# The result is one post with text, media and metrics.likes_count.

YouTube Community Post API 추천 활용 사례

  • 크리에이터 공지 보관: 출시, 이벤트, 일정 안내 게시물의 전체 텍스트와 이미지를 저장해 두면 나중에 수정되거나 삭제되어도 기록이 남습니다.
  • 개별 소식의 반응 확인: 특정 게시물의 likes_count 값을 가져와 크리에이터의 공지, 투표, 이미지 게시물이 각각 얼마나 반응을 얻었는지 비교합니다.

YouTube Community Post API 활용 팁

  • 먼저 YouTube Community Posts로 채널의 최근 게시물 목록을 확인한 뒤, 전체 내용이 필요한 게시물에만 이 엔드포인트를 호출하세요.
  • 같은 링크로 YouTube Community Post Comments를 실행하면 게시물과 시청자 댓글을 나란히 놓고 볼 수 있습니다.

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

  • YouTube Channel Videos API — 채널 URL에서 쇼츠와 라이브 방송을 제외한 일반 공개 동영상을 수집합니다.
  • YouTube Transcripts API — 제공되는 일반 텍스트 스크립트를 가져오며, 언어를 선택할 수 있습니다.
  • YouTube Channels API — 공개 채널 정보, 이미지, 인증 여부, 공개된 오디언스 통계를 가져옵니다.
  • YouTube Videos API — 알고 있는 동영상 또는 쇼츠 URL의 메타데이터, 썸네일, 길이, 참여도를 가져옵니다.
  • YouTube Community Posts API — 채널 URL에서 공개 커뮤니티 탭 게시물을 수집하며, 텍스트, 채널 정보, 타임스탬프, 이미지 참조, 출처 맥락을 포함합니다.
  • YouTube Community Post Comments API — 커뮤니티 게시물 링크에 달린 댓글을 수집하며, 댓글 작성자 채널, 좋아요 수, 답글 수를 포함합니다.

다른 플랫폼 둘러보기

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

YouTube Community Post API — 자주 묻는 질문

YouTube Community Post API는 링크로 YouTube 커뮤니티 게시물 하나를 읽어 오는 프로그래밍 인터페이스입니다. 게시물 텍스트, 첨부 이미지, 좋아요 수, 채널 식별 정보를 반환합니다.

https://www.youtube.com/post/{post_id} 형식과, https://www.youtube.com/@channel/community?lb=Ugkx... 처럼 ?lb={post_id}가 붙은 채널 게시물 탭 링크를 모두 지원합니다.

같은 링크를 YouTube Community Post Comments에 보내면 됩니다. 댓글마다 작성자, 좋아요 수, 답글 수를 함께 반환합니다.

이 엔드포인트는 공개 게시물을 읽기만 합니다. 공식 YouTube Data API에도 커뮤니티 게시물 리소스가 없어, 읽기와 작성 모두 지원하지 않습니다.

요청 1건당 반환되는 게시물 1건에 대해 0.5 크레딧이 고정으로 차감됩니다.