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 и прочитайте товары внутри нее.
- Отправьте {"category_id": "601450", "region": "US", "results_limit": 30} методом POST на /v1/tiktok-shop/category-products.
- Опрашивайте 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/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 товара как ключ при объединении нескольких категорий или повторных запусков, чтобы товар, собранный дважды, учитывался один раз.
Связанные API
Помимо 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, уровни, родители и пути.