TikTok Shop Hot Products
TikTok Shop Hot Products — это рейтинг самых продаваемых товаров одного рынка, где у каждого товара есть название, цена в местной валюте, число продаж, оценка, число отзывов, магазин и изображения. Если читать его по порядку и сравнивать неделю к неделе, эти сигналы показывают, какие товары выстреливают, по какой цене они продаются и какие магазины стабильно попадают в топ.
Возможности TikTok Shop Hot Products API
- Достаточно кода регионаВыберите один рынок в region (ID, JP, MX, MY, PH, SG, TH или VN), и список вернется без ключевого слова, категории или ссылки на магазин.
- Рейтинг в порядке TikTok ShopТовары приходят в том порядке, в каком их ранжирует TikTok Shop, до 200 за запрос, так что позиция строки — это место товара в списке.
- Цены в валюте рынкаprice делится на числовое значение amount, код валюты вроде MYR и отформатированную цену — это удобно для сортировки и анализа ценовых диапазонов.
- Сигналы спроса и репутацииsold_count, rating и reviews_count есть у каждого товара и быстро показывают, сколько единиц продано и как покупатели их оценили.
- Магазин и изображения товараseller указывает магазин, который продает товар, с его id, а media перечисляет изображения товара с шириной и высотой.
Параметры TikTok Shop Hot Products API
| Параметры | Обязательный | Описание |
|---|---|---|
region | Обязательный | Рынок, рейтинг которого нужно прочитать: ID, JP, MX, MY, PH, SG, TH или VN. |
results_limit | Необязательный | Сколько товаров из рейтинга вернуть, от 1 до 200. По умолчанию 50. |
Как использовать TikTok Shop Hot Products API
Выберите рынок, решите, насколько глубоко читать рейтинг, и соберите список.
- Отправьте {"region": "MY", "results_limit": 50} методом POST на /v1/tiktok-shop/hot-products и сохраните полученный task_id.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте товары из results.items по порядку; пока has_more равно true, продолжайте с results.next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/hot-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"region":"MY","results_limit":50}'Сценарии использования TikTok Shop Hot Products API
- Еженедельный мониторинг бестселлеров рынка: Сохраняйте каждую неделю id, позицию и sold_count каждого товара и сравнивайте запуски, чтобы видеть, какие товары входят в рейтинг, поднимаются или выпадают.
- Сравнение ценовых точек: Сортируйте price.amount в пределах одной валюты, чтобы найти диапазон, где сосредоточены популярные товары рынка, прежде чем назначать цену своему товару.
- Шорт-листы для закупки: Сочетайте title, изображения media, sold_count и rating, чтобы выбрать товары для закупки или продвижения, а url ведет на страницу каждого товара.
- Проверка концентрации магазинов: Посчитайте, как часто каждый seller.id встречается в верхней части списка, чтобы понять, доминируют ли на рынке несколько магазинов или список распределен широко.
Практические советы по TikTok Shop Hot Products API
- Записывайте позицию каждого товара сами при чтении results.items, продолжая счет на страницах курсора: рейтинг передается порядком строк, а не отдельным полем.
- Группируйте по price.currency перед сравнением цен между рынками и выполняйте расчеты с price.amount, а не с отформатированным текстом.
- Считайте null в sold_count, rating или reviews_count отсутствием данных, а не нулем, чтобы средние значения и сортировки сохраняли смысл.
- Не меняйте region и results_limit от запуска к запуску, чтобы еженедельные сравнения охватывали одну и ту же глубину рейтинга.
Связанные API
Помимо TikTok Shop Hot Products API, используйте эти API, когда нужен другой тип публичных данных TikTok Shop.
- TikTok Shop Products API — Собирайте публичные товары по URL одного магазина TikTok Shop: продавец, цена, медиа, категория, SKU, рейтинг, отзывы и число продаж.
- TikTok Shop Product API — Получайте один публичный товар TikTok Shop по URL карточки товара: продавец, цена, медиа, категория, SKU, рейтинг, отзывы и число продаж.
- TikTok Shop Product Reviews API — Собирайте публичные отзывы по URL одной карточки товара TikTok Shop: текст, оценка, автор, изображения, SKU, страна и контекст покупки.
- TikTok Shop User Showcase API — Собирайте публичные товары с витрины одного пользователя TikTok: цена, продавец, медиа, рейтинг, отзывы, число продаж и региональный контекст.
- TikTok Shop Categories API — Получайте полное дерево категорий рынка TikTok Shop: ID, названия, английские slug, уровни, родители и пути.
- TikTok Shop Category Products API — Получайте товары одной категории TikTok Shop по ID категории и рынку: цена, продажи, оценка, отзывы и магазин.