youtube/
search

Ищите публичные видео YouTube по ключевому слову с фильтрами сортировки, даты, длительности и субтитров и получайте нормализованные метаданные, контекст канала, превью и вовлеченность.

YouTube Search API

Поиск видео
Поиск контента
Переносимые фильтры
0,5 кредита за результат
Готово
Готово

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

README

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

YouTube Search

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

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

  • Поиск видео без URLНаходите публичные обычные видео, не зная их URL заранее.
  • Сортировка результатовСортируйте результаты по релевантности, дате публикации, рейтингу или публичному числу просмотров.
  • Периоды публикацииФильтруйте результаты по периоду публикации: час, день, неделя, месяц или год.
  • Фильтры длительности и субтитровФильтруйте по короткой, средней или большой длительности и при необходимости требуйте наличия субтитров.
  • Нормализованные результаты видеоВозвращает нормализованные метаданные видео, сведения о канале, превью, длительность, данные о публикации и публичные метрики.

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

ПараметрыОбязательныйОписание
queryОбязательныйКлючевое слово или фраза для поиска публичных видео.
results_limitНеобязательныйМаксимальное число запрашиваемых публичных видео. Положительное целое число, по умолчанию 100.
sort_byНеобязательныйПорядок результатов. По умолчанию relevance.
published_withinНеобязательныйНеобязательный период публикации, отсчитываемый от времени текущего запроса.
durationНеобязательныйНеобязательная категория длительности YouTube.
has_captionsНеобязательныйНеобязательный фильтр наличия субтитров. Не трогайте его, чтобы не применять этот фильтр.

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

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

  1. Определите тему и вопрос: лучшие совпадения по теме, самые свежие материалы, видео с большим числом просмотров или кандидаты с готовыми субтитрами.
  2. Отправьте query и results_limit, а также только те параметры сортировки и фильтры, которые нужны для этого вопроса, методом POST на /v1/youtube/search.
  3. Сохраните полный запрос вместе с task_id, затем опрашивайте /v1/tasks/{task_id}, пока поиск не завершится успешно или с ошибкой.
  4. Удаляйте дубли результатов по ID видео, сохраняйте контекст позиции и collected_at и листайте страницы, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/youtube/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"NASA Artemis","results_limit":10,"sort_by":"date","published_within":"month","duration":"medium","has_captions":true}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

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

  • Исследование тем и рынка: Находите публичные видео о продуктах, отраслях, организациях, событиях или новых темах.
  • Поиск авторов и конкурентов: Используйте результаты поиска и сведения о канале-публикаторе, чтобы находить релевантных авторов, бренды или конкурентов.
  • Мониторинг свежих видео: Сочетайте сортировку по дате и периоды публикации, чтобы собирать свежие видео для проверки или анализа.
  • Датасеты с готовыми субтитрами: Требуйте наличия субтитров, чтобы находить видео для сбора расшифровок, резюмирования, классификации или поиска.

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

  • Проверьте два-три точных варианта запроса вместо того, чтобы прятать все понятия в одну длинную фразу. Пересечение результатов часто так же информативно, как и различия.
  • Добавляйте фильтры постепенно. Если сразу задать период публикации, длительность и субтитры, по пустому результату трудно понять, какое ограничение оказалось слишком узким.
  • Для мониторинга используйте date вместе с published_within; relevance без периода отвечает на другой, более широкий исследовательский вопрос.
  • Ранжирование нестабильно. Сохраняйте запрос, ID задачи, ID видео и collected_at, если важны позиция или состав выборки.
  • results_limit — это верхняя граница, а не гарантия полноты. Публичная доступность и выбранные фильтры могут дать меньше записей.
  • Удаляйте дубли между вариантами запроса по ID видео, но сохраняйте, какой запрос дал каждое совпадение, для последующего анализа релевантности.
  • Когда URL уже известен, используйте Videos для обновленных данных и Transcripts для доступного текста субтитров, а не ищите видео повторно.

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

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

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

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

YouTube Search API — FAQ

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

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

sort_by принимает relevance, date, rating или view_count. По умолчанию используется relevance.

Можно фильтровать по published_within, duration и has_captions. Периоды публикации: hour, day, week, month или year; значения длительности: short, medium или long.

Нет. Результаты — это ограниченная публичная выборка, которая может меняться в зависимости от ранжирования, свежести, региона, языка, доступности и выбранных фильтров.

Нет. has_captions фильтрует видео по наличию субтитров. Чтобы получить доступные субтитры в виде простого текста для выбранных URL видео, используйте Transcripts.

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