youtube/
related-videos

동영상 URL로 YouTube가 그 동영상 옆에 추천하는 동영상 목록을 한 번에 가져와, 추천마다 제목, 채널, 조회수, 썸네일을 반환합니다.

YouTube Related Videos API

동영상 URL 입력
다음 동영상 추천
채널과 조회수
결과당 0.5 크레딧
준비됨
README

SocQ 작성 · 업데이트

YouTube Related Videos

관련 동영상은 YouTube가 동영상 옆에 다음에 볼 영상으로 늘어놓는 추천 목록으로, 각 항목에는 제목, 채널, 조회수, 썸네일이 표시됩니다. 이 목록을 보면 YouTube가 어떤 동영상과 채널을 같은 영역으로 묶는지 드러나므로, 니치 분야 지도를 그리거나 경쟁 채널을 찾거나 목표 동영상 옆에 노출될 콘텐츠를 기획하는 데 유용합니다.

YouTube Related Videos API 주요 기능

  • 흔히 쓰는 동영상 링크 모두 지원시청 URL, youtu.be 단축 링크, 쇼츠 링크, 라이브 링크 모두에서 동영상 ID를 읽어 냅니다.
  • 한 번에 전체 목록작업 하나로 YouTube가 해당 동영상에 보여 주는 추천 목록 전체를 반환하며, 보통 20개 안팎입니다.
  • 추천 동영상의 제작 채널author 필드에 추천된 각 동영상을 올린 채널의 ID, 이름, 채널 URL이 담깁니다.
  • 조회수와 썸네일metrics.views_count 값은 2.2M처럼 YouTube에 표시된 수치를 변환한 것이며, media 필드는 가장 큰 썸네일을 제공합니다.

YouTube Related Videos API 매개변수

매개변수필수설명
url필수YouTube 동영상 링크입니다. 시청 URL, youtu.be 링크, 쇼츠 링크, 라이브 링크를 사용할 수 있습니다.

YouTube Related Videos API 사용 방법

동영상 링크 하나를 보내고 추천 목록을 읽어 옵니다.

  1. {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}를 /v1/youtube/related-videos로 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/related-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'

# Each item is one recommended video with author and metrics.views_count.

YouTube Related Videos API 추천 활용 사례

  • 동영상 중심의 니치 지도 그리기: 반응이 좋은 동영상에서 출발해 추천 목록을 모으고, 그 결과에 다시 같은 작업을 반복해 YouTube가 함께 묶는 동영상 군집을 그려 봅니다.
  • 경쟁 채널 찾기: 내 업로드 옆에 각 author.id가 얼마나 자주 등장하는지 세어, YouTube가 내 동영상 옆에 계속 추천하는 채널을 파악합니다.
  • 내 동영상이 추천되는 위치 확인: 경쟁 채널의 인기 동영상으로 이 엔드포인트를 실행하고, 그 목록에 내 동영상 ID가 있는지 찾아봅니다.

YouTube Related Videos API 활용 팁

  • views_count 값은 2.2M처럼 반올림된 표시 텍스트에서 나온 값이므로 근삿값으로 다루세요.
  • 추천 목록은 시간이 지나면 바뀌므로, 실행 결과를 비교할 때는 목록마다 collected_at 값을 함께 저장하세요.
  • 남겨 둘 동영상 URL은 YouTube Videos에 보내 정확한 수치, 게시일, 재생 시간을 확인하세요.

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

YouTube Related Videos API는 동영상 URL로 YouTube가 그 동영상 옆에 추천하는 동영상 목록을 가져오는 프로그래밍 인터페이스입니다. 추천마다 제목, 채널, 조회수, 썸네일을 반환합니다.

YouTube가 해당 동영상에 보여 주는 목록 전체를 반환하며, 보통 20개 안팎입니다.

네. 쇼츠 링크, youtu.be 링크, 라이브 링크, 일반 시청 URL을 모두 지원합니다.

이제는 할 수 없습니다. 공식 Data API는 2023년 8월 7일에 relatedToVideoId 검색 매개변수 지원을 중단했으므로, YouTube가 동영상 옆에 보여 주는 목록은 이 엔드포인트로 읽을 수 있습니다.

반환된 추천 동영상 1건당 0.5 크레딧이 차감되므로, 일반적인 20개 목록은 10 크레딧입니다.