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