youtube/
trending-shorts

입력 없이 지금 YouTube에서 인기 있는 쇼츠를 표본으로 가져와 제목, 채널, 조회수, 좋아요 수, 댓글 수, 재생 시간, 정확한 게시 시각을 반환합니다.

YouTube Trending Shorts API

입력 불필요
실행마다 새 표본
조회수·좋아요·댓글
결과당 0.5 크레딧
준비됨
README

SocQ 작성 · 업데이트

YouTube Trending Shorts

인기 쇼츠는 YouTube가 지금 많은 시청자에게 밀어 주고 있는 세로형 동영상으로, 각각 제목, 올린 채널, 조회수·좋아요 수·댓글 수, 길이, 정확한 게시 시각을 가지고 있습니다. 이 신호들을 함께 읽으면 어떤 주제, 형식, 크리에이터가 급부상하는지, 그리고 쇼츠가 게시된 뒤 얼마나 빠르게 조회수를 모으는지 알 수 있습니다.

YouTube Trending Shorts API 주요 기능

  • 인기 풀에서 바로 가져오기입력할 값이 없습니다. 실행할 때마다 YouTube가 그 시점에 밀어 주는 쇼츠를 한 번에 48개 안팎으로 뽑고, 여러 번 뽑은 결과를 중복 없이 합쳐 results_limit 값까지 채웁니다.
  • 쇼츠마다 세 가지 참여 지표metrics 필드에는 정확한 조회수와 좋아요 수, YouTube에 표시된 댓글 수가 담겨 있어, 토론이 활발한 쇼츠와 시청만 많은 쇼츠를 구분할 수 있습니다.
  • 모든 쇼츠에 채널 정보author 필드에 채널 ID, 핸들, 이름, URL, 아바타가 담겨 있어 채널 단위 API에 바로 넘길 수 있습니다.
  • 게시 시각과 길이published_at 값은 UTC 기준의 정확한 업로드 시각, duration_seconds 값은 재생 시간으로, 두 값을 함께 보면 인기 쇼츠가 얼마나 최신이고 얼마나 긴지 알 수 있습니다.
  • 캡션에서 뽑은 해시태그제목이나 설명에 쓰인 태그가 앞의 # 없이 hashtags 목록에 정리됩니다.

YouTube Trending Shorts API 매개변수

매개변수필수설명
results_limit선택반환할 인기 쇼츠 수로, 1~200 사이에서 지정합니다. 기본값은 48입니다.

YouTube Trending Shorts API 사용 방법

필요하면 결과 수를 지정해 보내고, 작업이 끝나면 쇼츠를 읽어 옵니다.

  1. {"results_limit": 48}을 /v1/youtube/trending-shorts로 POST합니다. 본문은 비워 두어도 됩니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. results.items에서 쇼츠를 읽고, has_more가 true인 동안 results.next_cursor로 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/youtube/trending-shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"results_limit":48}'

# Each item is one Short with metrics.views_count and author.
# Read them from GET /v1/tasks/{task_id}.

YouTube Trending Shorts API 추천 활용 사례

  • 일일 트렌드 스냅샷: 정해진 시각에 엔드포인트를 실행하고 배치마다 저장해, 인기 쇼츠에 어떤 주제와 형식이 계속 등장하는지 확인합니다.
  • 급부상 크리에이터 발견: views_count와 published_at 값을 비교해, 새로 올린 영상이 며칠 만에 수백만 조회수를 모으는 채널을 찾습니다.
  • 쇼츠 해시태그 관찰: 인기 쇼츠 전체의 해시태그를 집계해, 이번 주 화제가 된 숏폼 동영상에 어떤 태그가 함께 쓰이는지 살펴봅니다.

YouTube Trending Shorts API 활용 팁

  • 실행할 때마다 새 표본이 나오므로, 저장하는 쇼츠마다 id 값을 보관하고 몇 분 간격으로 실행한 결과를 합칠 때 중복을 건너뛰세요.
  • views_count 값을 published_at 이후 경과 시간으로 나누면, 총조회수가 아니라 조회수 증가 속도로 쇼츠 순위를 매길 수 있습니다.
  • 구독자 수와 채널 설명도 필요하다면 author.url 값을 YouTube Channels에 보내세요.

YouTube Trending Shorts 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 Trending Shorts API — 자주 묻는 질문

YouTube Trending Shorts API는 검색어 입력 없이 YouTube가 현재 인기 콘텐츠로 밀어 주는 쇼츠를 표본으로 가져오는 프로그래밍 인터페이스입니다. 쇼츠마다 제목, 채널, 조회수·좋아요 수·댓글 수, 재생 시간, 게시 시각을 반환합니다.

실행할 때마다 인기 풀에서 새 표본을 뽑기 때문에, 몇 분 간격으로 실행한 결과도 겹치는 쇼츠는 몇 개뿐입니다. 여러 번 예약 실행하고 id 기준으로 합치면 인기 흐름을 더 넓게 볼 수 있습니다.

results_limit 값을 1~200 사이에서 자유롭게 지정할 수 있으며, 기본값은 인기 풀에서 한 번 뽑는 분량 정도인 48입니다.

조회수와 좋아요 수는 정확합니다. views_count와 likes_count는 쇼츠마다 가져온 전체 정수값입니다. comments_count는 YouTube에 표시된 수치를 따르므로 1,000을 넘으면 4.8K가 4800이 되는 식으로 반올림되며, 크리에이터가 숨긴 좋아요 수나 댓글 수는 null입니다.

국가 매개변수는 없습니다. 실행할 때마다 그 시점 인기 풀에 있는 쇼츠를 반환하므로, 풀의 변화를 추적하려면 예약 실행 후 id 기준으로 합치세요.

반환된 쇼츠 1개당 0.5 크레딧이 차감되므로, 기본값인 쇼츠 48개는 24 크레딧입니다.