YouTube Community Posts
YouTube 커뮤니티 게시물은 채널의 커뮤니티 탭에 올라오는 공개 소식으로, 게시물 텍스트, 작성 채널 정보, 게시 시각, 공개 링크, 이미지 첨부를 담고 있습니다. 이러한 레코드는 채널 피드 목록 정리, 공지 검토, 채널 간 게시 현황 분석에 활용할 수 있습니다.
YouTube Community Posts API 주요 기능
- 여러 채널 URL 수집@handle, /channel/, /c/, /user/ 경로를 사용하는 전체 공개 채널 URL을 받으며, 선택한 결과 상한을 채널마다 독립적으로 적용합니다.
- 정규화된 게시물 레코드공개 게시물 ID, 커뮤니티 URL, 텍스트, 게시 타임스탬프, 수집 타임스탬프를 일관된 구조로 반환합니다.
- 채널-게시물 컨텍스트각 게시물을 채널 ID, 핸들, 표시 이름, 공개 채널 URL, 제출한 원본 URL과 연결된 상태로 유지합니다.
- 이미지 첨부 참조노출된 게시물 이미지를 정규화된 미디어 항목으로 매핑하여, 이미지 기반 소식도 게시물 레코드와 연결된 상태로 유지합니다.
- 상한이 있는 피드 순회채널별로 소스의 continuation 페이지를 따라가며 ID 또는 URL 기준으로 중복 게시물을 제거하고, 지정한 한도에 도달하거나 피드가 끝나거나 100페이지 상한에 이르면 멈춥니다.
YouTube Community Posts API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 필수 값인 공개 YouTube 채널 URL로, 쉼표 또는 줄바꿈으로 구분합니다. 지원하는 경로는 @handle, /channel/, /c/, /user/로 시작합니다. |
results_limit | 선택 | 입력 채널마다 수집할 커뮤니티 게시물의 최대 개수입니다. 기본값은 100이며 20~2000의 정수를 받습니다. |
YouTube Community Posts API 사용 방법
알고 있는 공개 채널을 하나 이상 비동기 작업으로 제출한 뒤, 완료 후 저장된 커뮤니티 게시물 레코드를 읽습니다.
- @handle, /channel/, /c/, /user/ 경로를 사용하는 전체 공개 YouTube 채널 URL을 준비합니다.
- urls와 20~2000 범위의 results_limit을 /v1/youtube/community-posts로 POST합니다.
- 반환된 task_id를 보관하고, 작업이 queued, running, retrying 상태인 동안 GET /v1/tasks/{task_id}를 폴링합니다.
- 성공하면 data.results.items를 읽고, data.results.has_more가 true인 동안 data.results.next_cursor를 작업 요청의 cursor로 전달합니다.
curl -X POST "https://api.socq.ai/v1/youtube/community-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/@YouTube"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass data.results.next_cursor as cursor while has_more is trueYouTube Community Posts API 추천 활용 사례
- 채널 커뮤니티 피드 목록화: 게시물 ID, URL, 텍스트, 타임스탬프, 원본 채널 컨텍스트로 선택한 공개 채널의 검토용 피드를 구성합니다.
- 공지·크리에이티브 검토: 공개 게시물 텍스트와 보존된 이미지 참조를 함께 살펴보며, 채널이 동영상 피드 밖에서 소식을 전하는 방식을 비교합니다.
- 채널 간 게시 현황 분석: 정규화된 게시물을 채널 정보와 게시 시각별로 묶어, 알고 있는 채널 집합의 커뮤니티 게시 활동을 비교합니다.
YouTube Community Posts API 활용 팁
- 지원되는 YouTube 호스트의 전체 채널 URL을 제출하세요. 동영상, 게시물, 재생목록 URL이나 URL이 아닌 단순 값은 공개 채널 입력 사양에 맞지 않아 실패합니다.
- results_limit이 모든 URL에 각각 적용되므로 여러 채널 요청은 신중하게 산정하세요. 채널 3개에 20을 지정하면 최대 60개의 저장 게시물을 요청할 수 있습니다.
- 공개 커뮤니티 탭이 없거나 보이는 피드가 더 짧은 채널은 더 적은 레코드를 반환할 수 있으므로, results_limit은 상한으로 취급하세요.
- cursor는 GET /v1/tasks/{task_id}에서만 사용하세요. 소스 continuation은 내부에서 처리되며 이 엔드포인트의 공개 요청 매개변수가 아닙니다.
- 저장한 레코드는 게시물 ID로 중복을 제거하고, 없으면 URL로 대체하세요. 여러 채널을 함께 제출할 때는 extra.input_url을 보관하세요.
- 후속 처리에 쓰기 전에 text, media, created_at을 확인하세요. 현재의 정규화 레코드에는 투표 선택지나 삽입된 동영상 첨부 메타데이터가 보존되지 않습니다.
관련 API
YouTube Community Posts API 외에 YouTube의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- YouTube Channel Videos API — 채널 URL에서 쇼츠와 라이브 방송을 제외한 일반 공개 동영상을 수집합니다.
- YouTube Transcripts API — 제공되는 일반 텍스트 스크립트를 가져오며, 언어를 선택할 수 있습니다.
- YouTube Channels API — 공개 채널 정보, 이미지, 인증 여부, 공개된 오디언스 통계를 가져옵니다.
- YouTube Videos API — 알고 있는 동영상 또는 쇼츠 URL의 메타데이터, 썸네일, 길이, 참여도를 가져옵니다.
- YouTube Community Post API — 링크로 커뮤니티 게시물 하나를 읽으며, 전체 텍스트, 첨부 이미지, 좋아요 수, 게시 채널을 포함합니다.
- 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