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