YouTube Comments
Комментарии YouTube — это публичные реакции зрителей на видео с текстом, контекстом автора, временем публикации, видимыми лайками, числом ответов, сведениями об исходном видео и связями в беседе. Эти сигналы обсуждений помогают анализировать обратную связь, изучать аудиторию, разбирать темы и отслеживать реакции.
Возможности YouTube Comments API
- Сбор комментариев с нескольких видеоСобирайте публичные комментарии по нескольким URL видео в одном запросе.
- Лимиты и сортировка для каждого видеоЗадавайте results_limit для каждого видео и выбирайте порядок: сначала новые или по релевантности.
- Поля комментария и автораВозвращает ID комментария, текст, публичные данные автора, время публикации и сведения об исходном видео.
- Связи в веткахВключает публичное число лайков, число ответов и ID родительского комментария для структурированного анализа обсуждений.
- Признаки взаимодействия автора видеоСохраняет отметки владельца канала и «сердечко от автора», если они есть в публичном результате.
Параметры YouTube Comments API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | URL публичных видео YouTube с видимыми комментариями, разделенные запятыми или переводами строки. |
results_limit | Необязательный | Максимальное число подходящих записей, запрашиваемых для каждого входного URL. Положительное целое число, по умолчанию 100. |
sort_by | Необязательный | Порядок комментариев. По умолчанию newest; relevance использует публичное ранжирование YouTube. |
Как использовать YouTube Comments API
Решите, что важнее — свежесть или заметность, задайте объем выборки на каждое видео и сохраняйте возвращенные связи, когда комментарии попадают в ваш пайплайн анализа.
- Выберите URL публичных видео и определите, нужны ли вам текущие реакции или обсуждение в ранжировании YouTube.
- Отправьте urls, results_limit и sort_by методом POST на /v1/youtube/comments; лимит применяется к каждому видео.
- Опрашивайте /v1/tasks/{task_id}: видео с включенными комментариями и видео с недоступными разделами комментариев могут обрабатываться в одном пакете.
- После успешного завершения удаляйте дубли по ID комментария, связывайте ответы через parent_comment_id и листайте страницы, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/youtube/comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],"results_limit":10,"sort_by":"newest"}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Сценарии использования YouTube Comments API
- Анализ обратной связи аудитории: Анализируйте текст публичных комментариев, чтобы выявлять тональность, повторяющиеся вопросы, темы и идеи для контента.
- Мониторинг кампаний и событий: Отслеживайте публичные реакции на авторов, запуски продуктов, кампании, анонсы или события.
- Исследование обсуждений: Используйте лайки, число ответов и ссылки на родительские комментарии, чтобы изучать комментарии с высокой вовлеченностью и активные ветки.
- Датасеты для анализа текста: Передавайте нормализованные комментарии в процессы классификации, кластеризации, резюмирования, помощи в модерации или оповещений.
Практические советы по YouTube Comments API
- Выбирайте sort_by до анализа. Переключение с relevance на newest меняет выборку, поэтому две выгрузки нельзя сравнивать так, будто изменился только порядок.
- Считайте results_limit верхней границей для каждого видео. Отключенные комментарии, модерация, ранжирование, ограничения и низкая активность могут уменьшить число возвращенных записей.
- Используйте ID комментария для дедупликации и parent_comment_id для связывания, но не рассчитывайте, что каждый видимый ответ окажется на той же странице результатов.
- Лайки и число ответов — это наблюдения на момент сбора, а не постоянные меры тональности или значимости.
- Текст комментариев и поля автора — недоверенные публичные данные. Экранируйте их в интерфейсах и проверяйте встроенные URL перед использованием.
- Совпадение по ключевому слову — это не анализ тональности. Сохраняйте исходный текст и контекст источника, когда присваиваете метки или делаете резюме.
- Храните ID видео и collected_at в каждой строке, чтобы аналитики могли воспроизвести, какую выборку беседы они изучали.
Связанные API
Помимо YouTube Comments API, используйте эти API, когда нужен другой тип публичных данных YouTube.
- YouTube Channel Videos API — Собирайте обычные публичные видео по URL каналов без Shorts и прямых трансляций.
- YouTube Transcripts API — Получайте доступные текстовые расшифровки с необязательным выбором языка.
- YouTube Channels API — Получайте публичные данные канала, изображения, верификацию и видимую статистику аудитории.
- YouTube Videos API — Получайте метаданные, превью, длительность и вовлеченность по известным URL видео или Shorts.
- YouTube Comment Replies API — Продолжайте известную ветку комментариев YouTube по токену ответов и получайте публичные ответы, авторов, вовлеченность и родительский контекст.
- YouTube Community Post Comments API — Собирайте комментарии к публикации в сообществе по ее ссылке: каналы комментаторов, число лайков и ответов.
- YouTube Shorts API
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API