tiktok-shop/
category-products

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

TikTok Shop Category Products API

ID категории на входе
9 рынков
До 500 товаров
0,5 кредита за результат
Готово
Готово

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

README

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

TikTok Shop Category Products

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

Возможности TikTok Shop Category Products API

  • Просмотр по ID категории вместо ключевого словаcategory_id принимает числовой ID, полученный из TikTok Shop Categories, так что товары категории читаются напрямую, без подбора поисковых слов.
  • Девять рынков, по умолчанию USregion охватывает US, SG, MY, PH, TH, VN, ID, JP и MX, а если значение не указано, используется US.
  • До 500 товаров на категориюresults_limit принимает от 1 до 500, по умолчанию 30, поэтому один запрос может дать быструю выборку или глубокий срез категории.
  • Коммерческие поля у каждого товараКаждая строка содержит title, text, price с amount и currency, sold_count, rating, reviews_count, seller и изображения media, а также url страницы товара.

Параметры TikTok Shop Category Products API

ПараметрыОбязательныйОписание
category_idОбязательныйЧисловой ID категории из поля id в TikTok Shop Categories, например 601450.
regionНеобязательныйРынок категории: US, SG, MY, PH, TH, VN, ID, JP или MX. По умолчанию US.
results_limitНеобязательныйЧисло возвращаемых товаров, от 1 до 500. По умолчанию 30.

Как использовать TikTok Shop Category Products API

Возьмите ID категории из TikTok Shop Categories и прочитайте товары внутри нее.

  1. Отправьте {"category_id": "601450", "region": "US", "results_limit": 30} методом POST на /v1/tiktok-shop/category-products.
  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/category-products" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"601450","region":"US","results_limit":30}'

Сценарии использования TikTok Shop Category Products API

  • Сравнение ценовых диапазонов подкатегорий: Отправляйте по запросу на каждую дочернюю категорию и сравнивайте разброс price.amount, чтобы увидеть, в каком диапазоне цен находятся товары каждой подкатегории.
  • Отслеживание бестселлеров категории: Регулярно запускайте категорию заново и следите за sold_count по id каждого товара, чтобы найти позиции, которые продолжают набирать продажи.
  • Карта магазинов вертикали: Группируйте товары по seller.id и seller.name, чтобы найти магазины с наибольшим числом товаров и самыми высокими продажами в категории.

Практические советы по TikTok Shop Category Products API

  • Используйте тот же region, из которого прочитан ID категории в TikTok Shop Categories: у каждого рынка свое дерево категорий.
  • Сохраняйте отправленный category_id рядом с каждым сохраняемым товаром: категория берется из вашего запроса, а не из поля строки товара.
  • Используйте id товара как ключ при объединении нескольких категорий или повторных запусков, чтобы товар, собранный дважды, учитывался один раз.

Помимо TikTok Shop Category 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 Hot Products API — Собирайте самые продаваемые товары рынка TikTok Shop по коду региона в порядке рейтинга: цена, валюта, продажи, оценка и магазин.
  • TikTok Shop Categories API — Получайте полное дерево категорий рынка TikTok Shop: ID, названия, английские slug, уровни, родители и пути.

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

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

TikTok Shop Category Products API — FAQ

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

Запустите TikTok Shop Categories и скопируйте id нужной категории. ID состоят только из цифр, например 601450.

Принимается любой ID категории из дерева. Пример запроса в разделе «Как использовать» отправляет 601450 — категорию верхнего уровня Beauty & Personal Care, а более глубокий ID сужает список до одной ветки.

Каждый товар стоит 0,5 кредита: 30 товаров по умолчанию обходятся в 15 кредитов, а полные 500 — в 250 кредитов.