tiktok-shop/
hot-products

Собирайте самые продаваемые товары рынка TikTok Shop по коду региона: название, цена и валюта, число продаж, оценка и магазин в том порядке, в каком их ранжирует TikTok Shop.

TikTok Shop Hot Products API

Код рынка на входе
Бестселлеры по рейтингу
Цены в местной валюте
Число продаж
0,5 кредита за результат
Готово
Готово

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

README

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

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

Выберите рынок, решите, насколько глубоко читать рейтинг, и соберите список.

  1. Отправьте {"region": "MY", "results_limit": 50} методом POST на /v1/tiktok-shop/hot-products и сохраните полученный task_id.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте товары из 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 от запуска к запуску, чтобы еженедельные сравнения охватывали одну и ту же глубину рейтинга.

Помимо 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 категории и рынку: цена, продажи, оценка, отзывы и магазин.

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

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

TikTok Shop Hot Products API — FAQ

TikTok Shop Hot Products API — это программный интерфейс для получения рейтинга самых продаваемых товаров одного рынка TikTok Shop, выбранного по коду региона. Он возвращает название, описание, магазин, цену и валюту, число продаж, оценку, число отзывов и изображения каждого товара в порядке рейтинга.

region принимает ID, JP, MX, MY, PH, SG, TH и VN, по одному рынку на запрос. Для товаров США просматривайте категорию через TikTok Shop Category Products или ищите по ключевому слову через TikTok Shop Search — оба принимают region US.

Строки следуют порядку, в котором их ранжирует TikTok Shop, поэтому первый товар в results.items — вершина списка. Читайте последующие страницы результатов по очереди, чтобы сохранить полный порядок.

results_limit принимает от 1 до 200 и по умолчанию равен 50, так что один запрос может охватить топ-200 товаров рынка.

Каждый возвращенный товар стоит 0,5 кредита, поэтому 50 товаров по умолчанию обходятся в 25 кредитов.