youtube/
trending-videos

뉴스, 게임, 스포츠 등 카테고리와 국가를 고르면 해당 카테고리의 인기 급상승 페이지에 오른 동영상을 순위대로 반환하고, 채널, 조회수, 길이, 썸네일도 함께 제공합니다.

YouTube Trending Videos API

7개 카테고리
원하는 국가 지정
순위대로 정렬
결과당 0.5 크레딧
준비됨
README

SocQ 작성 · 업데이트

YouTube Trending Videos

YouTube의 카테고리별 인기 급상승 페이지는 뉴스, 게임, 스포츠 같은 카테고리에서 국가마다 많은 관심을 모으는 동영상을 순위로 보여 주며, 동영상마다 순위, 채널, 조회수, 길이, 업로드 후 지난 시간이 표시됩니다. 이 순위를 꾸준히 따라가면 한 시장에서 어떤 뉴스와 게임, 크리에이터가 떠오르고 있는지, 그리고 동영상이 얼마나 빨리 순위에 오르고 또 빠지는지 알 수 있습니다.

YouTube Trending Videos API 주요 기능

  • 7개 카테고리 인기 급상승 페이지category 값으로 news, gaming, sports, learning, courses, fashion, shopping 중 하나의 인기 급상승 페이지를 고르므로, 작업마다 해당 카테고리 시청자가 보는 목록을 그대로 따라갑니다.
  • 두 글자 국가 코드로 국가 지정region 값에 US, GB, JP, BR 같은 코드를 넣으면 그 나라 버전의 페이지를 반환합니다. 같은 카테고리라도 나라마다 오르는 동영상이 다른 경우가 많습니다.
  • 동영상마다 기록되는 순위rank 값은 1부터 시작하는 각 동영상의 순위를 category, region 값과 함께 기록하므로, 여러 목록을 한 표에 합쳐도 행마다 의미가 분명합니다.
  • 인기 급상승 동영상의 채널 정보author 값에는 채널 ID, 이름, @핸들, 링크, 프로필 이미지, 인증 배지가 들어 있어 따로 조회하지 않아도 인기 급상승 동영상을 채널별로 묶을 수 있습니다.
  • 조회수, 길이, 썸네일metrics.views_count, duration_seconds, thumbnail_url, 그리고 text 필드의 설명 일부가 인기 급상승 페이지에 보이는 모습 그대로 각 동영상을 보여 줍니다.

YouTube Trending Videos API 매개변수

매개변수필수설명
category필수읽어 올 인기 급상승 페이지입니다. news, gaming, sports, learning, courses, fashion, shopping 중 하나를 지정합니다.
region선택인기 급상승 페이지의 국가를 나타내는 두 글자 코드입니다. US, GB, JP 등을 쓸 수 있으며 기본값은 US입니다.
results_limit선택목록 상단부터 반환할 동영상 수로, 1~50 사이에서 지정합니다. 기본값은 50입니다.

YouTube Trending Videos API 사용 방법

카테고리와 국가를 골라 YouTube Trending Videos API로 보내고, 완료된 작업에서 순위 목록을 읽습니다.

  1. {"category": "news", "region": "US", "results_limit": 50}을 /v1/youtube/trending-videos로 POST하고 task_id 값을 보관합니다.
  2. status가 succeeded가 될 때까지 몇 초 간격으로 GET /v1/tasks/{task_id}를 호출합니다.
  3. results.items에서 rank 순서대로 동영상을 읽습니다. results.has_more 값이 true이면 results.next_cursor 값을 넘겨 다음 페이지를 불러옵니다.
curl -X POST "https://api.socq.ai/v1/youtube/trending-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"gaming","region":"GB","results_limit":10}'

# The response contains a task_id.
# GET /v1/tasks/{task_id} returns the ranked videos once status is succeeded.

YouTube Trending Videos API 추천 활용 사례

  • 시장별 아침 트렌드 브리핑: 매일 아침 한 나라의 뉴스와 스포츠 페이지를 가져와 떠오르는 제목, 채널, 조회수를 순위대로 편집팀에 전달합니다.
  • 게임 분야 인기 흐름 추적: 콘텐츠를 내보내는 여러 나라에서 게임 페이지를 따라가며, 영상이나 캠페인을 기획하기 전에 뜨고 있는 게임, 포맷, 크리에이터를 파악합니다.
  • 같은 카테고리의 국가별 비교: 같은 카테고리를 여러 region 코드로 실행하고 동영상 ID로 목록을 맞춰 보며, 여러 나라로 퍼지는 동영상과 한 나라 안에서 뜨는 동영상을 가려냅니다.
  • 협업할 채널 명단 만들기: 카테고리 인기 급상승 페이지에 반복해서 오르는 채널을 핸들, 인증 배지와 함께 모아 협업 후보의 첫 명단으로 씁니다.

YouTube Trending Videos API 활용 팁

  • 같은 카테고리와 국가를 정해진 시각에 실행하고 id 기준으로 결과를 이어 붙이세요. rank 값이 바뀌는 모습에서 오르는 동영상과 내려가는 동영상이 드러납니다.
  • published_time_text 값은 collected_at 값과 함께 보세요. 페이지는 업로드 시점을 '15 min ago' 같은 텍스트로 보여 주므로, 대략적인 업로드 시각이 필요하면 수집 시각에서 그만큼 빼면 됩니다.
  • 상위권만 필요하다면 results_limit 값을 10이나 20으로 설정하세요. YouTube Trending Videos API는 반환된 동영상 수만큼 과금합니다.
  • 모은 동영상 ID를 YouTube Videos API에 넘기면 좋아요, 댓글, 전체 설명을, YouTube Transcripts API에 넘기면 각 인기 급상승 동영상에서 하는 말을 확인할 수 있습니다.

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

YouTube Trending Videos API는 선택한 국가에서 뉴스, 게임, 스포츠 같은 YouTube 카테고리의 인기 급상승 동영상을 가져오는 프로그래밍 인터페이스입니다. 동영상마다 순위, 제목, 채널, 조회수, 길이, 썸네일, 업로드 후 지난 시간을 반환합니다.

2025년 7월 YouTube는 하나로 운영하던 인기 급상승 페이지를 카테고리별 인기 급상승 목록으로 바꿨고, 게임 트렌드는 게임 탐색 페이지에 남겼습니다. YouTube Trending Videos API는 이 카테고리 페이지를 읽으므로 따라갈 카테고리를 골라서 지정합니다.

region 값에 그 나라의 두 글자 코드를 넣으면 됩니다. 예를 들어 일본은 JP, 독일은 DE입니다. 나라마다 목록이 따로 있어서 같은 카테고리라도 시장마다 오르는 동영상이 다를 수 있습니다.

뉴스, 게임, 스포츠, 학습, 강좌, 패션, 쇼핑입니다. 작업 하나에 카테고리 하나를 보내고, 더 많은 카테고리가 필요하면 작업을 여러 개 실행하세요.

results_limit 값으로 정하며, 목록 상단부터 최대 50개입니다. 목록이 더 짧은 카테고리는 있는 동영상만 반환하고, 요금은 실제로 받은 행만큼만 청구됩니다.

YouTube Trending Videos API는 반환된 동영상 1개당 0.5 크레딧을 차감하므로, 50개 전체는 25 크레딧, 상위 10개는 5 크레딧입니다.