TikTok Hashtag Views
Страница хештега TikTok сводит все публичные видео с этим тегом в два накопительных итога: сколько видео его используют и сколько просмотров эти видео набрали. Вместе они показывают, насколько велика и насыщена тема, а число просмотров на одно видео подсказывает, насколько хорошо обычно работает контент под этим тегом.
Возможности TikTok Hashtag Views API
- До 20 хештегов в одном запросеОтправьте от 1 до 20 названий с # или без него и получите по одной записи для каждого существующего хештега.
- Итоги в виде целых чиселmetrics.posts_count и metrics.views_count возвращаются обычными целыми числами, а не сокращенными строками, поэтому их можно сразу сортировать и делить.
- ID хештега и ссылка на его страницуid содержит числовой ID хештега в TikTok, а url — страницу тега, поэтому у каждой записи есть ключ для объединения данных разных запусков.
Параметры TikTok Hashtag Views API
| Параметры | Обязательный | Описание |
|---|---|---|
hashtags | Обязательный | От 1 до 20 названий хештегов с префиксом # или без него. |
Как использовать TikTok Hashtag Views API
Отправьте список хештегов и получите по одной записи на каждый тег.
- Отправьте {"hashtags": ["cooking", "booktok"]} методом POST на /v1/tiktok/hashtag-detail.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте name, metrics.posts_count и metrics.views_count каждого хештега из results.items.
curl -X POST "https://api.socq.ai/v1/tiktok/hashtag-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtags":["cooking","booktok"]}'
# metrics.posts_count is the video count; metrics.views_count is the total views.Сценарии использования TikTok Hashtag Views API
- Отбор хештегов для кампании: Передайте теги-кандидаты в одном запросе и сравните posts_count как меру конкуренции с views_count как мерой охвата, прежде чем выбрать набор.
- Мониторинг брендового хештега: Регулярно получайте данные по хештегу своей кампании и стройте график роста числа видео и общего числа просмотров после каждой активности.
- Оценка размера темы: Получайте данные по тегам, которые определяют нишу, тренд или общественную тему, и сравнивайте их итоги, чтобы понять, где сосредоточен контент по этой теме.
Практические советы по TikTok Hashtag Views API
- Не суммируйте views_count разных хештегов, чтобы оценить размер темы: видео с несколькими такими тегами учитывается под каждым из них; сравнивайте теги между собой или берите самый крупный.
- Делите views_count на posts_count, только если posts_count есть и больше нуля, а затем ранжируйте теги по среднему числу просмотров на видео, чтобы сравнивать теги очень разного размера.
- Сохраняйте каждый результат с его временем collected_at, когда отслеживаете тег: каждый запрос возвращает текущие итоги, поэтому рост виден, только если вы храните прежние снимки.
- Сопоставляйте результаты со списком на входе по name или id, а не по позиции: несуществующий хештег пропускается, и результатов может оказаться меньше, чем входных значений.
Связанные API
Помимо TikTok Hashtag Views API, используйте эти API, когда нужен другой тип публичных данных TikTok.
- TikTok Hashtags API — Собирайте публичные видео, авторов, медиа, звук и вовлеченность по заданным хештегам.
- TikTok Search API — Ищите публичные видео по ключевому слову с поддерживаемой сортировкой и фильтрами по дате публикации.
- TikTok Live Room Info API — Получайте данные об одном известном прямом эфире по паре ID эфира и владельца: статус, контекст владельца, обложка и число зрителей.
- TikTok Search Users API — Ищите публичные аккаунты TikTok по ключевому слову.
- TikTok Top Search API — Ищите видео и фотопосты по ключевому слову: подписи, авторы и счетчики взаимодействий.
- TikTok Trending Searches API — Получайте сегодняшние популярные поисковые запросы TikTok в порядке рейтинга.
- TikTok Profiles API
- TikTok Comments API
- TikTok Videos API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API