TikTok Live Ranking
Дневной рейтинг прямых эфиров TikTok — это таблица лидеров среди ведущих за текущий день, упорядоченная по баллу, который складывается из подарков зрителей во время трансляций, и в каждой строке указаны место ведущего, его балл и число подписчиков. По рейтингу видно, каких ведущих зрители поддерживают сегодня, как меняются верхние позиции и какие небольшие аккаунты получают больше поддержки, чем можно ожидать при их размере аудитории.
Возможности TikTok Live Ranking API
- Весь рейтинг без параметровЗапрос не требует входных данных и возвращает текущий дневной рейтинг — до 99 ведущих, у каждого из которых указано место.
- Балл рядом с размером аудиторииscore — это значение рейтинга на основе подарков, а followers_count — общее число подписчиков ведущего, поэтому поддержку и аудиторию можно сравнить без дополнительного запроса.
- Данные о ведущем в каждой строкеauthor содержит ID пользователя, имя пользователя, отображаемое имя, ссылку на профиль и аватар ведущего.
Параметры TikTok Live Ranking API
Можно отправлять
Этому эндпоинту не нужны параметры запроса. Отправьте пустой JSON-объект как есть.
{}Как использовать TikTok Live Ranking API
Отправьте пустой запрос и прочитайте список ведущих по местам.
- Отправьте {} методом POST на /v1/tiktok/live-ranking.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте ведущих из 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, чтобы увидеть, кто сейчас в эфире.
Связанные API
Помимо 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 Hashtags API
- TikTok Comments API
- TikTok Videos API
- TikTok Search API
- TikTok Comment Replies API
- TikTok User Videos API
- TikTok Live Room Info API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API