tiktok/
hashtag-detail

Узнавайте за один запрос, сколько видео и сколько просмотров в сумме набрали до 20 хештегов TikTok, а также ID и ссылку на страницу каждого хештега для сравнения.

TikTok Hashtag Views API

До 20 хештегов
Общее число просмотров
Число видео
0,5 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

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

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

Отправьте список хештегов и получите по одной записи на каждый тег.

  1. Отправьте {"hashtags": ["cooking", "booktok"]} методом POST на /v1/tiktok/hashtag-detail.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте 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, а не по позиции: несуществующий хештег пропускается, и результатов может оказаться меньше, чем входных значений.

Помимо 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 с публичными данными других поддерживаемых соцсетей.

TikTok Hashtag Views API — FAQ

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

Отправьте название хештега и читайте metrics.views_count для общего числа просмотров и metrics.posts_count для числа видео с этим тегом. Оба значения — накопительные показатели для хештега в целом.

Ответ содержит metrics.views_count рядом с metrics.posts_count для каждого хештега, а счетчик, который TikTok не сообщает для тега, возвращается как null.

До 20, с # или без него. Каждый существующий хештег возвращает собственную запись, поэтому весь короткий список можно сравнить по одному результату.

Он не попадает в результаты и не оплачивается, а остальные хештеги из запроса всё равно возвращаются. Запрос, в котором нет ни одного существующего хештега, ничего не стоит.

Эндпоинт возвращает текущие итоги со временем collected_at, без истории. Запускайте его по расписанию и сохраняйте каждый снимок, чтобы строить график роста.

Нет, только итоговые показатели и идентификаторы хештега. Чтобы собрать сами видео, используйте TikTok Hashtags.

За каждый существующий хештег — по 0,5 кредита. Поэтому список из 20 существующих тегов стоит 10 кредитов, а запрос без совпадений ничего не стоит.