tiktok/
search-insights

Получайте данные TikTok Creator Search Insights по языку и категории: популярные поисковые запросы с индексом популярности 0–100, трендом из семи точек, числом видео и фильтром пробелов в контенте.

TikTok Creator Search Insights API

Индекс популярности
Фильтр пробелов в контенте
12 языков
1 кредит за запрос
Готово
Готово

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

README

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

TikTok Creator Search Insights

Creator Search Insights — это список TikTok с тем, что ищут пользователи: каждому поисковому запросу присваивается индекс популярности от 0 до 100, короткая линия тренда и число уже снятых по нему видео. Запросы, которые ищут часто, но по которым мало видео, помечаются как пробелы в контенте, и это показывает авторам и брендам, где спрос опережает предложение и растет интерес или угасает.

Возможности TikTok Creator Search Insights API

  • Популярность по шкале от 0 до 100popularity оценивает каждый поисковый запрос относительно остальных в списке TikTok, поэтому запросы можно напрямую ранжировать друг относительно друга.
  • Тренд из семи точекpopularity_trend возвращает семь последних значений, от самого раннего к самому новому, по той же шкале от 0 до 100, что и popularity.
  • Фильтр пробелов в контентеЕсли задать filter_by равным content_gap, вернутся поисковые запросы с высоким интересом и малым числом видео, а в labels у них будет content_gap.
  • Спрос рядом с предложениемvideos_count — это число видео, которые TikTok связывает с поисковым запросом, а category называет его тематическую область, поэтому интерес и конкуренция находятся в одной записи.
  • Двенадцать языков, шесть категорийlanguage принимает en, id, de, es, fr, pt, vi, tr, ar, th, ja или ko, а category сужает список до gaming, fashion, tourism, science, food или sports.

Параметры TikTok Creator Search Insights API

ПараметрыОбязательныйОписание
languageНеобязательныйЯзык возвращаемых поисковых запросов. По умолчанию en.
categoryНеобязательныйОграничьте поисковые запросы одной тематической категорией: gaming, fashion, tourism, science, food или sports.
filter_byНеобязательныйall — популярные поисковые запросы (по умолчанию), content_gap — поисковые запросы, по которым пока мало видео.

Как использовать TikTok Creator Search Insights API

Выберите язык, категорию и фильтр, затем прочитайте поисковые запросы.

  1. Отправьте {"language": "en", "category": "food", "filter_by": "content_gap"} методом POST на /v1/tiktok/search-insights.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Прочитайте 20 поисковых запросов из results.items в том порядке, в котором их показывает TikTok.
curl -X POST "https://api.socq.ai/v1/tiktok/search-insights" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"language":"en","category":"food","filter_by":"content_gap"}'

# popularity is 0-100; popularity_trend lists recent scores oldest first.

Сценарии использования TikTok Creator Search Insights API

  • Планирование видео вокруг пробелов в контенте: Получите поисковые запросы content_gap для своей категории и выберите те, у которых высокая popularity и низкий videos_count.
  • Еженедельный отчет по темам: Запускайте сбор по каждой категории по расписанию и сохраняйте списки, чтобы видеть, какие поисковые запросы появляются, поднимаются или выпадают от недели к неделе.
  • Сравнение аудиторий по языкам: Запросите одну и ту же категорию на двух или трех языках, чтобы до локализации контента увидеть, какие темы лидируют на каждом рынке.
  • Ключевые слова для SEO в TikTok: Используйте keyword каждого результата в подписях, тексте на экране и названиях видео, которые вы снимаете по этому списку.

Практические советы по TikTok Creator Search Insights API

  • Сравнивайте popularity в пределах одного ответа и рассматривайте каждое сочетание языка и категории как отдельный список.
  • Сохраняйте collected_at при каждом сборе. Эндпоинт возвращает только текущий список, поэтому изменения от недели к неделе видны лишь по сохраненным вами снимкам.
  • Отправьте перспективное ключевое слово в TikTok Search, чтобы прочитать видео, которые уже ранжируются по нему, прежде чем решать, чем выделиться.

Помимо TikTok Creator Search Insights API, используйте эти API, когда нужен другой тип публичных данных TikTok.

  • TikTok Hashtags API — Собирайте публичные видео, авторов, медиа, звук и вовлеченность по заданным хештегам.
  • TikTok Search API — Ищите публичные видео по ключевому слову с поддерживаемой сортировкой и фильтрами по дате публикации.
  • TikTok Live Room Info API — Получайте данные об одном известном прямом эфире по паре ID эфира и владельца: статус, контекст владельца, обложка и число зрителей.
  • TikTok Search Users API — Ищите публичные аккаунты TikTok по ключевому слову.
  • TikTok Hashtag Views API — Узнавайте общее число видео и просмотров по хештегам — до 20 хештегов за один запрос.
  • TikTok Trending Searches API — Получайте сегодняшние популярные поисковые запросы TikTok в порядке рейтинга.

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

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

TikTok Creator Search Insights API — FAQ

TikTok Creator Search Insights API — это программный интерфейс для получения популярных поисковых запросов из TikTok Creator Search Insights с фильтрацией по языку, категории и пробелам в контенте. Для каждого поискового запроса он возвращает индекс популярности, тренд из семи точек, число видео, категорию и метки.

Нет. popularity — это относительный индекс от 0 до 100 для ранжирования поисковых запросов друг относительно друга, и он не показывает, сколько раз выполнялся поиск.

Это поисковый запрос, который пользователи вводят часто, но по которому пока относительно мало видео. Задайте filter_by равным content_gap, с категорией или без нее, и в списке останутся только такие запросы.

Смотрите popularity_trend: там семь значений от самого раннего к самому новому. Если последнее значение выше первого, интерес растет, а если ниже — он остыл.

Нет. Эндпоинт возвращает поисковые запросы, которые TikTok показывает для выбранных языка, категории и фильтра, а не ищет по заданному слову. Чтобы увидеть, что уже ранжируется по слову, отправьте его в TikTok Search.

language принимает en, id, de, es, fr, pt, vi, tr, ar, th, ja и ko, по умолчанию en. category принимает gaming, fashion, tourism, science, food и sports и необязателен.

Каждый вызов эндпоинта возвращает 20 поисковых запросов за фиксированный 1 кредит. Чтобы увидеть больше, измените language, category или filter_by: у каждого сочетания свой список.

Нет. Для запроса нужны только ваш API-ключ и необязательные значения language, category и filter_by, вход в TikTok не используется.