youtube/
shorts

YouTube 채널 URL에서 공개 쇼츠를 수집하고, 정규화된 제목, 채널 컨텍스트, 썸네일, 재생 시간, 게시 정보, 공개된 참여 지표를 반환합니다.

YouTube Shorts API

쇼츠
채널 탐색
공개 지표
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

YouTube Shorts

YouTube 쇼츠는 제목, 채널 컨텍스트, 썸네일, 재생 시간, 게시 정보, 출처 분류, 공개된 참여 지표를 가진 숏폼 동영상입니다. 이러한 콘텐츠 및 성과 신호는 포맷 조사, 크리에이터 비교, 트렌드 모니터링, 캠페인 분석에 활용할 수 있습니다.

YouTube Shorts API 주요 기능

  • 여러 채널 쇼츠 수집한 번의 요청으로 여러 채널 URL의 공개 쇼츠를 수집합니다.
  • 채널별 결과 한도입력 채널마다 results_limit 값을 따로 설정하며, 기본값은 100입니다.
  • 정규화된 쇼츠 메타데이터정규화된 쇼츠 식별 정보, 콘텐츠 메타데이터, 썸네일, 재생 시간, 게시일, 게시 채널을 반환합니다.
  • 특정 시점의 참여 지표공개된 조회수·좋아요 수·댓글 수를 collected_at과 함께 포함하여 이후 비교에 쓸 수 있습니다.
  • 플랫폼 고유의 쇼츠 범위재생 시간이나 화면 방향만으로 숏폼 콘텐츠를 정의하지 않고 YouTube의 쇼츠 분류를 따릅니다.

YouTube Shorts API 매개변수

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

YouTube Shorts API 사용 방법

알고 있는 채널 집합에서 깔끔한 숏폼 스트림을 만듭니다. 이 작업은 플랫폼의 분류와, 나중에 적용할 수 있는 자체 포맷 규칙을 구분해서 다룹니다.

  1. 공개 채널 URL을 준비합니다. 개별 쇼츠 URL을 직접 조회해야 한다면 Videos를 사용하세요.
  2. urls와 results_limit을 /v1/youtube/shorts로 POST하되, 한도가 모든 채널에 적용된다는 점을 고려합니다.
  3. 채널 인벤토리 수집이 끝날 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 쇼츠 ID 기준으로 결과를 색인하고, 채널 및 수집 컨텍스트를 유지하며, has_more가 true인 동안 페이지네이션합니다.
curl -X POST "https://api.socq.ai/v1/youtube/shorts" \
  -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 Shorts API 추천 활용 사례

  • 숏폼 활동 모니터링: 선택한 크리에이터, 브랜드, 퍼블리셔, 경쟁사가 게시한 공개 쇼츠를 추적합니다.
  • 쇼츠 성과 비교: 선택한 채널 간의 게시 빈도, 재생 시간, 조회수, 좋아요 수, 댓글 수를 비교합니다.
  • 숏폼 콘텐츠 카탈로그: 내부 검색, 검토, 보고용으로 공개 쇼츠의 정규화된 컬렉션을 구축합니다.
  • 주제·트렌드 분석: 제목, 설명, 해시태그, 채널 데이터, 공개 지표를 분류나 조사 워크플로에 활용합니다.

YouTube Shorts API 활용 팁

  • 범용 재생 시간 기준으로 결과를 다시 분류하지 마세요. 이 엔드포인트의 사양은 YouTube의 공개 포맷 분류입니다.
  • 한도는 채널별 상한이며 보장값이 아닙니다. 적격한 공개 쇼츠가 적거나 없는 채널도 있습니다.
  • 중복 제거에는 반환된 ID를 사용하세요. 시스템의 다른 곳에서는 같은 항목이 서로 다른 공개 URL 형태로 나타날 수 있습니다.
  • 쇼츠의 공개 카운터는 게시 직후 빠르게 변할 수 있으므로 metrics와 함께 collected_at을 보관하세요.
  • 이 엔드포인트는 키워드로 검색하지 않습니다. 주제 탐색은 Search에서 시작하고, 필요하면 알게 된 쇼츠 URL을 Videos로 넘기세요.
  • 숏폼과 일반 게시를 깔끔하게 비교하려면 Channel Videos를 별도로 수집하세요.
  • 변할 수 있는 채널 메타데이터를 모든 항목에 반복해서 넣지 말고, 프로필·오디언스 필드는 채널 ID로 Channels와 조인하세요.

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

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

다른 플랫폼 둘러보기

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

YouTube Shorts API — 자주 묻는 질문

YouTube Shorts API는 하나 이상의 YouTube 채널 URL에서 공개적으로 접근할 수 있는 쇼츠를 수집합니다. 정규화된 제목, 채널 정보, 썸네일, 재생 시간, 게시일, 참여 지표, 수집 시각을 반환합니다.

공개 YouTube 채널 URL을 하나 이상 제출하며, 선택 항목으로 results_limit을 지정할 수 있습니다.

고정된 재생 시간이나 화면 비율 규칙만 쓰지 않고 YouTube의 쇼츠 분류를 따릅니다.

results_limit의 기본값은 100이며 채널 URL마다 따로 적용됩니다. 채널에 적격한 공개 쇼츠가 더 적으면 최종 개수가 더 낮을 수 있습니다.

아니요. 조회수, 좋아요 수, 댓글 수는 수집 시점에 관측한 공개 값입니다. 과거 추이를 비교하려면 반복 수집이 필요합니다.

반환된 정규화 쇼츠 결과 1건당 0.5 크레딧이 차감됩니다.