tiktok/
live-products

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

TikTok Live Shopping API

ID эфира и ведущего
Товары из корзины эфира
До 500 товаров
0,1 кредита за результат
Готово
Готово

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

README

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

TikTok Live Shopping

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

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

  • Все товары из корзиныПо room_id вместе с user_id ведущего возвращается каждый товар из корзины эфира отдельной записью — до 500 товаров, которые допускает results_limit.
  • Цена как сумма, валюта и отображаемый текстprice.amount, price.currency и price.formatted содержат число, код валюты и строку, которую видят зрители, например 41.6, USD и $41.60.
  • Число проданных единиц как целое числоsold_count — это целое число, например 101600, поэтому корзины можно сразу сортировать и сравнивать.
  • Ссылка на товар, ID продавца и изображениеВ каждой записи есть страница товара в url, ID продавца в seller.id и изображение товара с шириной и высотой в media.

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

ПараметрыОбязательныйОписание
room_idОбязательныйЧисловой ID прямого эфира из поля id результата TikTok Live Search.
user_idОбязательныйЧисловой ID пользователя TikTok, который ведет эфир, из поля author.id того же результата Live Search.
results_limitНеобязательныйСколько товаров вернуть, от 1 до 500. По умолчанию 100.

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

Найдите прямой эфир с продажами, затем получите список его корзины, пока он идет.

  1. Выполните TikTok Live Search по товарному ключевому слову и возьмите из результата id и author.id.
  2. Отправьте {"room_id": "7704767945901132575", "user_id": "7153432386608251946"} методом POST на /v1/tiktok/live-products.
  3. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded, затем читайте товары из results.items и передавайте обратно results.next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/tiktok/live-products" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"room_id":"7704767945901132575","user_id":"7153432386608251946","results_limit":100}'

# Each item is one product with title, price and sold_count.

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

  • Анализ корзины эфира конкурента: Возьмите room_id и user_id ведущего-конкурента из Live Search и получите всю корзину, чтобы увидеть, какие товары и ценовые уровни он предлагает.
  • Отслеживание цен во время трансляции: Запрашивайте один и тот же эфир каждые несколько минут и сравнивайте price.amount по id каждого товара, чтобы заметить скидки, которые ведущий объявляет в эфире.
  • Поиск самых продаваемых товаров корзины: Отсортируйте корзину по sold_count, чтобы увидеть, какие товары уже продались в наибольшем количестве, и сопоставьте их с ценой.

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

  • Проверяйте price.currency перед сравнением цен в разных эфирах: сумма имеет смысл только вместе с валютой.
  • Сопоставляйте один и тот же товар между запросами по его id; меняются поля price.amount и sold_count.

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

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

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

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

TikTok Live Shopping API — FAQ

TikTok Live Shopping API — это программный интерфейс для получения списка товаров из корзины прямого эфира TikTok по room_id эфира и user_id ведущего. Он возвращает для каждого товара название, цену, число проданных единиц, ID продавца, ссылку и изображение.

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

results_limit принимает значения от 1 до 500, по умолчанию 100, и сбор завершается раньше, если в корзине меньше товаров. Каждый возвращенный товар стоит 0,1 кредита, поэтому полная корзина из 500 товаров обойдется в 50 кредитов.

У ведущего нет корзины в этом эфире, или эфир уже закончился. Пустой результат не тарифицируется.

Нет, эфир должен идти в момент запроса корзины. Читайте ее во время трансляции и сохраняйте, если состав товаров понадобится позже.

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