youtube/
channel-live-videos

YouTube 채널의 라이브 탭에서 공개 방송을 수집하며, 정규화된 동영상 메타데이터, 채널 정보, 썸네일, 게시 정보, 공개된 참여 수치를 제공합니다.

YouTube Channel Live Videos API

채널 라이브 탭
공개 방송
비동기 수집
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

YouTube Channel Live Videos

YouTube 채널 라이브 동영상은 특정 채널의 라이브 탭에 노출된 공개 방송 항목으로, 동영상 식별 정보, 채널 정보, 썸네일, 타임스탬프, 공개된 참여 수치를 담고 있습니다. YouTube가 해당 채널에 노출하는 내용에 따라 진행 중, 예정, 지난 방송이 포함될 수 있으며, 정규화된 라이브 상태 표기는 보장되지 않습니다.

YouTube Channel Live Videos API 주요 기능

  • 정식 채널 URL 지원공개 /@handle, /channel/{id}, /c/{name}, /user/{name} 형식의 YouTube URL을 인식합니다.
  • 채널 라이브 탭 탐색제출한 각 채널의 라이브 탭에 노출된 방송 항목을 수집합니다.
  • 채널별 수집 깊이입력한 채널마다 20~2,000개의 레코드를 요청할 수 있으며, 기본값은 100입니다.
  • 정규화된 방송 레코드동영상 식별 정보, 제목, 설명, 채널, 썸네일, 길이, 해시태그, 게시 시각, 출처 정보를 확인 가능한 범위에서 반환합니다.
  • 공개된 참여 수치 스냅샷공개된 조회수, 좋아요 수, 댓글 수를 collected_at과 함께 기록해 특정 시점 분석에 활용합니다.
  • 비동기 결과 전달작업 상태를 폴링하고 작업 ID를 보관하며, 커서 페이지네이션으로 안정적으로 결과를 받아 옵니다.

YouTube Channel Live Videos API 매개변수

매개변수필수설명
urls필수쉼표나 줄바꿈으로 구분한 공개 YouTube 채널 URL입니다. 지원되는 경로는 /@handle, /channel/{id}, /c/{name}, /user/{name}입니다.
results_limit선택채널 URL마다 요청할 최대 레코드 수입니다. 20부터 2,000까지의 정수여야 하며 기본값은 100입니다.

YouTube Channel Live Videos API 사용 방법

정식 공개 채널 URL을 제출하고 채널마다 수집 깊이를 정합니다. 요청하면 비동기 작업이 생성되므로, 완료 확인과 결과 조회는 별개의 단계입니다.

  1. 지원되는 핸들, 채널 ID, 사용자 지정 이름, 사용자 경로 중 하나를 사용한 공개 YouTube 채널 URL을 하나 이상 준비합니다.
  2. urls와 results_limit을 /v1/youtube/channel-live-videos로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. /v1/tasks/{task_id}?limit=50에서 결과 페이지를 읽고, has_more가 true인 동안 next_cursor를 cursor로 다시 전달합니다.
curl -X POST "https://api.socq.ai/v1/youtube/channel-live-videos" \
  -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 GET /v1/tasks/{task_id}?limit=50&cursor={next_cursor}

YouTube Channel Live Videos API 추천 활용 사례

  • 방송 목록 구축: 선택한 채널과 연결된 공개 방송의 구조화된 목록을 만듭니다.
  • 라이브 방송 편성 조사: 정기적으로 라이브 방송을 운영하는 채널들의 제목, 시간대, 길이, 게시 패턴을 비교합니다.
  • 크리에이터 방송 모니터링: 크리에이터, 브랜드, 퍼블리셔, 경쟁사 채널의 라이브 탭에 어떤 공개 방송 레코드가 노출되는지 추적합니다.
  • 방송 종료 후 성과 스냅샷: 공개된 조회수, 좋아요 수, 댓글 수를 수집 시각과 함께 저장해 이후 추세 비교에 사용합니다.
  • 공개 미디어 카탈로그 보강: 정규화된 방송 메타데이터와 출처 채널 정보를 검색, 리포트, 분류 시스템에 추가합니다.

YouTube Channel Live Videos API 활용 팁

  • results_limit은 모든 채널에 적용됩니다. URL 다섯 개에 상한 100이면 작업 전체의 중복 제거 전 기준으로 최대 500개의 레코드를 요청합니다.
  • 핸들, 채널 ID, 사용자 지정 이름, 사용자 이름이 비어 있지 않은 정식 채널 URL을 사용하세요. /channel만 있는 경로로는 출처를 확인할 수 없습니다.
  • 채널 라이브 탭을 대상 범위의 기준으로 보세요. 진행 중, 예정, 지난 방송의 노출 여부는 수집 시점마다 달라질 수 있습니다.
  • 정규화된 페이로드에는 전용 라이브 상태 필드가 없으므로, type이나 extra.content_type으로 진행 중·예정·지난 방송 상태를 신뢰할 수 있게 판단하려 하지 마세요.
  • 응답에는 메타데이터와 썸네일 참조만 있으며, 라이브 채팅, 재생 가능한 스트림 URL, 자막, 스크립트 텍스트는 들어 있지 않습니다.
  • 동등한 채널 입력이 같은 동영상을 찾아낼 수 있습니다. 저장된 작업 결과는 정규화된 동영상 ID로, ID가 없으면 URL로 중복이 제거됩니다.
  • 작업 결과의 limit은 results_limit과 별개입니다. 페이지당 저장된 행을 1~500개로 요청하고, has_more가 false가 될 때까지 불투명한 next_cursor를 계속 사용하세요.
  • 공개 메타데이터가 있어도 비공개나 멤버십 전용 영상을 볼 수 있게 되는 것은 아닙니다. 원본이 해당 분류를 알려 주면 extra.is_members_only를 보존하세요.

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

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

다른 플랫폼 둘러보기

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

YouTube Channel Live Videos API — 자주 묻는 질문

YouTube Channel Live Videos API는 하나 이상의 YouTube 채널 라이브 탭에 노출된 공개 방송 레코드를 정규화해 수집합니다. 동영상과 채널 식별 정보, 설명 메타데이터, 썸네일, 타임스탬프, 공개된 참여 수치, 입력 정보, 수집 시각을 확인 가능한 범위에서 반환합니다.

/@handle, /channel/{id}, /c/{name}, /user/{name} 중 하나를 사용한 공개 youtube.com URL을 사용하세요. 식별자 부분은 비어 있으면 안 됩니다.

아니요. 대상이 되는 채널 라이브 탭에는 진행 중, 예정, 지난 방송이 노출될 수 있으며, 노출 여부는 채널과 수집 시점에 따라 달라질 수 있습니다.

아니요. extra.content_type은 있으면 원본의 분류를 보존할 수 있지만, 진행 중·예정·지난 방송을 나타내는 전용 상태를 신뢰할 수 있게 대체하지는 못합니다.

results_limit의 기본값은 100이고 20부터 2,000까지 받으며, 제출한 채널 URL마다 따로 적용됩니다. 채널의 노출 여부와 작업 전체의 동영상 중복 제거 때문에 실제 저장되는 행은 더 적을 수 있습니다.

아니요. 이 엔드포인트는 공개 방송 메타데이터와 썸네일 참조를 반환하며, 라이브 채팅 메시지, 재생 가능한 스트림 파일, 자막, 스크립트는 반환하지 않습니다.

요청 시 채널 URL 수에 results_limit을 곱해 예상 금액을 계산하고, 저장된 정규화 결과 하나당 0.5 크레딧으로 정산합니다. 설정된 기본 요금이 0이므로 결과가 없으면 결과 요금은 없습니다.