youtube/
comments

Собирайте публично видимые комментарии YouTube по одному или нескольким URL видео: нормализованный текст, авторы, лайки, число ответов, исходные видео и контекст беседы.

YouTube Comments API

Комментарии
Данные обсуждений
URL видео
0,3 кредита за результат
Готово
Готово

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

README

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

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

Решите, что важнее — свежесть или заметность, задайте объем выборки на каждое видео и сохраняйте возвращенные связи, когда комментарии попадают в ваш пайплайн анализа.

  1. Выберите URL публичных видео и определите, нужны ли вам текущие реакции или обсуждение в ранжировании YouTube.
  2. Отправьте urls, results_limit и sort_by методом POST на /v1/youtube/comments; лимит применяется к каждому видео.
  3. Опрашивайте /v1/tasks/{task_id}: видео с включенными комментариями и видео с недоступными разделами комментариев могут обрабатываться в одном пакете.
  4. После успешного завершения удаляйте дубли по 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 в каждой строке, чтобы аналитики могли воспроизвести, какую выборку беседы они изучали.

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

YouTube Comments API — FAQ

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

Передайте один или несколько URL публичных видео YouTube, необязательный results_limit и необязательное значение sort_by.

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

Записи ответов могут содержать parent_comment_id, а replies_count показывает публичное число ответов, связанных с комментарием.

results_limit — это максимум для каждого видео. Видео с отключенными, отфильтрованными, ограниченными или немногочисленными публично видимыми комментариями могут вернуть меньше записей или пустой результат.

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