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 사용 방법
필요하면 결과 수를 지정해 보내고, 작업이 끝나면 쇼츠를 읽어 옵니다.
- {"results_limit": 48}을 /v1/youtube/trending-shorts로 POST합니다. 본문은 비워 두어도 됩니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- 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에 보내세요.
관련 API
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 Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos 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