tiktok-creative-center/
trending-hashtag-detail

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

TikTok Creative Center Hashtag Insights API

Ввод по ID хештега
Ведущие страны
Примеры видео
0,5 кредита за запрос
Готово
README

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

TikTok Creative Center Hashtag Insights

Аналитика хештега в Creative Center описывает один трендовый тег на рынке: число публикаций и просмотров, ежедневную кривую популярности, страны, где он наиболее популярен с учетом их размера, и примеры видео с этим тегом. Вместе эти данные показывают, как развивается тренд, где еще он находит отклик и какой контент его продвигает.

Возможности TikTok Creative Center Hashtag Insights API

  • Один тег по IDhashtag_id принимает id результата Trending Hashtags и возвращает одну запись по этому тегу для выбранных country и time_range.
  • Кривая и счетчики за периодpopularity_curve содержит по одному значению с датой на каждый день в диапазоне от 0 до 100, а рядом — metrics.posts_count и metrics.views_count.
  • Страны, ранжированные по оценкеtop_countries перечисляет country_code и score по убыванию оценки, которая отражает популярность с учетом размера страны.
  • ID примеров видеоvideo_ids перечисляет видео с этим тегом и показывает, на каком контенте строится тренд.

Параметры TikTok Creative Center Hashtag Insights API

ПараметрыОбязательныйОписание
hashtag_idОбязательныйID хештега из результата TikTok Creative Center Trending Hashtags.
countryНеобязательныйДвухбуквенный код страны рынка, например US, GB или JP. По умолчанию US.
time_rangeНеобязательныйПериод анализа: 7d (по умолчанию), 30d или 90d.

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

Возьмите ID хештега из трендового рейтинга и получите его аналитику.

  1. Соберите хештеги через TikTok Creative Center Trending Hashtags и скопируйте id.
  2. Отправьте {"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"} методом POST на /v1/tiktok-creative-center/trending-hashtag-detail.
  3. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded, и читайте единственную запись в results.items.
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtag-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtag_id":"7155204034885287979","country":"US","time_range":"7d"}'

# top_countries lists {country_code, score}; video_ids lists example videos.

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

  • Решение, стоит ли запускаться на тренде: Изучите popularity_curve и счетчики в metrics, прежде чем строить кампанию вокруг тега, и проверьте, растет ли кривая в последний день.
  • Отбор рынков для расширения: По top_countries смотрите, в каких других странах самая высокая оценка у тега, который в тренде на вашем рынке, и включайте их в короткий список для локализованных публикаций.

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

  • Передавайте те же country и time_range, что и в рейтинге, из которого взят id, чтобы показатели описывали тот список, где вы выбрали тег.
  • Не воспринимайте top_countries как рейтинг по объему: оценка зависит от размера страны, поэтому небольшой рынок может оказаться выше крупного.

Помимо TikTok Creative Center Hashtag Insights 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 Top Videos API — Получайте чарт самых успешных видео страны с просмотрами и коэффициентом вовлеченности.
  • TikTok Creator Marketplace API — Получайте карточки Creator Marketplace с демографией подписчиков, медианными просмотрами и стартовыми ставками.

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

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

TikTok Creative Center Hashtag Insights API — FAQ

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

Из поля id результата Trending Hashtags, полученного в рейтинге той страны, по которой вы будете отправлять запрос. Это числовая строка из 5–32 цифр, а любой другой формат отклоняется с ошибкой 400.

Не здесь: этот эндпоинт принимает только числовой ID. Чтобы получить число видео и общее число просмотров тега по названию, используйте TikTok Hashtag Views API.

top_countries и video_ids, которые в строках рейтинга равны null. Здесь rank равен null, потому что позиция относится к рейтингу, поэтому сохраняйте rank из результата Trending Hashtags.

Она показывает, насколько хештег популярен в стране с учетом размера этой страны, а список отсортирован по убыванию оценки. Поэтому небольшой рынок может обойти крупный.

Задача завершится с ошибкой, и кредиты вернутся полностью. Успешный запрос оплачивается один раз — 0,5 кредита, сколько бы video_ids ни вернулось.