youtube/
community-posts

채널 URL에서 공개 YouTube 커뮤니티 게시물을 수집하고, 게시물 텍스트, 채널 정보, 타임스탬프, 이미지 참조, 출처 컨텍스트를 정규화된 레코드로 반환합니다.

YouTube Community Posts API

커뮤니티 탭
채널 URL 입력
이미지 참조
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 사용 방법

알고 있는 공개 채널을 하나 이상 비동기 작업으로 제출한 뒤, 완료 후 저장된 커뮤니티 게시물 레코드를 읽습니다.

  1. @handle, /channel/, /c/, /user/ 경로를 사용하는 전체 공개 YouTube 채널 URL을 준비합니다.
  2. urls와 20~2000 범위의 results_limit을 /v1/youtube/community-posts로 POST합니다.
  3. 반환된 task_id를 보관하고, 작업이 queued, running, retrying 상태인 동안 GET /v1/tasks/{task_id}를 폴링합니다.
  4. 성공하면 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 true

YouTube 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을 확인하세요. 현재의 정규화 레코드에는 투표 선택지나 삽입된 동영상 첨부 메타데이터가 보존되지 않습니다.

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 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

YouTube Community Posts API — 자주 묻는 질문

YouTube Community Posts API는 지원되는 YouTube 채널 URL에서 공개 커뮤니티 탭 게시물을 수집하는 프로그래밍 인터페이스입니다. 게시물 ID, URL, 텍스트, 채널 정보, 타임스탬프, 이미지 참조, 원본 채널 컨텍스트를 반환합니다.

첫 번째 경로가 @handle, /channel/, /c/, /user/인 전체 youtube.com 채널 URL을 사용하세요. 동영상, 게시물, 재생목록, 다른 호스트의 URL은 채널 입력으로 허용되지 않습니다.

results_limit은 기본값이 100이고 20~2000의 정수를 받으며, 제출한 채널 URL마다 따로 적용됩니다. 따라서 채널 2개에 100을 지정하면 최대 200개의 저장 게시물 레코드를 요청할 수 있습니다.

레코드에는 게시물 ID와 URL, 공개 텍스트, 채널 ID·핸들·이름·URL, 정규화된 카운터 필드, 보존된 이미지 참조, 게시 시각과 수집 시각, extra.input_url이 포함될 수 있습니다.

노출된 이미지는 정규화된 미디어 참조로 보존될 수 있습니다. 현재의 응답 스키마에는 투표 선택지, 득표율, 삽입된 동영상 첨부 상세가 보존되지 않습니다.

아니요. 공개 커뮤니티 게시물 레코드만 반환하며, 그 아래의 댓글 스레드는 펼치지 않습니다.

채널에 공개 커뮤니티 탭이 없거나, 보이는 피드가 results_limit보다 먼저 끝나거나, 게시물이 삭제·멤버 전용·비공개이거나 로그인이 필요한 상태일 수 있습니다.

아니요. 수집기가 채널마다 소스 continuation 토큰을 내부에서 따라갑니다. 성공한 작업이 반환하는 cursor는 그 작업에 이미 저장된 정규화 레코드를 페이지 단위로 넘길 뿐입니다.

저장된 정규화 게시물 1건당 0.5 크레딧입니다. 초기 예상 금액은 채널별 results_limit에 제출한 URL 수를 곱해 계산하고, 최종 요금은 실제로 저장된 레코드 수에 따라 부과됩니다.