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, отправьте асинхронную задачу и читайте нормализованные комментарии, сохраненные для этой задачи.
- Присвойте DOUYIN_VIDEO_URL публичный URL на douyin.com или iesdouyin.com с путем /video/{numeric_id}.
- Отправьте url и необязательный results_limit методом POST на /v1/douyin/video-comments и сохраните task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте 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: публичные комментарии — это пользовательский контент.
Связанные API
Помимо Douyin Video Comments API, используйте эти API, когда нужен другой тип публичных данных Douyin.
- Douyin Live Room Detail API — Получайте один известный прямой эфир Douyin по числовому ID: нормализованный контекст эфира, данные ведущего, медиа и видимое число зрителей.
- Douyin User Profile API
- Douyin User Videos API
- Douyin Video Detail API
- Douyin Video Search API