tiktok/
live-ranking

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

TikTok Live Ranking API

Без входных данных
До 99 ведущих
Балл на основе подарков
0,5 кредита за запрос
Готово
Готово

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

README

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

TikTok Live Ranking

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

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

  • Весь рейтинг без параметровЗапрос не требует входных данных и возвращает текущий дневной рейтинг — до 99 ведущих, у каждого из которых указано место.
  • Балл рядом с размером аудиторииscore — это значение рейтинга на основе подарков, а followers_count — общее число подписчиков ведущего, поэтому поддержку и аудиторию можно сравнить без дополнительного запроса.
  • Данные о ведущем в каждой строкеauthor содержит ID пользователя, имя пользователя, отображаемое имя, ссылку на профиль и аватар ведущего.

Параметры TikTok Live Ranking API

Можно отправлять

Этому эндпоинту не нужны параметры запроса. Отправьте пустой JSON-объект как есть.

{}

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

Отправьте пустой запрос и прочитайте список ведущих по местам.

  1. Отправьте {} методом POST на /v1/tiktok/live-ranking.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте ведущих из results.items и передавайте обратно results.next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/tiktok/live-ranking" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

# Each item has rank, score, author and followers_count.

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

  • Отслеживание рейтинга в течение дня: Получайте рейтинг в фиксированные часы и стройте график места и балла каждого ведущего, чтобы видеть, кто поднимается и когда меняется порядок.
  • Поиск ведущих для агентств и спонсоров: Разделите score на followers_count, чтобы найти ведущих, зрители которых дарят много относительно размера аудитории, и включите их в шорт-лист для подписания контракта или спонсорства.

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

  • Запускайте сбор каждый день в одно и то же время: балл, полученный в полдень, и балл, полученный в полночь, охватывают разные части одного дня.
  • В рейтинге нет статуса эфира. Сопоставьте ведущих по author.id и передайте их имена пользователей в TikTok User Live, чтобы увидеть, кто сейчас в эфире.

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

  • TikTok Profiles API — Получайте по имени пользователя публичные данные профиля, описание, признаки аккаунта и счетчики аудитории.
  • TikTok Followers List API — Собирайте нормализованные профили из публичных списков подписчиков с сохраненным контекстом источника и поддерживаемыми метриками.
  • TikTok Following List API — Собирайте публичные профили, на которые подписаны аккаунты TikTok: нормализованные данные аккаунта, описания, видимые метрики и контекст исходного аккаунта.
  • TikTok User Live API — Проверяйте, ведут ли пользователи прямой эфир, и получайте доступные данные эфира.
  • TikTok Audience Demographics API — Узнавайте по имени пользователя, из каких стран подписчики автора и какую долю аудитории дает каждая страна.
  • TikTok Live Search API — Находите по ключевому слову прямые эфиры, которые идут сейчас: ведущие, названия и текущее число зрителей.

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

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

TikTok Live Ranking API — FAQ

TikTok Live Ranking API — это программный интерфейс для получения дневного рейтинга ведущих прямых эфиров TikTok, которому не нужны входные данные. Он возвращает до 99 ведущих, у каждого из которых есть место в рейтинге, балл на основе подарков, ID пользователя, имя пользователя, отображаемое имя и число подписчиков.

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

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

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

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