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
Найдите прямой эфир с продажами, затем получите список его корзины, пока он идет.
- Выполните TikTok Live Search по товарному ключевому слову и возьмите из результата id и author.id.
- Отправьте {"room_id": "7704767945901132575", "user_id": "7153432386608251946"} методом POST на /v1/tiktok/live-products.
- Опрашивайте 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.
Связанные API
Помимо 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 Search 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 Search Users 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