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 사용 방법
동영상 링크 하나를 보내고 추천 목록을 읽어 옵니다.
- {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}를 /v1/youtube/related-videos로 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/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에 보내 정확한 수치, 게시일, 재생 시간을 확인하세요.
관련 API
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 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 Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API