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 사용 방법
게시물 링크 하나를 보내고 게시물 레코드를 읽어 옵니다.
- YouTube Community Posts 결과나 공유 링크 등에서 커뮤니티 게시물 링크를 복사합니다.
- {"url": "https://www.youtube.com/post/Ugkx..."}를 /v1/youtube/community-post로 POST합니다.
- 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를 실행하면 게시물과 시청자 댓글을 나란히 놓고 볼 수 있습니다.
관련 API
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 Comments API
- YouTube Shorts API
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies 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