youtube/
comment-replies

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

YouTube Comment Replies API

Стабильная ссылка на комментарий
Публичные ответы
Контекст ветки
0,5 кредита за результат
Готово
Готово

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

README

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

YouTube Comment Replies

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

Возможности YouTube Comment Replies API

  • Стабильная ссылка на исходный комментарийНачните с URL публичного видео и ID родительского комментария, а SocQ сам определит текущий токен продолжения для ответов.
  • Записи ответов и авторовВозвращает ID ответов, публичный текст, связанные URL, время публикации и нормализованные данные автора или канала.
  • Контекст ветки и автора видеоХранит вместе видимые лайки, число вложенных ответов, ссылки на родительский комментарий и видео, а также отметки владельца канала и «сердечко от автора».
  • Ограниченный сбор по токенам продолженияПроходит по последующим токенам продолжения источника, удаляет дубли ID ответов и останавливается на выбранном лимите, в конце ветки или на пределе в 100 страниц.

Параметры YouTube Comment Replies API

ПараметрыОбязательныйОписание
urlОбязательныйОбязательный стабильный URL публичного видео YouTube, под которым находится родительский комментарий.
comment_idОбязательныйОбязательный ID комментария верхнего уровня, относящегося к переданному URL видео.
results_limitНеобязательныйМаксимальное число публичных ответов, собираемых из этой ветки. В примере из документации используется 20, допустимый диапазон — от 20 до 2000.

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

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

  1. Выберите URL публичного видео YouTube и ID комментария верхнего уровня, возвращенный для этого видео.
  2. Отправьте url, comment_id и results_limit методом POST на /v1/youtube/comment-replies.
  3. Сохраните возвращенный task_id и опрашивайте GET /v1/tasks/{task_id}, пока задача находится в статусе queued, running или retrying.
  4. После успешного завершения читайте data.results.items и передавайте data.results.next_cursor как cursor в запросе задачи, пока data.results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/youtube/comment-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","comment_id":"Ugzge340dBgB75hWBm54AaABAg","results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass data.results.next_cursor as cursor while has_more is true

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

  • Восстановление известной ветки: Используйте ID ответов, parent_comment_id, video_id, URL и временные метки, чтобы заново связать сохраненные ответы с выбранным комментарием верхнего уровня.
  • Анализ аудитории на уровне ответов: Сравнивайте публичный текст ответов, данные авторов, видимые лайки, число вложенных ответов и отметки взаимодействия автора видео внутри одной известной ветки.
  • Подготовка датасета публичных обсуждений: Объединяйте нормализованный текст ответов, авторов, временные метки и контекст ветки в записи для ручной проверки или последующей обработки текста.

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

  • Храните URL видео и ID комментария верхнего уровня в паре, чтобы ветка ответов и исходное видео оставались согласованными.
  • SocQ сам определяет текущий токен продолжения; если токен источника истек, повторите запрос с той же стабильной ссылкой.
  • Не путайте ID исходного комментария с cursor, который возвращает GET /v1/tasks/{task_id}: первый выбирает ветку ответов YouTube, а второй листает сохраненные результаты задачи.
  • Задавайте results_limit по ожидаемому размеру ветки, но считайте его верхней границей: публичная видимость и конец ветки могут уменьшить число возвращенных записей.
  • Удаляйте дубли сохраненных записей по ID ответа и сохраняйте parent_comment_id, video_id и extra.reply_token, когда связываете ответы с исходным комментарием.
  • Допускайте, что поля автора, временных меток, метрик и отметок автора видео могут быть null, и экранируйте публичный текст ответов перед показом в другом интерфейсе.

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

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

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

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

YouTube Comment Replies API — FAQ

YouTube Comment Replies API — это программный интерфейс для сбора публичных ответов на один комментарий верхнего уровня на YouTube. Передайте стабильный URL видео и ID комментария, чтобы получить текст ответов, данные авторов, видимую вовлеченность, временные метки и контекст ветки.

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

Нет. SocQ определяет текущий токен продолжения по переданному URL видео и ID комментария; передача токена в старом формате сохраняется в API для совместимости, но в этой песочнице не используется.

results_limit принимает целые числа от 20 до 2000, а пример в песочнице из документации отправляет 20. Сбор останавливается на этой границе, когда публичная ветка заканчивается или после 100 страниц источника.

Ответ может содержать ID, URL, текст, публичные данные автора или канала, видимые лайки и число вложенных ответов, время публикации и сбора, а также контекст видео, родительского комментария, отметок автора видео и токена в extra.

Нет. comment_id выбирает исходную ветку ответов YouTube, а cursor листает нормализованные записи, уже сохраненные в успешно завершенной задаче SocQ.

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

Каждый сохраненный нормализованный ответ стоит 0,5 кредита. Списание зависит от фактического числа сохраненных записей, поэтому за пустой результат плата за единицы результата не взимается.