tiktok-creative-center/
trending-hashtags

Получайте рейтинг трендовых хештегов страны в TikTok Creative Center с числом публикаций и просмотров и ежедневной кривой популярности за 7, 30 или 90 дней.

TikTok Creative Center Trending Hashtags API

Рейтинги по странам
7, 30 или 90 дней
Ежедневная кривая популярности
0,5 кредита за результат
Готово
README

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

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

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

  1. Отправьте {"country": "US", "time_range": "7d", "results_limit": 20} методом POST на /v1/tiktok-creative-center/trending-hashtags.
  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/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, поскольку каждый запрос оплачивается по числу возвращенных строк.

Помимо 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 с демографией подписчиков, медианными просмотрами и стартовыми ставками.

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

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

TikTok Creative Center Trending Hashtags API — FAQ

TikTok Creative Center Trending Hashtags API — это программный интерфейс для получения хештегов, которые TikTok Creative Center относит к трендовым в стране за 7, 30 или 90 дней. Он возвращает позицию, число публикаций и просмотров и ежедневную кривую популярности каждого хештега.

Передайте country в виде двухбуквенного кода, например US, GB или JP; по умолчанию используется US, и у каждого рынка свой рейтинг. Рынок без опубликованного рейтинга возвращает ноль результатов, и плата не списывается.

Используйте 7d для того, что набирает популярность прямо сейчас, и 90d для тегов, которые удерживают внимание месяцами. Каждый период — отдельный список, поэтому один и тот же хештег может занимать в них разные позиции.

До 100 на страну и период, количество задается через results_limit (по умолчанию 20). Оплата зависит от числа возвращенных строк — по 0,5 кредита за каждую, поэтому полный список из 100 тегов стоит 50 кредитов.

Посмотрите на конец его popularity_curve, где значения от 0 до 100 указаны раз в день. Если ряд продолжает расти в последний день, тег набирает популярность, а если значения снизились после более раннего пика, интерес остывает — независимо от позиции тега.

Нет: запрос принимает только country, time_range и results_limit. Чтобы найти новые хештеги, сохраняйте список каждого дня и сравнивайте id хештегов с предыдущим.

TikTok не публикует расписание обновлений. Кривая популярности меняется с шагом в один день, и каждая запись содержит collected_at, поэтому для отслеживания достаточно одного запроса на страну в день.

Нет. Единственные необходимые учетные данные — API-ключ SocQ.