tiktok/
search-live

Ищите прямые эфиры TikTok по ключевому слову и получайте трансляции, которые идут прямо сейчас: ID эфира, ID ведущего, название, текущее число зрителей, лайки и время начала — всё готово для запросов к товарам эфира.

TikTok Live Search API

Поиск по ключевому слову
Только идущие эфиры
ID эфира и ведущего
0,6 кредита за результат
Готово
Готово

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

README

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

TikTok Live Search

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

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

  • На входе ключевое слово, на выходе идущие эфирыquery принимает одно ключевое слово и возвращает трансляции, которые идут в этот момент, у каждой из них status равен live.
  • ID эфира и ID ведущего в одной записиid — это ID эфира, а author.id — ID пользователя ведущего: именно эти два значения нужны TikTok Live Shopping, чтобы получить список товаров эфира.
  • Аудитория на момент сбораmetrics.viewers_count показывает, сколько человек находится в эфире, а metrics.likes_count — сколько лайков он набрал, с меткой времени collected_at.
  • Название, время начала, обложка и страница эфираВ каждой записи есть название трансляции, время ее начала в published_at, обложка в media и ссылка на страницу эфира ведущего в url, а также имя пользователя, отображаемое имя и аватар ведущего.

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

ПараметрыОбязательныйОписание
queryОбязательныйКлючевое слово, по которому ищутся прямые эфиры.
results_limitНеобязательныйСколько эфиров вернуть, от 1 до 200. По умолчанию 20.

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

Выполните поиск по ключевому слову и прочитайте эфиры, которые идут сейчас.

  1. Отправьте {"query": "deals", "results_limit": 20} методом POST на /v1/tiktok/search-live.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте эфиры из results.items и передавайте обратно results.next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/tiktok/search-live" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"deals","results_limit":20}'

# id is the room ID; author.id is the host ID for TikTok Live Shopping.

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

  • Разведка эфирных продаж конкурентов: Ищите по товарным словам, которые продавцы произносят в эфире, например deals, а затем передайте id и author.id каждого эфира в TikTok Live Shopping, чтобы узнать, что лежит в корзине.
  • Подсчет эфиров вокруг ключевого слова: Запускайте один и тот же query по расписанию и записывайте, сколько эфиров идет и каков их viewers_count, чтобы видеть, когда тема или бренд собирает аудиторию в прямых эфирах.
  • Шорт-лист ведущих для коллабораций: Соберите ведущих, которые выходят в эфир на вашу тему, и отсортируйте их по viewers_count и likes_count, прежде чем связываться с ними.

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

  • Ищите по нескольким формулировкам одной ниши и объединяйте списки по id: каждое ключевое слово возвращает свой набор эфиров, а один эфир может совпасть с несколькими словами.
  • Храните id и author.id отдельно: id обозначает одну трансляцию, а author.id — ведущего, поэтому следите за ведущим в разные дни по author.id.
  • Чтобы отслеживать число зрителей одного эфира во времени, перейдите от повторных поисков к TikTok Live Room Info с этими room_id и user_id.

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

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

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

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

TikTok Live Search API — FAQ

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

Передайте id результата как room_id, а его author.id как user_id в TikTok Live Shopping. Оба значения должны быть из одного и того же результата.

results_limit принимает значения от 1 до 200, по умолчанию 20, и список заканчивается раньше, если подходящих эфиров меньше. Каждый возвращенный эфир стоит 0,6 кредита, а поиск без совпадений не тарифицируется.

Нет. В списке только трансляции, которые идут в момент отправки поиска, и у каждой записи status равен live. Прошедшие эфиры не возвращаются.

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

Запрос принимает только query и results_limit. Читайте metrics.viewers_count в результатах и фильтруйте на своей стороне.

Этот эндпоинт ищет по ключевому слову. Для известного аккаунта используйте TikTok User Live: он принимает имена пользователей и сообщает статус эфира для каждого.