youtube/
channel-videos

YouTube 채널 URL에서 일반 공개 동영상을 수집하며, 정규화된 제목, 썸네일, 길이, 게시 정보, 채널 정보, 참여 수치를 반환합니다.

YouTube Channel Videos API

채널 동영상
일반 업로드
공개 수치
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

YouTube Channel Videos

YouTube 채널 동영상은 특정 채널의 일반 업로드 영상으로, 제목, 설명, 썸네일, 길이, 게시 정보, 공개된 참여 수치를 담고 있습니다. 이러한 레코드는 채널 카탈로그 구축, 게시 현황 분석, 콘텐츠 모니터링, 이력 리포트에 활용할 수 있습니다.

YouTube Channel Videos API 주요 기능

  • 여러 채널의 동영상 수집한 번의 요청으로 여러 채널 URL에서 일반 공개 동영상을 수집합니다.
  • 채널별 결과 수 제한입력한 채널마다 results_limit을 따로 설정할 수 있으며, 기본값은 100입니다.
  • 정규화된 동영상 메타데이터정규화된 동영상 식별 정보, 콘텐츠 메타데이터, 썸네일, 길이, 게시일, 게시 채널을 반환합니다.
  • 특정 시점의 참여 수치공개된 조회수, 좋아요 수, 댓글 수를 collected_at과 함께 포함해 이후 비교에 사용할 수 있습니다.
  • 일반 동영상 범위쇼츠와 라이브 스트림은 제외해, 결과가 일반 채널 동영상에 집중되도록 합니다.

YouTube Channel Videos API 매개변수

매개변수필수설명
urls필수쉼표나 줄바꿈으로 구분한 공개 YouTube 채널 URL입니다.
results_limit선택입력 URL마다 요청할 조건에 맞는 최대 레코드 수입니다. 양의 정수여야 하며 기본값은 100입니다.

YouTube Channel Videos API 사용 방법

채널마다 얼마나 깊이 확인할지 정한 뒤, 깔끔한 일반 동영상 목록을 수집합니다. 한 배치에 여러 채널을 담을 수 있으며, 요청한 상한은 채널마다 적용됩니다.

  1. 공개 채널 URL을 준비하고, 최근 샘플이면 충분한지 더 깊은 백필이 필요한지 정합니다.
  2. urls와 results_limit을 /v1/youtube/channel-videos로 POST합니다. 상한은 채널마다 적용된다는 점을 기억하세요.
  3. 목록 수집 작업이 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 반환된 항목을 채널 ID별로 묶고, 동영상 ID로 중복을 제거하며, has_more가 true인 동안 페이지를 넘깁니다.
curl -X POST "https://api.socq.ai/v1/youtube/channel-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@NASA"],"results_limit":10}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

YouTube Channel Videos API 추천 활용 사례

  • 채널 콘텐츠 피드: 선택한 채널의 일반 공개 동영상으로 구조화된 피드를 만듭니다.
  • 게시 현황과 성과 분석: 채널 간 게시 빈도, 길이, 주제, 공개된 참여 수치를 비교합니다.
  • 크리에이터·경쟁사 모니터링: 크리에이터, 퍼블리셔, 브랜드, 경쟁사의 일반 동영상 활동을 추적합니다.
  • 동영상 카탈로그 생성: 동영상 URL을 하나하나 직접 수집하지 않고도 분류, 요약, 검색, 리포트 워크플로를 채웁니다.

YouTube Channel Videos API 활용 팁

  • 상한은 입력마다 곱해집니다. 채널 열 개에 results_limit 100이면 최대 1,000개의 일반 동영상 레코드를 요청합니다.
  • 새 채널 세트를 처음 도입할 때는 얕게 시작해 대상 여부를 확인한 뒤, 더 깊은 이력이 필요한 곳에만 상한을 높이세요.
  • 결과가 적다는 것은 채널에 조건에 맞는 공개 업로드가 적다는 뜻일 수 있으며, 작업이 실패했다는 신호는 아닙니다.
  • 응답을 완전한 아카이브로 보장하는 것처럼 제시하지 마세요. 공개 가능 여부와 채널의 공개 목록은 바뀔 수 있습니다.
  • 중복 제거에는 동영상 ID를 사용하고, 장기 분석을 위해 출처 채널 ID와 collected_at을 함께 보관하세요.
  • 형식 구성이 중요하다면 쇼츠는 따로 실행하세요. 수집을 마친 뒤에 합쳐야 분류가 명확하게 유지됩니다.
  • 채널 소개글과 수치를 모든 업로드 행에 복사하지 말고, 최신 프로필 필드는 Channels를 사용하세요.

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

  • YouTube Comments API — 공개 댓글, 작성자, 참여도, 원본 동영상, 대화 맥락을 수집합니다.
  • YouTube Transcripts API — 제공되는 일반 텍스트 스크립트를 가져오며, 언어를 선택할 수 있습니다.
  • YouTube Channels API — 공개 채널 정보, 이미지, 인증 여부, 공개된 오디언스 통계를 가져옵니다.
  • YouTube Videos API — 알고 있는 동영상 또는 쇼츠 URL의 메타데이터, 썸네일, 길이, 참여도를 가져옵니다.
  • YouTube Shorts API — 채널별로 공개 쇼츠, 썸네일, 길이, 게시 정보, 참여도를 수집합니다.
  • YouTube Channel Live Videos API — 채널의 라이브 영역에 노출된 공개 방송 기록을 수집하며, 출처 맥락과 공개된 지표를 포함합니다.

다른 플랫폼 둘러보기

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

YouTube Channel Videos API — 자주 묻는 질문

YouTube Channel Videos API는 하나 이상의 YouTube 채널 URL에서 일반 공개 동영상을 수집합니다. 정규화된 제목, 설명, 채널 정보, 썸네일, 길이, 게시일, 참여 수치, 수집 시각을 반환합니다.

공개 YouTube 채널 URL을 하나 이상 제출하고, 선택 사항으로 results_limit을 지정합니다.

results_limit의 기본값은 100이며 채널 URL마다 따로 적용됩니다. 채널에 조건에 맞는 일반 공개 동영상이 적으면 최종 개수는 더 적을 수 있습니다.

아니요. 이 엔드포인트는 일반 채널 동영상을 반환합니다. 채널의 쇼츠는 Shorts를 사용하세요.

아니요. 조회수, 좋아요 수, 댓글 수는 수집 시점에 확인한 공개 값입니다. 이력 비교를 만들려면 반복 수집이 필요합니다.

반환된 정규화 동영상 결과 하나당 0.5 크레딧이 사용됩니다.