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 содержит миниатюру видео — готовый материал для наглядного отчета по выдаче.
  • Позиции по рынкамЗадайте страну и язык поиска и читайте от 1 до 200 видео через results_limit.

Параметры 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} методом POST на /v1/seo/youtube-serp.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте видео из results.items по порядку и запрашивайте следующую страницу через results.next_cursor, пока has_more равно true.
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: каждое видео стоит 0,5 кредита.

Помимо YouTube Rank Tracker API, используйте эти API, когда нужен другой тип публичных данных SEO.

  • 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 — FAQ

YouTube Rank Tracker API возвращает видео, которые YouTube выдает по запросу в выбранной стране и на выбранном языке, в порядке ранжирования — с названием, каналом, просмотрами, длительностью, миниатюрой и датой публикации каждого.

Да. Каждая строка — видео на своей позиции в выдаче, а канал, который его опубликовал, указан в author.

results_limit принимает значения от 1 до 200, по умолчанию 20.

Каждое возвращенное видео стоит 0,5 кредита.