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
Сначала сформулируйте исследовательский вопрос, а затем выберите ключевое слово, цель ранжирования и период публикации.
- Превратите тему исследования в конкретный query и выберите results_limit, sort_by и published_within.
- Отправьте запрос методом POST на /v1/tiktok/search и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в статус succeeded или failed.
- Читайте 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, по которым видео было найдено.
- Повторяйте ключевые запросы по расписанию, чтобы сравнивать изменения в составе авторов, темах и вовлеченности.
Связанные API
Помимо 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 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 Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API