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
Выберите страну, период и метрику, а затем прочитайте чарт.
- Отправьте {"country": "US", "period": "daily", "results_limit": 20} методом POST на /v1/tiktok-creative-center/top-videos.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте видео из 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 за запрос.
Связанные API
Помимо 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 с демографией подписчиков, медианными просмотрами и стартовыми ставками.