tiktok/
live-room-info

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

TikTok Live Room Info API

Известный эфир
Снимок аудитории
Контекст владельца
0,5 кредита за результат
Готово
Готово

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

README

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

TikTok Live Room Info

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

Возможности TikTok Live Room Info API

  • Поиск по паре ID эфира и владельцаНаходит один известный прямой эфир по room_id и соответствующему user_id владельца и возвращает не более одной нормализованной записи live_room.
  • Контекст эфира и владельцаВозвращает текущее название и статус эфира вместе с публичным ID, именем пользователя и отображаемым именем владельца.
  • Снимок аудитории и обложкиФиксирует видимое число зрителей, число лайков, публичную обложку и метку времени сбора для интерпретации на определенный момент.

Параметры TikTok Live Room Info API

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

Как использовать TikTok Live Room Info API

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

  1. Получите room_id из источника, который показывает текущий прямой эфир TikTok, а соответствующий user_id владельца — из того же контекста или из результата TikTok Profiles.
  2. Отправьте оба непустых строковых идентификатора методом POST на /v1/tiktok/live-room-info.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. Читайте data.results.items из /v1/tasks/{task_id}?limit=50; найденный эфир дает не более одной записи, а стандартный next_cursor используется, только если results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/tiktok/live-room-info" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"room_id":"7523685855395842871","user_id":"6742945285876515845"}'

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

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

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

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

  • Передавайте room_id вместе с user_id владельца из того же активного эфира; несоответствие эфира и пользователя может привести к пустому результату или к ошибке источника для этих входных данных.
  • Храните оба идентификатора как строки, чтобы большие числовые ID TikTok не округлялись клиентом или базой данных.
  • Выполняйте запрос, пока эфир должен идти, а пустой результат считайте признаком завершенного, недоступного, некорректного или несовпадающего эфира, а не найденной записью офлайн-эфира.
  • Используйте collected_at как время наблюдения для статуса и метрик; в нормализованной записи created_at равен null, а url пуст.

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

  • TikTok Profiles API — Получайте по имени пользователя публичные данные профиля, описание, признаки аккаунта и счетчики аудитории.
  • TikTok Hashtags API — Собирайте публичные видео, авторов, медиа, звук и вовлеченность по заданным хештегам.
  • TikTok Search API — Ищите публичные видео по ключевому слову с поддерживаемой сортировкой и фильтрами по дате публикации.
  • TikTok User Videos API — Собирайте публичные видео из ленты профиля по имени пользователя: подписи, авторы, медиа, метки времени, вовлеченность и контекст исходного аккаунта.
  • TikTok Search Users API — Ищите публичные аккаунты TikTok по ключевому слову.
  • TikTok Top Search API — Ищите видео и фотопосты по ключевому слову: подписи, авторы и счетчики взаимодействий.

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

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

TikTok Live Room Info API — FAQ

TikTok Live Room Info API — это программный интерфейс для получения одного известного публичного прямого эфира по его room_id и user_id владельца. Он возвращает название и статус эфира, данные о владельце, обложку, число зрителей и лайков и время сбора в виде снимка на определенный момент.

Используйте источник данных о прямом эфире, который показывает room_id, и передавайте его вместе с числовым user_id владельца эфира. Результат TikTok Profiles может дать user_id в нормализованном поле id, но текущий каталог SocQ для TikTok не находит room_id.

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

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

Это значения на момент сбора запроса, и они могут сразу измениться. Храните collected_at вместе со счетчиками, а не считайте их непрерывным потоком данных.

Каждая сохраненная нормализованная запись эфира стоит 0,5 кредита, базовой платы за задачу нет. Оценка рассчитана на один результат, а за пустой результат плата не взимается.