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 эфира, отправьте асинхронную задачу на получение данных и прочитайте ее нормализованный сохраненный результат.
- Получите room_id из контекста прямого эфира, где виден числовой идентификатор; этот эндпоинт не ищет ID эфиров.
- Отправьте идентификатор методом POST на /v1/douyin/live-room-detail в виде непустой строки только из цифр.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- Читайте 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, а не запрос к поставщику.
Связанные API
Помимо Douyin Live Room Detail API, используйте эти API, когда нужен другой тип публичных данных Douyin.