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 사용 방법
검색어를 보내고 순위대로 영상마다 한 행씩 받습니다.
- {"query": "crm tutorial", "location_code": 2840, "language_code": "en", "results_limit": 20}을 /v1/seo/youtube-serp에 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- 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크레딧이 듭니다.
관련 API
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 순서 그대로, 원하는 국가와 언어로 수집합니다.
- Keyword Suggestions API
- Ranked Keywords API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API