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
Выполните поиск по ключевому слову и прочитайте эфиры, которые идут сейчас.
- Отправьте {"query": "deals", "results_limit": 20} методом POST на /v1/tiktok/search-live.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте эфиры из 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.
Связанные API
Помимо 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 Comments API
- TikTok Videos API
- 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 Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API