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
Свяжите идентификаторы одного известного активного эфира, отправьте асинхронный запрос и прочитайте нормализованный снимок из результатов задачи.
- Получите room_id из источника, который показывает текущий прямой эфир TikTok, а соответствующий user_id владельца — из того же контекста или из результата TikTok Profiles.
- Отправьте оба непустых строковых идентификатора методом POST на /v1/tiktok/live-room-info.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- Читайте 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 пуст.
Связанные API
Помимо 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 Comments API
- TikTok Videos API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API