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
Составляйте запрос как стратегию поиска, а не просто ключевое слово. Начните достаточно широко, чтобы оценить картину, затем добавляйте по одному фильтру, чтобы видеть, какое решение отсекло кандидатов.
- Определите тему и вопрос: лучшие совпадения по теме, самые свежие материалы, видео с большим числом просмотров или кандидаты с готовыми субтитрами.
- Отправьте query и results_limit, а также только те параметры сортировки и фильтры, которые нужны для этого вопроса, методом POST на /v1/youtube/search.
- Сохраните полный запрос вместе с task_id, затем опрашивайте /v1/tasks/{task_id}, пока поиск не завершится успешно или с ошибкой.
- Удаляйте дубли результатов по 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 для доступного текста субтитров, а не ищите видео повторно.
Связанные API
Помимо 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 Channel 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 Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API