Ко всем API
Публичные данные Douyin

Douyin Public Data APIs

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

Доступные API Douyin

Выберите один из шести API для работы с профилями, видео, комментариями, поиском и прямыми эфирами.

Какие данные Douyin можно получить?

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

Профили и видео авторов

Получайте публичный профиль или собирайте одну страницу видео источника по поддерживаемому URL профиля или user_id.

Данные видео, поиск и комментарии

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

Данные прямого эфира

Получайте один известный прямой эфир по room_id из одних цифр с доступными полями ведущего, статуса, медиа и видимой аудитории.

Спецификации API Douyin вкратце

У каждого эндпоинта ограниченный запрос к источнику, а необъявленные параметры отклоняются.

Группа APIВходные данныеГраница источника
Профиль и видео автораurl или user_idОдин профиль или одна страница источника; для видео автора поддерживается results_limit 1–20
Данные видео и комментарииПоддерживаемый URLОдна запись видео или одна страница комментариев; для комментариев поддерживается results_limit 1–20
Поиск видеоНепустой queryФиксированная первая страница источника без results_limit
Прямой эфирroom_id из одних цифрНе более одной записи прямого эфира

Как работают API Douyin

Все шесть эндпоинтов используют одинаковый асинхронный процесс: отправка, опрос и получение сохраненных результатов.

  1. 1. Выберите эндпоинт

    Выберите эндпоинт профиля, видео, комментариев, поиска или прямого эфира, который соответствует уже имеющейся у вас публичной ссылке.

  2. 2. Отправьте корректные входные данные

    Отправьте методом POST только объявленные поля и сохраните возвращенный task_id.

  3. 3. Читайте нормализованные результаты

    Опрашивайте задачу до конечного статуса, затем читайте data.results.items и используйте next_cursor только для пагинации сохраненных результатов.

Поиск публичных видео Douyin

Пройдите аутентификацию с API-ключом SocQ и отправьте непустой query. Успешная задача Douyin стоит фиксированные 0,10 кредита.

curl -X POST "https://api.socq.ai/v1/douyin/video-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"artificial intelligence"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after success

Типичные сценарии использования API Douyin

Исследование авторов

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

Анализ контента и обсуждений

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

Мониторинг прямых эфиров

Фиксируйте снимок известного публичного прямого эфира по явному числовому идентификатору комнаты.

Ограничения и политика публичных данных

Эти эндпоинты читают публичные данные через ограниченные запросы к источнику и не выполняют действий от имени аккаунта и непрерывного мониторинга.

  • user_id принимает от 1 до 256 латинских букв ASCII, цифр, двоеточий, подчеркиваний или дефисов; URL профиля должен содержать /user/{identifier} на поддерживаемом хосте Douyin.
  • room_id — это строка, состоящая только из цифр; не храните длинные идентификаторы в числовых значениях JavaScript.
  • results_limit доступен только для User Videos и Video Comments, в диапазоне 1–20, по умолчанию 20.
  • Video Search всегда работает с первой страницей источника; курсоры результатов задачи листают только записи, уже сохраненные для этой задачи.
  • Каждая успешная задача Douyin стоит фиксированные 0,10 кредита.

Частые вопросы об API Douyin

Что такое API Douyin?

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

Какие эндпоинты принимают results_limit?

User Videos и Video Comments принимают целое число от 1 до 20. Остальные эндпоинты Douyin отклоняют results_limit.

Можно ли листать страницы источника?

Курсора источника, которым управляет вызывающая сторона, нет. Возвращенный next_cursor листает только результаты, уже сохраненные для завершенной задачи.

Сколько стоят запросы к Douyin?

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

Сводите публичные профили, контент и данные о вовлеченности с разных платформ в один рабочий процесс, чтобы отслеживать бренды, авторов и темы и эффективнее вести кросс-платформенный мониторинг и анализ.

YouTube API

Собирайте поддерживаемые публичные профили каналов YouTube, данные о видео, видео каналов, комментарии, Shorts, результаты поиска по ключевым словам и хештегам и доступные расшифровки в едином нормализованном асинхронном процессе.

Facebook API

Собирайте публичные профили страниц Facebook, публикации, публикации в группах, комментарии, мероприятия по ключевому слову и доступные расшифровки видео с нормализованными полями идентичности, контента, источника, формата, места, медиа, реакций, посещаемости и вовлеченности.

X API

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

LinkedIn API

Получайте публичные данные профилей, компаний, публикаций и вакансий LinkedIn по известным URL с нормализованными полями идентичности, карьеры, компании, контента, вовлеченности и вакансии.

Reddit API

Получайте публичные публикации и комментарии Reddit по известным URL, просматривайте новые, лучшие или горячие публикации сабреддитов либо ищите обсуждения по ключевому слову и периоду публикации.

Pinterest API

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