youtube/
hashtag-search

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

YouTube Hashtag Search API

Ленты хештегов
Фильтр Shorts
Исходные хештеги
0,5 кредита за результат
Готово
Готово

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

README

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

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

Выберите хештеги, которые задают границы интересующей вас темы, и сохраняйте одинаковый режим контента и лимит на хештег, если выборки нужно сравнивать.

  1. Подготовьте один или несколько непустых хештегов, с начальным # или без него, и выберите all или shorts.
  2. Отправьте hashtags, results_limit и content_type методом POST на /v1/youtube/hashtag-search.
  3. Сохраните возвращенный task_id и опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте нормализованные видео из 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 превью и источников как ссылки и не считайте их постоянными загруженными медиафайлами.

Помимо 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 с публичными данными других поддерживаемых соцсетей.

YouTube Hashtag Search API — FAQ

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

Передайте непустой массив строк, например technology или #technology. Начальный # необязателен и удаляется перед сбором.

Да. Задайте content_type значение shorts, чтобы получить только Shorts, или оставьте режим по умолчанию all для доступной ленты хештега.

results_limit применяется отдельно к каждому переданному хештегу, по умолчанию равен 100 и принимает целые числа от 20 до 2 000. Из-за доступной ленты или предела сбора в 100 страниц записей может оказаться меньше.

Повторяющиеся ID или URL видео сохраняются в задаче один раз. Если важна точная атрибуция к ленте, отправляйте хештеги в отдельных задачах, потому что сохраненная запись хранит только один исходный хештег.

Каждое сохраненное нормализованное видео стоит 0,5 кредита, базовой платы нет. Предварительная оценка умножает results_limit или его значение по умолчанию 100 на число хештегов; итоговое использование зависит от фактического числа сохраненных записей, а за пустой набор результатов плата не взимается.