youtube/
search-suggestions

Получайте подсказки автозаполнения, которые поисковая строка YouTube предлагает для неполного запроса, в том порядке, в котором их видят зрители, для выбранных языка и региона.

YouTube Search Suggestions API

Автозаполнение
Язык и регион
Фиксированная цена за запрос
0,5 кредита за запрос
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

YouTube Search Suggestions

Поисковые подсказки — это варианты завершения, которые поисковая строка YouTube предлагает, пока зритель еще набирает запрос, с ранжированием для его языка и страны. Они показывают реальные формулировки спроса вокруг исходного запроса, поэтому служат прямым источником для подбора ключевых слов, названий видео, тегов и идей контента.

Возможности YouTube Search Suggestions API

  • Порядок, который видят зрителиrank фиксирует позицию каждой подсказки в выпадающем списке, начиная с 1 для верхнего варианта.
  • Выбор рынкаlanguage и region переключают подсказки на другой рынок, например es и MX для поиска на мексиканском испанском.
  • Ссылка на поиск для каждой фразыКаждая подсказка возвращается с URL результатов YouTube для этой фразы, а также с исходным запросом и рынком, для которых она была запрошена.

Параметры YouTube Search Suggestions API

ПараметрыОбязательныйОписание
queryОбязательныйНачало поискового запроса для автозаполнения, до 100 символов.
languageНеобязательныйКод языка подсказок, например en, es или pt-BR. По умолчанию en.
regionНеобязательныйДвухбуквенный код страны поискового рынка, например US или GB. По умолчанию US.

Как использовать YouTube Search Suggestions API

Отправьте начало поискового запроса и получите ранжированные варианты завершения.

  1. Отправьте {"query": "iphone 17"} методом POST на /v1/youtube/search-suggestions, добавив language и region для другого рынка.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте подсказки из results.items в порядке rank; переходите по results.next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/youtube/search-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"iphone 17"}'

# Each item is one suggestion: keyword, rank, language and region.

Сценарии использования YouTube Search Suggestions API

  • Расширение исходного ключевого слова: Собирайте варианты завершения для названия продукта или темы, чтобы найти более длинные фразы, которые зрители действительно ищут.
  • Названия, совпадающие с поиском: Берите формулировки из верхних подсказок, чтобы название видео повторяло то, как люди набирают запрос.
  • Сравнение спроса на разных рынках: Запускайте один и тот же исходный запрос с разными значениями language и region, чтобы увидеть, как меняется намерение от страны к стране.

Практические советы по YouTube Search Suggestions API

  • Добавляйте букву после исходного запроса, например iphone 17 a, чтобы получить варианты завершения, продолжающиеся с этой буквы.
  • При отслеживании исходного запроса во времени не меняйте language и region, поскольку каждый рынок возвращает собственный список.

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

  • YouTube Channel Videos API — Собирайте обычные публичные видео по URL каналов без Shorts и прямых трансляций.
  • YouTube Comments API — Собирайте публичные комментарии, авторов, вовлеченность, исходные видео и контекст обсуждения.
  • YouTube Search API — Ищите обычные публичные видео по ключевому слову с поддерживаемыми фильтрами метаданных.
  • YouTube Hashtag Search API — Находите публичные видео из лент хештегов: весь контент или только Shorts.
  • YouTube Channel Search API — Находите каналы по ключевому слову: названия, число подписчиков, аватары и фрагменты описания.
  • YouTube Shorts Search API — Ищите ролики Shorts по ключевому слову: ссылки, подписи, просмотры и вертикальные миниатюры.

Другие платформы

Объединяйте данные YouTube с публичными данными других поддерживаемых соцсетей.

YouTube Search Suggestions API — FAQ

YouTube Search Suggestions API — это программный интерфейс для получения поисковых подсказок автозаполнения YouTube для неполного запроса на выбранных языке и регионе. Он возвращает каждую предложенную фразу с ее позицией.

Да. Подсказки — это варианты завершения, которые поисковая строка YouTube показывает при вводе, и они возвращаются в том же порядке.

Столько, сколько YouTube предлагает для этого запроса, обычно около дюжины.

В официальном Data API нет эндпоинта автозаполнения или typeahead. Этот эндпоинт возвращает подсказки, которые показывает поисковая строка YouTube, ранжированные для выбранных вами языка и региона.

Каждый запрос стоит фиксированные 0,5 кредита независимо от числа возвращенных подсказок.