douyin/
video-search

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

Douyin Video Search API

Текстовый запрос
Фиксированная первая страница
Нормализованные видео
0,1 кредита за запрос
Готово
Готово

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

README

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

Douyin Video Search

Douyin Video Search превращает непустой текстовый запрос в ограниченный датасет публичных видео. Каждая задача отправляет поставщику один фиксированный запрос страницы 1 со смещением 0, а затем сохраняет возвращенные записи в формате reel-video от SocQ, чтобы их было удобно единообразно читать в дальнейшем.

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

  • Спецификация поиска из одного поляПередавайте только query. Эндпоинт отклоняет необъявленные входные данные, например results_limit, и не требует токена поставщика или внутреннего идентификатора.
  • Ограниченный запрос к источникуКаждая задача запрашивает у поставщика страницу 1 со смещением 0 и не открывает вызывающей стороне управление пагинацией поставщика.
  • Нормализованные записи reel-videoЧитайте доступный текст, автора, медиафайлы, длительность, метки времени и видимое число воспроизведений, лайков, комментариев и репостов в единой схеме результатов.
  • Асинхронное чтение сохраненных результатовОтправьте запрос один раз, опрашивайте задачу и используйте курсор результатов SocQ, только если завершенная задача сохранила больше записей, чем помещается в одну страницу ответа.

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

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

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

Укажите непустой query, дождитесь завершения асинхронной задачи и читайте нормализованные записи, сохраненные для этой задачи.

  1. Выберите конкретный текстовый запрос, описывающий публичные видео, которые нужно найти.
  2. Отправьте query методом POST на /v1/douyin/video-search и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не сообщит об ошибке.
  4. Читайте data.results.items. Если has_more равно true, передайте next_cursor в запрос результатов задачи, чтобы продолжить чтение сохраненных записей SocQ.
curl -X POST "https://api.socq.ai/v1/douyin/video-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"street food"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; next_cursor pages stored SocQ results only

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

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

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

  • Требуйте в своем интерфейсе осмысленный текст запроса, а не одни пробелы, еще до отправки задачи.
  • Не передавайте results_limit, page, offset, search_id или курсор поставщика: они не входят в схему публичного запроса SocQ.
  • Считайте возвращенный набор одним ответом поставщика, а не исчерпывающим поисковым индексом или окном ранжирования, которым управляет вызывающая сторона.
  • Используйте cursor и limit в GET /v1/tasks/{task_id} только для чтения сохраненных результатов; limit по умолчанию равен 50 и принимает значения от 1 до 500.
  • Сохраняйте collected_at и обрабатывайте необязательные поля автора, медиафайлов, публикации, длительности и отдельных метрик, не подставляя ноль вместо отсутствующих значений.

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

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

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

Douyin Video Search API — FAQ

Douyin Video Search API ищет публичные видео Douyin по одному текстовому запросу в пределах фиксированной первой страницы и возвращает нормализованные записи reel-video.

Принимается только query, и это должна быть непустая строка. Эндпоинт не принимает results_limit, page, offset или курсор поставщика, переданный вызывающей стороной.

Нет. Бэкенд всегда отправляет page 1 и offset 0 в одном запросе к поставщику и не предоставляет управление пагинацией источника.

next_cursor, возвращенный GET /v1/tasks/{task_id}, перелистывает записи, уже сохраненные SocQ для завершенной задачи. Он не загружает новую страницу источника Douyin.

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

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