douyin/
live-room-detail

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

Douyin Live Room Detail API

Поиск известного эфира
Данные о ведущем
Снимок аудитории
0,1 кредита за запрос
Готово
Готово

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

README

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

Douyin Live Room Detail

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

Возможности Douyin Live Room Detail API

  • Данные известного эфираПревращает один известный числовой room_id не более чем в одну нормализованную запись live_room за один запрос к источнику без пагинации источника.
  • Эфир и ведущийХранит доступные название эфира, статус, данные о ведущем, URL источника и время сбора вместе в одной единообразной структуре.
  • Снимок видимых показателей трансляцииФиксирует доступное число зрителей и лайков вместе с публичными медиафайлами, чтобы получить срез эфира с меткой времени.

Параметры Douyin Live Room Detail API

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

Как использовать Douyin Live Room Detail API

Начните с известного числового ID эфира, отправьте асинхронную задачу на получение данных и прочитайте ее нормализованный сохраненный результат.

  1. Получите room_id из контекста прямого эфира, где виден числовой идентификатор; этот эндпоинт не ищет ID эфиров.
  2. Отправьте идентификатор методом POST на /v1/douyin/live-room-detail в виде непустой строки только из цифр.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. Читайте data.results.items из /v1/tasks/{task_id}?limit=50; найденный эфир дает не более одного элемента, а next_cursor относится только к пагинации сохраненных результатов SocQ.
# Set DOUYIN_ROOM_ID to a known numeric room_id before sending.
curl -X POST "https://api.socq.ai/v1/douyin/live-room-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"room_id\":\"${DOUYIN_ROOM_ID}\"}"

# Poll GET /v1/tasks/{task_id}, then read data.results.items from /v1/tasks/{task_id}?limit=50.

Сценарии использования Douyin Live Room Detail API

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

Практические советы по Douyin Live Room Detail API

  • Передавайте room_id строкой в кавычках только из цифр, а не числом JavaScript, чтобы длинный идентификатор сохранил все цифры.
  • Получите известный room_id до вызова эндпоинта: запрос извлекает данные эфира, а не ищет прямые эфиры.
  • Храните отправленный room_id в своей записи: канонический результат live_room не гарантирует, что источник вернет его в поле id.
  • Считайте название, статус, автора, метрики, медиафайлы, URL и метки времени допускающими null: источник может не отдавать отдельные публичные поля.
  • Не передавайте results_limit или курсор источника; next_cursor, если он есть, разбивает на страницы сохраненные результаты SocQ, а не запрос к поставщику.

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

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

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

Douyin Live Room Detail API — FAQ

Douyin Live Room Detail API получает один известный публичный прямой эфир по его числовому room_id. Он возвращает доступные поля эфира, ведущего, медиафайлов, аудитории и времени сбора в виде нормализованной записи на определенный момент.

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

Валидатор требует строку, соответствующую формату ID эфира только из цифр. Кроме того, текстовое значение не дает числовым клиентам округлять длинные ID.

Нормализованная запись может включать title, status, author, URL, медиафайлы, видимые viewers_count и likes_count, created_at и collected_at. Любое необязательное поле источника может быть null или отсутствовать.

Нет. Он выполняет один запрос на получение данных и возвращает не более одной нормализованной записи; next_cursor в результатах задачи — это лишь стандартный курсор для уже сохраненных элементов SocQ.

За успешную задачу списывается фиксированная плата 0,10 кредита SocQ. Сумма не зависит от числа результатов или настроек пагинации.