douyin/
user-videos

Собирайте до 20 публичных видео одного профиля Douyin по URL профиля или известному ID пользователя и получайте нормализованные поля контента, автора, медиафайлов, длительности, времени и видимой вовлеченности.

Douyin User Videos API

URL профиля или ID пользователя
До 20 видео
Нормализованные записи видео
0,1 кредита за запрос
Готово
Готово

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

README

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

Douyin User Videos

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

Возможности Douyin User Videos API

  • Два способа указать автораПередайте поддерживаемый URL профиля Douyin или известный user_id. Если указаны оба поля, используется user_id.
  • Явный охват в одну страницуЗапрашивайте от 1 до 20 результатов, где 20 — значение по умолчанию и максимум; запрос к поставщику всегда начинается с первой страницы.
  • Видео и данные об авторе вместеКаждая запись видео содержит нормализованные подписи, публичные поля автора, URL источника, метки времени, ссылки на медиафайлы и длительность.
  • Поля вовлеченности для наблюденийДоступное число воспроизведений, лайков, комментариев, репостов и просмотров сохраняется вместе с collected_at, поэтому каждый видимый счетчик привязан ко времени сбора.

Параметры Douyin User Videos API

ПараметрыОбязательныйОписание
urlОбязательный (хотя бы один)Ссылка на профиль Douyin с именем хоста douyin.com, iesdouyin.com или их поддоменом и путем, содержащим /user/{identifier}. Укажите url или user_id; если указаны оба, приоритет у user_id.
user_idОбязательный (хотя бы один)Известный идентификатор пользователя длиной от 1 до 256 символов ASCII: латинские буквы, цифры, двоеточия, подчеркивания или дефисы. Укажите user_id или url.
results_limitНеобязательныйЗапрошенное число записей с единственной страницы поставщика. Принимает целые числа от 1 до 20, по умолчанию 20.

Как использовать Douyin User Videos API

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

  1. Подготовьте URL профиля Douyin на douyin.com или iesdouyin.com с путем /user/{identifier} либо известный user_id.
  2. Отправьте идентификатор и необязательный results_limit от 1 до 20 методом POST на /v1/douyin/user-videos и сохраните task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте data.results.items; следуйте next_cursor только для дополнительных записей, уже сохраненных SocQ, а не для новой страницы поставщика.
curl -X POST "https://api.socq.ai/v1/douyin/user-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"'"$DOUYIN_PROFILE_URL"'","results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and use next_cursor only for stored results

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

  • Снимки ленты автора: Сохраняйте ограниченный набор публичных видео и время сбора для одного автора в выбранный момент наблюдения.
  • Обогащение каталога видео: Добавляйте нормализованные подписи, данные об авторе, URL источника, время публикации, длительность и доступные медиафайлы к имеющейся записи об авторе.
  • Анализ креативов и форматов: Изучайте возвращенные подписи, длительность и медиаполя, чтобы распределять доступные видео по подаче контента или формату.
  • Сравнение вовлеченности внутри снимка: Сравнивайте доступное число воспроизведений, лайков, комментариев, репостов и просмотров у возвращенных видео, сохраняя collected_at.

Практические советы по Douyin User Videos API

  • Используйте одно поле идентификатора в запросе. Если переданы и url, и user_id, бэкенд выбирает user_id.
  • Проверяйте хост URL и путь /user/{identifier} перед отправкой; обычный URL видео Douyin этому эндпоинту не подходит.
  • Задавайте results_limit, только если нужно меньше 20 записей по умолчанию; значение должно быть целым числом от 1 до 20.
  • Не путайте курсор результатов задачи с курсором источника Douyin. Запрос к источнику охватывает одну страницу, а курсор поставщика зафиксирован на первой странице.
  • Допускайте, что необязательные поля автора, медиафайлов, длительности, времени публикации и отдельные метрики могут быть null или пустыми, и сохраняйте наблюдения по id вместе с collected_at.

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

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

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

Douyin User Videos API — FAQ

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

Любое из этих полей удовлетворяет требованиям ко входным данным. URL должен относиться к поддерживаемому хосту Douyin и содержать /user/{identifier}; известный user_id можно передать напрямую, и он имеет приоритет, если указаны оба поля.

Он задает запрошенное число записей с единственной страницы поставщика. Значение должно быть целым числом от 1 до 20, по умолчанию 20.

Результат может содержать plays, likes, comments, shares и views. Каждое поле необязательно, поэтому недоступные значения источника остаются null и не вычисляются.

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

Каждая успешная задача Douyin User Videos стоит фиксированные 0,10 кредита SocQ независимо от числа записей, возвращенных в пределах лимита в 20 записей.