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 хештега из трендового рейтинга и получите его аналитику.
- Соберите хештеги через TikTok Creative Center Trending Hashtags и скопируйте id.
- Отправьте {"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"} методом POST на /v1/tiktok-creative-center/trending-hashtag-detail.
- Опрашивайте 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 как рейтинг по объему: оценка зависит от размера страны, поэтому небольшой рынок может оказаться выше крупного.
Связанные API
Помимо 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 с демографией подписчиков, медианными просмотрами и стартовыми ставками.