API Douyin Комментарии поверх видео

POST

Состояние API

Состояние за 24 ч
Норма
  • Стабильно / норма
  • Доступно
  • Ограничено
  • Почти недоступно
Норма

Последние 24 часа

Последние 30 дней

Read the on-screen comments (danmaku) of one Douyin video from its url: a numeric video ID, a https://www.douyin.com/video/<video_id> link, a v.douyin.com short link or a whole share text that contains a short link. Each page covers one stretch of the video of up to 32 seconds, so the number of rows per page varies; to read the whole video, keep passing next_page_token back as page_token until it is absent. Each row has id, text, video_id, video_time (mm:ss), video_time_seconds, like_count, author_uid, is_ad and danmaku_count (all danmaku on the video). Each page is billed once.

Отправьте POST https://api.everyinfra.com/api/v1/social, указав в platform значение douyin, а в action — danmaku. Цена: $0.56 за 1 000 запросов ($0.000556 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

#
Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Douyin Комментарии поверх видео (douyin/danmaku).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: douyin и action: danmaku, а параметры передайте в params.
- Обязательные параметры:
  - url: The Douyin video whose danmaku you want: a numeric video ID, a https://www.douyin.com/video/<video_id> link, a v.douyin.com short link or a whole share text that contains a short link.
- Необязательные параметры:
  - page_token: Page token for danmaku. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, keeping the other inputs unchanged. Tokens last 24 hours.
  - limit: Максимальное число записей в этом вызове, целое число не меньше 1. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей.
- Возвращает список записей. Основные поля каждой записи: id, text, video_id (ID видео: в comments — видео, к котором…), video_time, video_time_seconds, like_count, author_uid (Числовой ID пользователя-автора (в comm…), is_ad (Является ли пост рекламой), danmaku_count.
- Пример тела запроса:
{
  "platform": "douyin",
  "action": "danmaku",
  "params": {
    "url": "https://www.douyin.com/video/7633646113853104116"
  }
}
- Цена: $0.56 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.

Параметры запроса

#
ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаdouyinИдентификатор платформы, фиксированное значение.
actionbodystringДаdanmakuИдентификатор возможности, фиксированное значение.
urlbody.paramsstringДа-The Douyin video whose danmaku you want: a numeric video ID, a https://www.douyin.com/video/<video_id> link, a v.douyin.com short link or a whole share text that contains a short link.
page_tokenbody.paramsstringНет-Page token for danmaku. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, keeping the other inputs unchanged. Tokens last 24 hours; the last page has no next_page_token. Each page is one stretch of up to 32 seconds of the video; to read the whole video, page until there is no next_page_token.
limitbody.paramsinteger (1–)Нет-Максимальное число записей в этом вызове, целое число не меньше 1. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей.

Примеры кода

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "douyin",
  "action": "danmaku",
  "params": {
    "url": "https://www.douyin.com/video/7633646113853104116"
  }
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

#
Получено November 21, 2026 at 07:17 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты); в списке оставлены первые 2. id, billing и quota меняются при каждом вызове, поэтому показана только их структура.
json
{  "id": "req_…",  "platform": "douyin",  "action": "danmaku",  "results": [    {      "id": "•••",      "text": "好厉害",      "video_id": "7633646113853104116",      "video_time": "00:00",      "video_time_seconds": 0,      "like_count": 0,      "author_uid": "•••",      "is_ad": false,      "danmaku_count": 868,      "platform": "douyin"    },    {      "id": "•••",      "text": "小学生想吃",      "video_id": "7633646113853104116",      "video_time": "00:00",      "video_time_seconds": 0,      "like_count": 0,      "author_uid": "•••",      "is_ad": false,      "danmaku_count": 868,      "platform": "douyin"    }  ],  "next_page_token": …,  "pagination": { … },  "count": 824,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Поля ответа

#

Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.

ПолеЗначение
idУникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться.
textОсновной текст без HTML возвращается полностью и никогда не обрезается (на нескольких платформах результаты списковых запросов содержат только фрагмент; это указано в примечаниях к полям платформы).
video_idID видео: в comments — видео, к которому относится комментарий; в post_history — запрошенное вами видео.
video_timeТрактуется так же, как на самой платформе
video_time_secondsТрактуется так же, как на самой платформе
like_countЛайки. null означает, что платформа или эта возможность не раскрывает значение; это не 0.
author_uidЧисловой ID пользователя-автора (в comments — автора комментария). author_id — это secUid; оба идентификатора указывают на одного и того же человека.
is_adЯвляется ли пост рекламой.
danmaku_countТрактуется так же, как на самой платформе
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).

Ошибки и оплата

#
401
Ключ отсутствует или недействителен.
402
Недостаточно средств на балансе. Сначала пополните баланс.
422
Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429
Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503
Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто)
Нет данных. Без списания.

Ошибки

Google Analytics: нужно согласие Приватность