YouTube Hashtag Search
Ленты хештегов YouTube — это публичные подборки видео, связанные с тематическим хештегом, с названиями, описаниями, данными канала, превью, длительностью, сведениями о публикации и видимой вовлеченностью. Такие записи помогают картировать темы, проверять участие в кампаниях, формировать выборки Shorts и сравнительно анализировать контент.
Возможности YouTube Hashtag Search API
- Поиск по лентам хештеговНаходите публичные видео, связанные с хештегом, без передачи URL видео или каналов.
- Режимы «весь контент» и «только Shorts»Задайте content_type значение all для доступной ленты хештега или shorts для выборки только из Shorts.
- Контекст видео и каналаВозвращает названия, описания, данные канала, превью, длительность, сведения о публикации и видимое число просмотров, лайков и комментариев.
- Сохранение исходного хештегаКаждая сохраненная запись содержит нормализованный исходный хештег, закрепленный за этим результатом видео.
Параметры YouTube Hashtag Search API
| Параметры | Обязательный | Описание |
|---|---|---|
hashtags | Обязательный | Один или несколько непустых хештегов. Начальный # необязателен и удаляется перед сбором. |
results_limit | Необязательный | Максимальное число видео, собираемых для каждого хештега, от 20 до 2 000; по умолчанию 100. |
content_type | Необязательный | Режим контента: all для доступной ленты хештега или shorts для результатов только из Shorts; по умолчанию all. |
Как использовать YouTube Hashtag Search API
Выберите хештеги, которые задают границы интересующей вас темы, и сохраняйте одинаковый режим контента и лимит на хештег, если выборки нужно сравнивать.
- Подготовьте один или несколько непустых хештегов, с начальным # или без него, и выберите all или shorts.
- Отправьте hashtags, results_limit и content_type методом POST на /v1/youtube/hashtag-search.
- Сохраните возвращенный task_id и опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте нормализованные видео из data.results.items и продолжайте с next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/youtube/hashtag-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtags":["#technology"],"results_limit":20,"content_type":"shorts"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования YouTube Hashtag Search API
- Проверка участия в кампаниях: Используйте выборки из лент хештегов, описания видео, данные каналов и видимую вовлеченность, чтобы проверять публичное участие в кампаниях.
- Тематические выборки Shorts: Выберите shorts, чтобы собрать целевую выборку коротких видео, связанных с тематическим хештегом.
- Подготовка тематических датасетов: Объединяйте ID видео, URL, сведения о публикации, контекст канала, метрики и сохраненные исходные хештеги в структурированные исследовательские датасеты.
Практические советы по YouTube Hashtag Search API
- Нормализуйте входной список до отправки, чтобы #technology и technology не запускали дублирующийся сбор.
- Используйте один хештег на задачу, если важна атрибуция между пересекающимися лентами: повторяющиеся ID видео сохраняются один раз и с одним исходным хештегом.
- Считайте results_limit верхней границей для каждого хештега; сбор может остановиться раньше, если лента закончится или покажет меньше подходящих видео.
- При сравнении форматов храните выборки all и shorts отдельно, чтобы смешанная лента не искажала подмножество коротких видео.
- Храните URL превью и источников как ссылки и не считайте их постоянными загруженными медиафайлами.
Связанные API
Помимо YouTube Hashtag Search API, используйте эти API, когда нужен другой тип публичных данных YouTube.
- YouTube Comments API — Собирайте публичные комментарии, авторов, вовлеченность, исходные видео и контекст обсуждения.
- YouTube Videos API — Получайте метаданные, превью, длительность и вовлеченность по известным URL видео или Shorts.
- YouTube Shorts API — Собирайте публичные Shorts, превью, длительность, данные о публикации и вовлеченность по каналу.
- YouTube Search API — Ищите обычные публичные видео по ключевому слову с поддерживаемыми фильтрами метаданных.
- YouTube Channel Search API — Находите каналы по ключевому слову: названия, число подписчиков, аватары и фрагменты описания.
- YouTube Shorts Search API — Ищите ролики Shorts по ключевому слову: ссылки, подписи, просмотры и вертикальные миниатюры.
- YouTube Channel Videos API
- YouTube Transcripts API
- YouTube Channels 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 Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API