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