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
Отправьте начало поискового запроса и получите ранжированные варианты завершения.
- Отправьте {"query": "iphone 17"} методом POST на /v1/youtube/search-suggestions, добавив language и region для другого рынка.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте подсказки из 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, поскольку каждый рынок возвращает собственный список.
Связанные API
Помимо 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 Transcripts API
- YouTube Channels API
- YouTube Videos API
- YouTube Shorts API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Email Finder API
- YouTube Trending Videos API