tiktok/
search

Ищите публичные видео TikTok по ключевому слову с фильтрами по релевантности, дате, лайкам и периоду публикации и получайте нормализованные записи об авторах, контенте, медиа и вовлеченности.

TikTok Search API

Поиск по ключевым словам
Исследовательские выборки
Временные окна
0,7 кредита за результат
Готово
Готово

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

README

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

TikTok Search

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

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

  • Поиск видео по ключевым словамПревращайте ключевое слово темы, бренда, товара или события в набор видео-кандидатов.
  • Сортировка по релевантности и новизнеПереключайтесь между relevance, date и likes, чтобы смотреть на тему с точки зрения релевантности, свежести или числа лайков.
  • Периоды публикацииЗадавайте период исследования значениями day, week, month, three_months или six_months.
  • Поля контента и автораВозвращает поля видео, автора, вовлеченности, хештегов и музыки в единой структуре результатов поиска.
  • Отслеживаемые снимки поискаФиксируйте каждый поисковый эксперимент через search_query и collected_at.

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

ПараметрыОбязательныйОписание
queryОбязательныйОбязательный непустой поисковый запрос по ключевым словам для поиска публичных видео TikTok.
results_limitНеобязательныйПоложительный лимит запрашиваемых видео. По умолчанию 100.
sort_byНеобязательныйПорядок результатов: relevance, date или likes. По умолчанию relevance.
published_withinНеобязательныйНеобязательный период публикации: day, week, month, three_months или six_months.

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

Сначала сформулируйте исследовательский вопрос, а затем выберите ключевое слово, цель ранжирования и период публикации.

  1. Превратите тему исследования в конкретный query и выберите results_limit, sort_by и published_within.
  2. Отправьте запрос методом POST на /v1/tiktok/search и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в статус succeeded или failed.
  4. Читайте data.results.items. Если has_more равно true, продолжайте с next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"space exploration","results_limit":100,"sort_by":"relevance","published_within":"month"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

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

  • Обзор рынка и категорий: Используйте запросы о товарах, категориях и сценариях применения, чтобы составить карту контента TikTok и выборку авторов.
  • Отслеживание динамики событий: Сочетайте date с окном day или week, чтобы следить за свежим контентом вокруг запусков, мероприятий и новостных поводов.
  • Исследование креативов с большим числом лайков: Сортируйте по likes и изучайте повторяющиеся хуки, подписи, выбор музыки и сочетания хештегов.
  • Мониторинг упоминаний бренда: Запускайте запросы по брендам и товарам по расписанию и сохраняйте снимки для контент- и PR-команд.

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

  • Разбивайте широкую тему на запросы о бренде, потребности, поводе и тренде, а затем объединяйте полученные наборы видео.
  • Выбирайте relevance, чтобы составить карту темы, date — чтобы отслеживать новые публикации, и likes — чтобы изучать популярные креативные приемы.
  • Используйте published_within, чтобы выборки оставались в едином временном масштабе, например week для регулярных отчетов.
  • Сохраняйте query, sort_by, published_within и collected_at вместе, чтобы поиск можно было воспроизвести.
  • Удаляйте дубли между запросами по id видео и сохраняйте все search_query, по которым видео было найдено.
  • Повторяйте ключевые запросы по расписанию, чтобы сравнивать изменения в составе авторов, темах и вовлеченности.

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

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

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

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

TikTok Search API — FAQ

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

query — это обязательное непустое ключевое слово или фраза, например бренд, товар, кампания, человек или тема исследования.

relevance упорядочивает результаты по тематической релевантности, date выводит вперед свежие публикации, а likes — видео с наибольшим числом публичных лайков. По умолчанию используется relevance.

published_within принимает day, week, month, three_months и six_months для видео, опубликованных за соответствующий недавний период.

results_limit задает запрашиваемый лимит видео, должен быть положительным целым числом и по умолчанию равен 100.

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

search_query фиксирует запрос, по которому получен результат, а collected_at — время сбора, чтобы снимки поиска можно было отследить.

Каждый возвращенный нормализованный результат поиска видео стоит 0,7 кредита.