seo/
youtube-serp

선택한 국가와 언어에서 YouTube가 검색어에 대해 보여 주는 영상을 순위대로 확인하고, 영상마다 제목, 채널, 조회수, 길이, 썸네일, 게시일을 받습니다.

YouTube Rank Tracker API

순위 순서
순위별 영상
채널과 조회수
국가·언어 선택
결과당 0.5 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

YouTube Rank Tracker

YouTube 검색 순위는 특정 국가와 언어에서 YouTube가 검색어에 대해 보여 주는 영상의 순서로, 사람들이 찾아보는 주제에서 어떤 영상이 발견될지를 결정합니다. 목표 키워드의 순위를 추적하면 채널의 영상이 어디에 놓이는지, 시장마다 어떤 채널이 주제를 장악하고 있는지, 상위 영상이 얼마나 최신이고 얼마나 긴지, 결과가 약해 도전할 만한 키워드는 무엇인지 알 수 있습니다.

YouTube Rank Tracker API 주요 기능

  • 순위대로 정렬된 영상행의 순서가 해당 검색어에 대한 YouTube 검색 순서이며, 각 행은 영상 하나로 영상 id, 시청 url, text에 담긴 제목을 포함합니다.
  • 영상마다의 채널author에는 채널 id, 이름, url, 아바타가 들어 있어 순위를 채널별로 묶을 수 있습니다.
  • 조회수, 길이, 게시일metrics.views_count, duration_seconds, published_at으로 상위 영상이 얼마나 인기 있고 길고 최신인지 확인합니다.
  • 모든 결과의 썸네일media에 영상 썸네일이 있어 검색 결과를 시각적인 보고서로 바로 만들 수 있습니다.
  • 시장별 순위검색 국가와 언어를 정하고 results_limit으로 1~200개의 영상을 읽습니다.

YouTube Rank Tracker API 매개변수

매개변수필수설명
query필수YouTube에서 검색할 키워드(예: crm tutorial)입니다.
location_code선택검색 시장의 위치 코드입니다. 기본값은 2840(미국)입니다.
location_name선택location_code 대신 쓰는 시장 이름으로, 입력하면 location_code보다 우선합니다.
language_code선택검색 언어 코드입니다. 기본값은 en입니다.
language선택language_code 대신 쓰는 언어 이름으로, 입력하면 language_code보다 우선합니다.
results_limit선택가져올 영상 수의 상한으로 1~200, 기본값은 20입니다.

YouTube Rank Tracker API 사용 방법

검색어를 보내고 순위대로 영상마다 한 행씩 받습니다.

  1. {"query": "crm tutorial", "location_code": 2840, "language_code": "en", "results_limit": 20}을 /v1/seo/youtube-serp에 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/seo/youtube-serp" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"crm tutorial","location_code":2840,"language_code":"en","results_limit":20}'

YouTube Rank Tracker API 추천 활용 사례

  • 목표 키워드에서 자사 영상 순위 추적: 키워드를 주기적으로 조회해 author id가 자사 채널인 영상의 위치를 기록합니다.
  • 주제를 장악한 채널 파악: 여러 키워드의 결과에서 author별 등장 횟수를 세어 시장마다 주제를 주도하는 채널을 정리합니다.
  • 도전할 만한 키워드 찾기: 상위 영상의 views_count가 낮거나 published_at이 오래된 검색어를 찾습니다. 좋은 새 영상이 올라갈 여지가 있다는 신호입니다.
  • 영상 길이와 형식 기획: 상위 결과의 duration_seconds를 비교해 해당 주제에서 YouTube가 어느 정도 길이의 영상을 우대하는지 확인합니다.

YouTube Rank Tracker API 활용 팁

  • 순위를 저장할 때는 반환된 순서에서 각 영상의 위치를 검색어, 시장, 날짜와 함께 기록하세요. 반환 순서가 곧 순위입니다.
  • 자사 영상을 대조할 때는 바뀔 수 있는 채널 이름 대신 author.id로 비교하세요.
  • 첫 화면 결과만 본다면 results_limit은 20 안팎이면 충분합니다. 영상 1개마다 0.5크레딧이 듭니다.

YouTube Rank Tracker API 외에 SEO의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Google Organic SERP API — 검색어와 시장으로 실시간 Google 검색 결과 페이지 하나를 가져오며, 정규화된 도착 URL, 순위, 요소 유형, 전체 결과 상세를 포함합니다.
  • Keyword Difficulty API — 제출한 키워드 묶음의 오가닉 순위 난이도를 비교하며, 확인 가능한 각 키워드를 정규화된 점수와 함께 반환합니다.
  • Keyword Overview API — 제출한 키워드 묶음에 확인 가능한 수요, 유료 경쟁, 난이도, 월간 검색량, 검색 의도 맥락을 더해 보강합니다.
  • Keyword Search Volume API — 알고 있는 키워드의 검색량, CPC, 유료 경쟁, 월별 검색 추이를 측정합니다.
  • Keywords for Site API — 웹사이트 하나와 관련된 키워드를 생성하며, 확인 가능한 수요 측정값, 월별 추이, 시장 맥락, 전체 원본 행을 포함합니다.
  • Google Autocomplete API — 검색어 앞부분에 대해 Google이 제안하는 자동완성 검색어를 Google 순서 그대로, 원하는 국가와 언어로 수집합니다.

다른 플랫폼 둘러보기

SEO 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

YouTube Rank Tracker API — 자주 묻는 질문

YouTube Rank Tracker API는 선택한 국가와 언어에서 YouTube가 검색어에 대해 보여 주는 영상을 순위대로 반환하는 API로, 영상마다 제목, 채널, 조회수, 길이, 썸네일, 게시일이 들어 있습니다.

네. 각 행은 검색 순위대로 정렬된 영상이며, 그 영상을 올린 채널은 author에 들어 있습니다.

results_limit은 1~200을 받으며 기본값은 20입니다.

반환된 영상 1개마다 0.5크레딧입니다.