douyin/
video-comments

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

Douyin Video Comments API

Прямой URL видео
Одна страница источника
CommentItem 1.0
0,1 кредита за запрос
Готово
Готово

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

README

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

Douyin Video Comments

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

Возможности Douyin Video Comments API

  • Точное указание видеоИзвлекает числовой ID видео из одного публичного URL на douyin.com или iesdouyin.com, путь которого содержит /video/{numeric_id}.
  • Ограниченный сбор одной страницыЗапрашивает до 20 строк комментариев с первой страницы источника, а results_limit от 1 до 20 определяет, сколько из них сохраняется.
  • Канонический контекст комментарияВозвращает записи CommentItem 1.0 с текстом, данными об авторе, связями с видео и родительским комментарием, временем публикации и сбора и видимым числом лайков или ответов.

Параметры Douyin Video Comments API

ПараметрыОбязательныйОписание
urlОбязательныйОбязательный публичный URL на douyin.com, iesdouyin.com или их поддомене. Путь должен содержать /video/ и числовой ID видео.
results_limitНеобязательныйНеобязательное целое число от 1 до 20. Если не указано, используется 20; интеграция запрашивает только первую страницу источника.

Как использовать Douyin Video Comments API

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

  1. Присвойте DOUYIN_VIDEO_URL публичный URL на douyin.com или iesdouyin.com с путем /video/{numeric_id}.
  2. Отправьте url и необязательный results_limit методом POST на /v1/douyin/video-comments и сохраните task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте data.results.items и следуйте next_cursor, только пока has_more равно true, чтобы продолжить чтение записей, уже сохраненных SocQ.
curl -X POST "https://api.socq.ai/v1/douyin/video-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"${DOUYIN_VIDEO_URL}\",\"results_limit\":20}"

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

Сценарии использования Douyin Video Comments API

  • Анализ реакции аудитории: Используйте текст комментариев, данные об авторах и видимое число лайков или ответов, чтобы изучать реакцию на известное публичное видео.
  • Карта связей комментариев: Связывайте возвращенные комментарии с исходным видео и переданной ссылкой на родительский комментарий через post_id и parent_id.
  • Сравнение снимков вовлеченности: Сравнивайте видимые показатели комментариев у выбранных видео или в разное время сбора, сохраняя collected_at как метку времени наблюдения.

Практические советы по Douyin Video Comments API

  • Перед отправкой раскрывайте ссылку из «Поделиться» или ссылку с редиректом до итогового URL вида /video/{numeric_id}, чтобы проверка хоста и пути прошла успешно.
  • Не указывайте results_limit, чтобы запросить 20 строк, или выберите меньшее целое число, если нужна только часть единственной возвращенной страницы источника.
  • Используйте исходный task_id и следуйте next_cursor, только если has_more равно true; этот курсор читает сохраненные строки и не загружает новую страницу источника.
  • Используйте id комментария как основной ключ для дедупликации и допускайте null в parent_id или post_id, если строка источника не содержит связи.
  • Считайте данные об авторе, published_at и отдельные метрики необязательными и помечайте каждый снимок результатов временем collected_at.
  • Экранируйте текст комментариев перед вставкой в HTML: публичные комментарии — это пользовательский контент.

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

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

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

Douyin Video Comments API — FAQ

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

url должен относиться к douyin.com, iesdouyin.com или их поддомену, а путь должен содержать /video/ и числовой ID. Пути профилей, поиска и другие пути, не ведущие на видео, отклоняются.

results_limit принимает целые числа от 1 до 20, по умолчанию 20. Задача запрашивает одну страницу источника, поэтому не может перейти к следующим страницам источника.

CommentItem 1.0 включает базовые поля идентификации и времени, а также text, author, parent_id, post_id и metrics с likes_count и replies_count. Необязательные поля источника остаются null, если данные недоступны.

Отдельного запроса страницы ответов он не выполняет. Возвращенная строка может содержать replies_count и parent_id, если их передает источник, но эти поля не означают, что текст ответов был собран.

next_cursor относится к GET /v1/tasks/{task_id} и разбивает на страницы записи, которые SocQ уже сохранил после успешного завершения. Он никогда не запрашивает следующую страницу источника Douyin.

Каждая успешная задача стоит фиксированные 0,10 кредита SocQ независимо от results_limit и числа возвращенных элементов; для неудачных задач действует штатный порядок возврата кредитов.