TikTok Creative Center Trending Hashtags
Трендовые хештеги Creative Center — это рейтинг тегов, которые привлекают больше всего внимания в стране за последние 7, 30 или 90 дней, с позицией, числом публикаций, просмотрами и посуточной кривой популярности для каждого. Рейтинг показывает, какие темы набирают обороты на рынке, насколько резко вырос каждый тег и к каким трендам стоит присоединиться, пока они еще на подъеме.
Возможности TikTok Creative Center Trending Hashtags API
- Отдельный рейтинг для каждой страныcountry принимает двухбуквенный код, например US, GB или JP, и для каждого рынка возвращается собственный порядок позиций.
- Списки за 7, 30 и 90 днейtime_range выбирает период, за который строится рейтинг, и у каждого периода свой список.
- Число публикаций и просмотровmetrics.posts_count и metrics.views_count показывают объем, который Creative Center сообщает для каждого тега.
- Ежедневная кривая популярностиpopularity_curve возвращает по одному значению с датой на каждый день по шкале от 0 до 100, поэтому динамика тега приходит вместе со строкой рейтинга.
- Название, ссылка и ID тегаКаждая строка содержит name без #, url вида tiktok.com/tag и id, который Hashtag Insights принимает как hashtag_id.
Параметры TikTok Creative Center Trending Hashtags API
| Параметры | Обязательный | Описание |
|---|---|---|
country | Необязательный | Двухбуквенный код страны рынка, например US, GB или JP. По умолчанию US. |
time_range | Необязательный | Период рейтинга: 7d (по умолчанию), 30d или 90d. |
results_limit | Необязательный | Сколько хештегов вернуть: от 1 до 100. По умолчанию 20. |
Как использовать TikTok Creative Center Trending Hashtags API
Выберите страну и период, а затем прочитайте рейтинг.
- Отправьте {"country": "US", "time_range": "7d", "results_limit": 20} методом POST на /v1/tiktok-creative-center/trending-hashtags.
- Опрашивайте 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/trending-hashtags" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country":"US","time_range":"7d","results_limit":20}'
# Each item has rank, metrics and a dated popularity_curve.Сценарии использования TikTok Creative Center Trending Hashtags API
- Ежедневное отслеживание новичков рейтинга: Сохраняйте список каждого дня с его collected_at и сравнивайте id с предыдущим снимком, чтобы видеть, какие хештеги вошли в рейтинг страны или выбыли из него.
- Короткие списки хештегов по рынкам: Запрашивайте один и тот же time_range для каждой целевой страны и сопоставляйте списки, чтобы выбрать теги для каждой локализованной кампании.
- Всплеск или устойчивый интерес: Сравните списки 7d и 90d одной страны: теги, которые есть только в коротком списке, — это недельные всплески, а теги с высокими позициями в обоих удерживают внимание месяцами.
Практические советы по TikTok Creative Center Trending Hashtags API
- Сохраняйте каждый снимок с его country, time_range и collected_at, потому что позиция имеет смысл только внутри того списка, из которого она взята.
- Используйте те же country и time_range, когда передаете id в Hashtag Insights.
- Получите сразу все 100 строк и фильтруйте их локально, а не повторяйте запросы с разными значениями results_limit, поскольку каждый запрос оплачивается по числу возвращенных строк.
Связанные API
Помимо TikTok Creative Center Trending Hashtags API, используйте эти API, когда нужен другой тип публичных данных TikTok Creative Center.
- TikTok Creative Center Top Ads API — Просматривайте самую эффективную рекламу по ключевому слову и периоду: подписи, CTR, лайки и видео объявления.
- TikTok Creative Center Ad Analysis API — Разбирайте одно популярное объявление посекундно по кривым CTR и удержания.
- TikTok Creative Center Hashtag Insights API — Изучайте кривую популярности одного трендового хештега, ведущие страны и примеры видео.
- TikTok Creative Center Top Videos API — Получайте чарт самых успешных видео страны с просмотрами и коэффициентом вовлеченности.
- TikTok Creator Marketplace API — Получайте карточки Creator Marketplace с демографией подписчиков, медианными просмотрами и стартовыми ставками.