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로 보내고, 완료된 작업에서 순위 목록을 읽습니다.
- {"category": "news", "region": "US", "results_limit": 50}을 /v1/youtube/trending-videos로 POST하고 task_id 값을 보관합니다.
- status가 succeeded가 될 때까지 몇 초 간격으로 GET /v1/tasks/{task_id}를 호출합니다.
- 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에 넘기면 각 인기 급상승 동영상에서 하는 말을 확인할 수 있습니다.
관련 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 Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts 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