douyin/
video-detail

Превращайте один известный URL видео Douyin в нормализованную запись с идентификатором видео, подписью, данными об авторе, медиафайлами, длительностью, метками времени и видимыми полями вовлеченности, если они доступны.

Douyin Video Detail API

Поддерживаемый URL Douyin
Одно нормализованное видео
0,10 кредита за задачу
0,1 кредита за запрос
Готово
Готово

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

README

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

Douyin Video Detail

Запись с данными о видео Douyin связывает известный URL публичного видео с нормализованными полями контента, автора, медиафайлов, времени и видимой вовлеченности. Она полезна, когда в рабочем процессе уже есть точная ссылка на видео и нужна одна единообразная запись для обогащения, проверки или последующего сравнения.

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

  • Поддерживаемый URL DouyinПринимает один URL на douyin.com, iesdouyin.com или поддерживаемом поддомене. Если в нем есть /video/, за этим сегментом должен следовать числовой ID.
  • Ограниченный результат по одному видеоВыполняет один запрос к поставщику и сохраняет не более одной нормализованной записи видео, без пагинации источника и results_limit.
  • Подпись и данные об автореВозвращает доступный текст видео вместе с нормализованными ID автора, именем пользователя, отображаемым именем, URL профиля, аватаром и признаками аккаунта.
  • Медиафайлы и длительностьСохраняет доступные ссылки на видео или изображения, превью, размеры, длительность медиафайла и нормализованное поле duration_seconds.
  • Снимок вовлеченности с меткой времениСвязывает доступное число лайков, комментариев, репостов, воспроизведений и просмотров с published_at и collected_at, а не выдает их за счетчики в реальном времени.

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

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

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

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

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

# Poll GET /v1/tasks/{task_id}
# Read the normalized video from data.results.items

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

  • Обогащение каталогов известных видео: Добавляйте нормализованные идентификаторы, подписи, данные об авторе, время публикации, длительность, медиафайлы и поля источника к одобренным ссылкам на видео Douyin.
  • Переход от поиска к деталям: Используйте поддерживаемый URL видео, сохраненный из записи Douyin user-videos или video-search, как точный вход для целевого запроса деталей.
  • Подготовка сравнений во времени: Сохраняйте повторные успешные результаты с collected_at, чтобы сравнивать доступные снимки публичной вовлеченности по заданному расписанию.

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

  • Чтобы поставщик смог найти видео, используйте прямую ссылку на публичное видео на поддерживаемом хосте; если в ней есть /video/, сохраняйте числовой ID видео без изменений.
  • Оставляйте поле в песочнице пустым, пока у вас нет реального URL публичного видео; у этого эндпоинта нет надежного универсального значения по умолчанию.
  • Отправляйте один URL на задачу и не передавайте results_limit, курсор и посторонние ID: публичный запрос принимает только url.
  • Считайте отсутствующие поля автора, медиафайлов, аудио, хештегов, упоминаний или вовлеченности недоступными, а не пустыми строками или нулем.
  • Используйте collected_at для сравнения метрик, а published_at — для хронологии контента: они описывают разные моменты.
  • Если дальше нужны комментарии к видео, передайте доступный поддерживаемый URL видео в отдельный эндпоинт, а не рассчитывайте, что задача деталей развернется в комментарии.

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

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

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

Douyin Video Detail API — FAQ

Douyin Video Detail API получает одно публичное видео Douyin по поддерживаемому URL и возвращает нормализованную запись по схеме reel-video с доступными полями идентификатора, подписи, автора, медиафайлов, длительности, времени и видимой вовлеченности.

Используйте URL с именем хоста douyin.com, iesdouyin.com или их поддоменом. Если URL содержит /video/, следующий за ним идентификатор должен быть числовым.

По возможности используйте прямую ссылку на публичное видео. Валидатор принимает поддерживаемые хосты Douyin и проверяет числовой ID везде, где есть /video/, но поставщику всё равно нужна ссылка, по которой видео можно найти, чтобы вернуть данные.

Схема reel-video может содержать базовые поля идентификации и времени, текст подписи, данные об авторе, медиафайлы, хештеги, упоминания, shortcode, длительность, аудио и доступное число лайков, комментариев, репостов, воспроизведений и просмотров. Необязательные поля могут быть null.

Нет. Поставщик выполняет один запрос деталей и может сохранить не более одного элемента. limit, has_more и next_cursor относятся к общему механизму чтения результатов задач SocQ, а не к пагинации поставщика.

POST возвращает task_id. Опрашивайте /v1/tasks/{task_id}; data.results появляется после успешного завершения задачи, а курсор отклоняется, пока задача не завершена.

За каждую успешную задачу списывается фиксированная плата 0,10 кредита SocQ. Сумма не зависит от числа результатов, потому что это фиксированная задача получения данных одного видео.