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 родительского комментария как асинхронную задачу, затем читайте нормализованные записи ответов из завершенной задачи.
- Выберите URL публичного видео YouTube и ID комментария верхнего уровня, возвращенный для этого видео.
- Отправьте url, comment_id и results_limit методом POST на /v1/youtube/comment-replies.
- Сохраните возвращенный task_id и опрашивайте GET /v1/tasks/{task_id}, пока задача находится в статусе queued, running или retrying.
- После успешного завершения читайте 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, и экранируйте публичный текст ответов перед показом в другом интерфейсе.
Связанные API
Помимо 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 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