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 사용 방법
채널마다 얼마나 깊이 확인할지 정한 뒤, 깔끔한 일반 동영상 목록을 수집합니다. 한 배치에 여러 채널을 담을 수 있으며, 요청한 상한은 채널마다 적용됩니다.
- 공개 채널 URL을 준비하고, 최근 샘플이면 충분한지 더 깊은 백필이 필요한지 정합니다.
- urls와 results_limit을 /v1/youtube/channel-videos로 POST합니다. 상한은 채널마다 적용된다는 점을 기억하세요.
- 목록 수집 작업이 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 반환된 항목을 채널 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=50YouTube Channel Videos API 추천 활용 사례
- 채널 콘텐츠 피드: 선택한 채널의 일반 공개 동영상으로 구조화된 피드를 만듭니다.
- 게시 현황과 성과 분석: 채널 간 게시 빈도, 길이, 주제, 공개된 참여 수치를 비교합니다.
- 크리에이터·경쟁사 모니터링: 크리에이터, 퍼블리셔, 브랜드, 경쟁사의 일반 동영상 활동을 추적합니다.
- 동영상 카탈로그 생성: 동영상 URL을 하나하나 직접 수집하지 않고도 분류, 요약, 검색, 리포트 워크플로를 채웁니다.
YouTube Channel Videos API 활용 팁
- 상한은 입력마다 곱해집니다. 채널 열 개에 results_limit 100이면 최대 1,000개의 일반 동영상 레코드를 요청합니다.
- 새 채널 세트를 처음 도입할 때는 얕게 시작해 대상 여부를 확인한 뒤, 더 깊은 이력이 필요한 곳에만 상한을 높이세요.
- 결과가 적다는 것은 채널에 조건에 맞는 공개 업로드가 적다는 뜻일 수 있으며, 작업이 실패했다는 신호는 아닙니다.
- 응답을 완전한 아카이브로 보장하는 것처럼 제시하지 마세요. 공개 가능 여부와 채널의 공개 목록은 바뀔 수 있습니다.
- 중복 제거에는 동영상 ID를 사용하고, 장기 분석을 위해 출처 채널 ID와 collected_at을 함께 보관하세요.
- 형식 구성이 중요하다면 쇼츠는 따로 실행하세요. 수집을 마친 뒤에 합쳐야 분류가 명확하게 유지됩니다.
- 채널 소개글과 수치를 모든 업로드 행에 복사하지 말고, 최신 프로필 필드는 Channels를 사용하세요.
관련 API
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 Search API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments 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