tiktok-creative-center/
top-videos

Получайте чарты топовых видео TikTok Creative Center по странам с ранжированием по просмотрам, коэффициенту вовлеченности или доле 6-секундных просмотров, а также органические просмотры и Marketplace ID авторов.

TikTok Creative Center Top Videos API

Чарты по странам
Дневные, недельные, долгосрочные
Просмотры и вовлеченность
0,5 кредита за результат
Готово
Готово

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

README

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

TikTok Creative Center Top Videos

Топовые видео Creative Center — это публикуемые TikTok чарты самых успешных видео в стране, ранжированные по просмотрам, коэффициенту вовлеченности или доле 6-секундных просмотров, с подписью, автором, просмотрами за период чарта, просмотрами за все время и органическими просмотрами каждого видео. Чарты показывают, какие видео завоевывают внимание на рынке, какая часть их охвата органическая и какие авторы регулярно в них попадают.

Возможности TikTok Creative Center Top Videos API

  • Ежедневные, еженедельные и долгосрочные чартыperiod выбирает, какой чарт страны читать, а самый свежий опубликованный выпуск подставляется автоматически.
  • Три метрики ранжированияsort_by упорядочивает чарт по views, engagement_rate или six_second_view_rate.
  • Охват в трех разрезахmetrics отдельно содержит views_count за период чарта, organic_views_count и lifetime_views_count, а рядом — два коэффициента.
  • Идентификация видео и автораКаждая строка содержит caption, url, cover_url и author, а также creator_id — ID Creator Marketplace, который принимает TikTok Creator Marketplace.

Параметры TikTok Creative Center Top Videos API

ПараметрыОбязательныйОписание
countryНеобязательныйДвухбуквенный код страны рынка, например US, GB или JP. По умолчанию US.
periodНеобязательныйКакой чарт читать: daily (по умолчанию), weekly или long_term.
sort_byНеобязательныйМетрика ранжирования: views (по умолчанию), engagement_rate или six_second_view_rate.
results_limitНеобязательныйСколько видео вернуть: от 1 до 100. По умолчанию 20.

Как использовать TikTok Creative Center Top Videos API

Выберите страну, период и метрику, а затем прочитайте чарт.

  1. Отправьте {"country": "US", "period": "daily", "results_limit": 20} методом POST на /v1/tiktok-creative-center/top-videos.
  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-creative-center/top-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"US","period":"daily","sort_by":"views","results_limit":20}'

# creator_id on each item feeds TikTok Creator Marketplace.

Сценарии использования TikTok Creative Center Top Videos API

  • Бенчмаркинг хуков: Ранжируйте чарт страны по six_second_view_rate и изучайте подписи и обложки лидеров, чтобы составить каталог вступлений, которые удерживают зрителей дольше шести секунд.
  • Органический и платный охват: Делите organic_views_count на views_count для каждой строки, чтобы отделить видео, которые выросли сами, от тех, что продвигались в основном за счет платного распространения.
  • Еженедельные снимки рынка: Сохраняйте каждый еженедельный чарт по стране и сравнивайте строки по id, чтобы видеть, какие видео и авторы повторяются, а какие форматы уходят.
  • Короткие списки авторов: Собирайте значения creator_id из строк чарта и отправляйте их без дублей в Creator Marketplace, чтобы получить данные об аудитории и ставках.

Практические советы по TikTok Creative Center Top Videos API

  • Читайте engagement_rate и six_second_view_rate как доли: значение 0.0265 означает 2,65 процента, а не 2,65.
  • rank — это позиция при выбранном sort_by, поэтому сравнивайте позиции только между запусками с одинаковыми country, period и sort_by.
  • Один автор может занимать несколько строк, поэтому объединяйте повторяющиеся creator_id, прежде чем передавать их дальше: Creator Marketplace принимает не более 20 ID за запрос.

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

  • TikTok Creative Center Top Ads API — Просматривайте самую эффективную рекламу по ключевому слову и периоду: подписи, CTR, лайки и видео объявления.
  • TikTok Creative Center Ad Analysis API — Разбирайте одно популярное объявление посекундно по кривым CTR и удержания.
  • TikTok Creative Center Trending Hashtags API — Получайте рейтинг трендовых хештегов страны с числом публикаций, просмотрами и кривыми популярности.
  • TikTok Creative Center Hashtag Insights API — Изучайте кривую популярности одного трендового хештега, ведущие страны и примеры видео.
  • TikTok Creator Marketplace API — Получайте карточки Creator Marketplace с демографией подписчиков, медианными просмотрами и стартовыми ставками.

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

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

TikTok Creative Center Top Videos API — FAQ

TikTok Creative Center Top Videos API — это программный интерфейс для получения чартов самых успешных видео TikTok Creative Center по стране, периоду и метрике ранжирования. Он возвращает позицию, подпись, автора, просмотры за период чарта, органические просмотры и просмотры за все время, коэффициент вовлеченности и долю 6-секундных просмотров каждого видео.

views упорядочивает по охвату за период чарта. engagement_rate упорядочивает по отношению взаимодействий к просмотрам, что выделяет видео, вызывающие реакцию, а six_second_view_rate — по доле просмотров длительностью не менее шести секунд, что указывает на видео с сильным вступлением.

Это самый свежий опубликованный выпуск, который обычно отстает от текущей даты примерно на два дня. Еженедельные чарты заканчиваются воскресеньем.

Учитываются оба вида охвата. views_count — все просмотры за период чарта, а organic_views_count — их часть из неоплачиваемого распространения, поэтому строка, где второе значение намного меньше первого, в основном продвигалась платно.

author.id — это ID пользователя TikTok автора. creator_id — его ID Creator Marketplace, то есть значение, которое принимает TikTok Creator Marketplace.

views_count охватывает только период чарта, поэтому видео, опубликованное несколько месяцев назад, может попасть в рейтинг, пока его еще смотрят. lifetime_views_count показывает общее число просмотров с момента публикации.

Не у каждого рынка есть чарт за каждый период. Задача всё равно завершается успешно с нулем результатов и без списания, поэтому можно бесплатно попробовать другой период или страну; каждая строка существующего чарта стоит 0,5 кредита.