API Douyin Сведения о видео

Q: Можно ли получить число просмотров видео?

Нет. Douyin не публикует число просмотров, поэтому view_count здесь не отражает реальные просмотры. Чтобы оценить результат видео, смотрите на like_count, share_count и collect_count вместе и сравнивайте их с другими видео автора.

POST

Состояние API

Данные о состоянии этого API временно недоступны, поэтому неизвестно, как он работал в последнее время. Это не значит, что API не работает.

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

Douyin Video details читает публичную информацию об одном видео по его url: подпись, хештеги, длительность, число лайков, комментариев, репостов и сохранений, автора и число его подписчиков, время и регион публикации. Используйте эту возможность, чтобы разобрать отдельное вирусное видео, проверить показатели спонсорской публикации или дополнить данные по ссылкам на видео, собранным в других местах.

Передавайте ссылку на страницу видео вида https://www.douyin.com/video/<ID видео>, а не на профиль или страницу поиска. Та же ссылка подходит для чтения комментариев к видео и извлечения его транскрипта. Douyin не публикует число просмотров, поэтому view_count ничего не говорит о реальных просмотрах; охват оценивайте по лайкам, комментариям и репостам.

Цена: $0.56 за 1 000 запросов ($0.000556 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

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

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: douyin и action: video, а параметры передайте в params.
- Обязательные параметры:
  - url: Полный URL целевого видео Douyin в формате https://www.douyin.com/video/<video_id>. Возвращает данные видео в video, комментарии в comments, ответы на один комментарий в comment_replies (указывается видео, к которому отн…
- Возвращает один объект. Основные поля: id, url, text, media_type (Тип медиа: video или image для постов с…), video_url (URL воспроизведения видео (подписанный,…), like_count, comment_count, share_count, collect_count, view_count (Число воспроизведений), author_name, author_id; всего полей: 53, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Пример тела запроса:
{
  "platform": "douyin",
  "action": "video",
  "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 время и повторите попытку.

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

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

Имя	Расположение	Тип	Обязательный	По умолчанию	Описание
`Authorization`	header	`string`	Да	-	Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
`platform`	body	`string`	Да	`douyin`	Идентификатор платформы, фиксированное значение.
`action`	body	`string`	Да	`video`	Идентификатор возможности, фиксированное значение.
`url`	body.params	`string`	Да	-	Полный URL целевого видео Douyin в формате `https://www.douyin.com/video/<video_id>`. Возвращает данные видео в `video`, комментарии в `comments`, ответы на один комментарий в `comment_replies` (указывается видео, к которому относится комментарий) или расшифровку аудио в `transcript`. Не передавайте URL профилей пользователей или страниц поиска.

Примеры кода

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": "video",
  "params": {
    "url": "https://www.douyin.com/video/7633646113853104116"
  }
}'

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

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

Реальный ответ

Получено October 24, 2026 at 18:28 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты). id, billing и quota меняются при каждом вызове, поэтому показана только их структура.

json

{
  "id": "req_…",
  "platform": "douyin",
  "action": "video",
  "results": {
    "id": "7633646113853104116",
    "url": "https://www.douyin.com/video/7633646113853104116",
    "text": "别犹豫 想吃谁做的就@谁 #家常菜 #如果幸福是一顿漂亮饭",
    "media_type": "video",
    "video_url": "https://v95-hzyy-thr-daily-colda.douyinvod.com/00e83eb1638968a210789ad41d005848/6add0846/video/tos/cn/tos-cn-ve-15/osCeAU146LfGGBFAgTIGXXewRxoNAEESBGgzu7/?a=1128&ch=26&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=1565&bt=1565&cs=0&ds=3&ft=zyTEemq4dd2~YBSzVvjVQXmz-TLJ9E05m4E5ljOCnzNf…",
    "like_count": 5191450,
    "comment_count": 367807,
    "share_count": 3397981,
    "collect_count": 603283,
    "view_count": 0,
    "author_name": "•••",
    "author_id": "•••",
    "author_douyin_id": "•••",
    "author_avatar_url": "https://p26.douyinpic.com/•••",
    "cover_image_url": "https://p5-ex-gddgtc-sign.douyinpic.com/tos-cn-i-0813c001/okiAIDJvALIEu1AesKf0wAio8AJBYDgAAA8IwC~tplv-dy-resize-walign-adapt-aq:540:q75.webp?lk3s=138a59ce&x-expires=1794074400&x-signature=hydt%2FpxAWFFAH3o1r0%2BRDkzfjeU%3D&from=327834062&s=PackSourceEnum_AWEME_DETAIL&se=false&sc=…",
    "region": "CN",
    "posted_at": "2026-04-28T03:25:39+00:00",
    "platform": "douyin",
    "author_uid": "•••",
    "author_is_verified": true,
    "author_bio": "•••",
    "author_like_count": 394320561,
    "author_video_count": 2279,
    "music": {
      "id": "•••",
      "title": "心跳（你又在哭泣我给不了安慰）",
      "author": "•••",
      "is_original": false,
      "duration_sec": 16,
      "cover_url": "https://p3.douyinpic.com/tos-cn-v-2774c002/oMisiuEh1DsoATBIAwPUiXBoApEaRADEAEezKW~tplv-dy-resize-walign-adapt-aq:720:q75.heic?biz_tag=aweme_music&s=PackSourceEnum_AWEME_DETAIL&sc=cover",
      "play_url": "https://sf11-cdn-tos.douyinstatic.com/obj/tos-cn-ve-2774/owJHiEhBzAg7AaUiiNwMhBIIWAKhf8tQ6sM8Tk"
    },
    "download_count": 10817,
    "forward_count": 0,
    "is_pinned": false,
    "is_ad": false,
    "video_tags": [
      "美食",
      "美食展示",
      "普通美食展示"
    ],
    "video_width": 720,
    "video_height": 960,
    "video_resolution": "720p",
    "animated_cover_url": "https://p5-ex-gddgtc-sign.douyinpic.com/obj/tos-cn-i-0813c001/okiAIDJvALIEu1AesKf0wAio8AJBYDgAAA8IwC?lk3s=138a59ce&x-expires=1794074400&x-signature=Z7xqx7cKvQ1o6chyAX%2Br7wiVTZs%3D&from=327834062_large&s=PackSourceEnum_AWEME_DETAIL&se=false&sc=dynamic_cover&biz_tag=aweme_video&l=…",
    "hashtag_ids": [
      "1767587367821390",
      "7510979073431046180"
    ],
    "city": "Shandong",
    "city_code": "371300",
    "text_language": "zh",
    "video_bitrates": [
      {
        "quality": "1080_1_1",
        "bitrate": 1761129,
        "fps": 30,
        "is_h265": true,
        "url": "https://v95-zjjx2tc-cold.douyinvod.com/3af3eb3ed8f93616a607176cb701eb9e/6add0846/video/tos/cn/tos-cn-ve-15/oMB3tqiEIAgpMdefkKiDwlLLcgRhgAAxBBB9Q1/?a=1128&ch=26&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=1719&bt=1719&cs=2&ds=4&ft=zyTEemq4dd2~YBSzVvjVQXmz-TLJ9E05m4E5ljOCnzNfG~RUxRyq…"
      },
      {
        "quality": "720_1_1",
        "bitrate": 1179750,
        "fps": 30,
        "is_h265": true,
        "url": "https://v95-hzyy-thr-daily-colda.douyinvod.com/4f077c6ec6d7afc7b94a71c860103399/6add0846/video/tos/cn/tos-cn-ve-15/c28890d8ae014084b8fe0baa7037a421/?a=1128&ch=26&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=1152&bt=1152&cs=2&ds=3&ft=zyTEemq4dd2~YBSzVvjVQXmz-TLJ9E05m4E5ljOCnzNfG~RUxR…"
      },
      {
        "quality": "720_2_1",
        "bitrate": 927020,
        "fps": 30,
        "is_h265": true,
        "url": "https://v95-zj-colda.douyinvod.com/3597031f464e4aaac8e792c309b3c41b/6add0846/video/tos/cn/tos-cn-ve-15/64888fdc0e70457d956f7d85cbc7f6f0/?a=1128&ch=26&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=905&bt=905&cs=2&ds=3&ft=zyTEemq4dd2~YBSzVvjVQXmz-TLJ9E05m4E5ljOCnzNfG~RUxRyqkZ&mime_type…"
      }
    ],
    "download_url": "https://v5-gddgtc-cold.douyinvod.com/a3891d04f3aaa7423d89030ba331a15f/6add0846/video/tos/cn/tos-cn-ve-15/oUYg9pEj8vJEAUY1AAImarifZCegMFQDgXDB4C/?a=1128&ch=26&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=1589&bt=1589&cs=0&ds=3&ft=zyTEemq4dd2~YBSzVvjVQXmz-TLJ9E05m4E5ljOCnzNfG~RUxRyqkZ…",
    "has_watermark": true,
    "video_url_expires_at": "2026-10-24T19:34:30+00:00",
    "permissions": {
      "can_comment": true,
      "can_download": true,
      "can_duet": true,
      "can_stitch": true,
      "can_share": true,
      "can_repost": true,
      "can_save": true
    },
    "author_gender": "female",
    "author_age": 27,
    "duration_sec": 9,
    "hashtags": [
      "家常菜",
      "如果幸福是一顿漂亮饭"
    ],
    "duration_seconds": 9
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

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

Поле	Значение
`id`	Уникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться.
`url`	Ссылка на запись на платформе.
`text`	Основной текст без HTML возвращается полностью и никогда не обрезается (на нескольких платформах результаты списковых запросов содержат только фрагмент; это указано в примечаниях к полям платформы).
`media_type`	Тип медиа: video или image для постов с изображениями.
`video_url`	URL воспроизведения видео (подписанный, со сроком действия; если видео нужно сохранить, скачайте его сразу). Для постов с изображениями или если источник не передал URL возвращается null.
`like_count`	Лайки. null означает, что платформа или эта возможность не раскрывает значение; это не 0.
`comment_count`	Комментарии. null означает, что значение не раскрыто, а не 0.
`share_count`	Количество раз, когда записью поделились. null означает, что значение не раскрыто, а не 0.
`collect_count`	Сохранения или добавления в избранное. null означает, что значение не раскрыто, а не 0.
`view_count`	Число воспроизведений. Douyin не публикует число воспроизведений, поэтому это поле никогда не содержит фактического числа воспроизведений; оценивайте охват по like_count, comment_count и share_count.
`author_name`	Отображаемое имя автора.
`author_id`	Уникальный ID автора на платформе.
`author_douyin_id`	ID автора в Douyin.
`author_uid`	Числовой ID пользователя-автора (в comments — автора комментария). author_id — это secUid; оба идентификатора указывают на одного и того же человека.
`author_bio`	Описание профиля автора (записи search / user_posts / video).
`author_avatar_url`	URL изображения аватара автора: в записях search, user_posts и video — автора контента, а в записях comments — автора комментария.
`author_follower_count`	Число подписчиков автора. null означает, что значение не раскрыто.
`cover_image_url`	URL обложки видео или поста с изображениями (записи search / user_posts).
`video_width`	Ширина кадра видео в пикселях.
`video_height`	Высота кадра видео в пикселях.
`duration_seconds`	Длительность в секундах. null для контента, который не является видео или аудио.
`region`	Регион.
`hashtags`	Хештеги в тексте в порядке появления; поле отсутствует, если их нет.
`posted_at`	Время публикации в ISO 8601, UTC (например, 2026-08-07T12:34:56+00:00). Нестандартные строки платформы передаются как есть, поэтому учитывайте это при разборе. null означает, что платформа его не раскрывает.
`platform`	Идентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).
`image_urls`	Массив ссылок на изображения в порядке показа на платформе; поле отсутствует, если изображений нет.
`duration_sec`	Длительность видео в секундах.
`hashtag_ids`	Трактуется так же, как на самой платформе
`search_rank`	Трактуется так же, как на самой платформе
`author_is_verified`	Верифицирован ли автор (записи search / user_posts / video).
`author_following_count`	На сколько аккаунтов подписан автор (записи search / user_posts / video).
`author_like_count`	Общее число лайков, полученных профилем автора (search / user_posts / video / transcript).
`author_video_count`	Общее число постов в профиле автора (записи search / user_posts / video).
`author_ip_location`	Местоположение автора по IP-адресу, которое Douyin показывает в каждом профиле.
`title`	Заголовок. null, если на платформе нет заголовков (например, у текстовых постов).
`music`	Фоновый трек: id, title, author, is_original (оригинальный звук или нет), duration_sec, cover_url и play_url (ссылка на аудио, которая может стать недействительной). Отсутствует, если информации о музыке нет.
`download_count`	Сколько раз пост скачали.
`forward_count`	Сколько раз пост переслали.
`is_pinned`	Закреплён ли элемент (записи постов: закреплён в профиле автора; trending: закреплён в рейтинге).
`is_ad`	Является ли пост рекламой.
`video_tags`	Теги категорий контента, которые Douyin присвоил посту (например, еда или посещение заведения).
`video_resolution`	Уровень качества видео в обозначении Douyin (например, 720p).
`animated_cover_url`	Ссылка на анимированную обложку.
`city`	Название города на языке платформы в исходном виде.
`city_code`	Трактуется так же, как на самой платформе
`location`	Описание местоположения передаётся как есть; формат зависит от платформы.
`text_language`	Трактуется так же, как на самой платформе
`video_bitrates`	Трактуется так же, как на самой платформе
`download_url`	Трактуется так же, как на самой платформе
`has_watermark`	Трактуется так же, как на самой платформе
`video_url_expires_at`	Трактуется так же, как на самой платформе
`permissions`	Трактуется так же, как на самой платформе
`author_gender`	Трактуется так же, как на самой платформе
`author_age`	Трактуется так же, как на самой платформе

FAQ

Какую ссылку передавать в `url`?

Полную ссылку на страницу видео вида https://www.douyin.com/video/<ID видео>. Если у вас есть только короткая ссылка «Поделиться», сначала откройте её в браузере и скопируйте адрес страницы видео, на которую она ведёт. Ссылки на профили и страницы поиска не работают.

Можно ли получить число просмотров видео?

Нет. Douyin не публикует число просмотров, поэтому view_count здесь не отражает реальные просмотры. Чтобы оценить результат видео, смотрите на like_count, share_count и collect_count вместе и сравнивайте их с другими видео автора.

Можно ли получить расшифровку речи из видео?

Эта возможность возвращает подпись и хештеги, но не речь. Чтобы получить произнесённые слова, вызовите возможность Douyin Transcript с той же ссылкой на видео: она распознаёт речь и возвращает её в виде текста, пригодного для анализа.

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

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

Ошибки