TikTok Shop Categories
TikTok Shop Categories — это товарная таксономия рынка, где у каждой категории есть ID, название на местном языке, английский slug, уровень вложенности, родитель и цепочка названий над ней. Выстроенные в дерево, они показывают, как рынок группирует товары, и дают ID, нужные для сопоставления каталогов, планирования исследований категорий и просмотра отдельной ветки.
Возможности TikTok Shop Categories API
- Все категории за один вызовОдин запрос возвращает все дерево выбранного рынка, от верхних вертикалей до самых глубоких подкатегорий, каждую отдельной строкой.
- Родитель, уровень и признак листаparent_id связывает строку с вышестоящей категорией, level считает глубину от 1 на верхнем уровне, а is_leaf отмечает категории без подкатегорий.
- Названия предков в pathpath перечисляет названия всех категорий над строкой сверху вниз, так что глубокую категорию можно показать в контексте, не обходя дерево.
- ID, открывающие товары категорииКаждый id можно передать как category_id в TikTok Shop Category Products, чтобы получить товары этой категории.
Параметры TikTok Shop Categories API
| Параметры | Обязательный | Описание |
|---|---|---|
region | Необязательный | Рынок, дерево категорий которого нужно вернуть: US, SG, MY, PH, TH, VN, ID, JP или MX. По умолчанию US. |
Как использовать TikTok Shop Categories API
Запросите дерево одного рынка и соберите его из полученных строк.
- Отправьте {"region": "US"} методом POST на /v1/tiktok-shop/categories или не указывайте region, чтобы получить дерево US.
- Опрашивайте GET /v1/tasks/{task_id}, пока задача не завершится успешно.
- Соберите все строки из results.items, переходя по results.next_cursor, пока has_more равно true, затем вложите строки друг в друга по parent_id.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/categories" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"region":"US"}'Сценарии использования TikTok Shop Categories API
- Воссоздание меню категорий: Вкладывайте строки по parent_id и упорядочивайте по level, чтобы воссоздать навигацию по категориям рынка, используя name для подписей и cover_url для иконок.
- Сопоставление с собственным каталогом: Сравнивайте name, slug и path с категориями ваших товаров, чтобы переводить свою таксономию в ту, которую TikTok Shop использует на этом рынке.
- Планирование обхода категорий: Отфильтруйте строки внутри выбранной вертикали, где is_leaf равно true, чтобы составить список ID для отправки в TikTok Shop Category Products.
Практические советы по TikTok Shop Categories API
- Если has_more равно true, дойдите по results.next_cursor до последней страницы, прежде чем строить дерево: без одной страницы дочерние строки останутся без родителя.
- Считайте корнями дерева строки с пустым parent_id и level 1; их path — пустой список.
- Отправляйте ID категорий в TikTok Shop Category Products с тем же region, из которого прочитано дерево: каждое дерево относится к одному рынку.
Связанные API
Помимо TikTok Shop Categories API, используйте эти API, когда нужен другой тип публичных данных TikTok Shop.
- TikTok Shop Search API — Ищите публичные товары TikTok Shop по ключевому слову и региону рынка: продавец, цена, медиа, рейтинг, отзывы и число продаж.
- TikTok Shop Products API — Собирайте публичные товары по URL одного магазина TikTok Shop: продавец, цена, медиа, категория, SKU, рейтинг, отзывы и число продаж.
- TikTok Shop Product API — Получайте один публичный товар TikTok Shop по URL карточки товара: продавец, цена, медиа, категория, SKU, рейтинг, отзывы и число продаж.
- TikTok Shop User Showcase API — Собирайте публичные товары с витрины одного пользователя TikTok: цена, продавец, медиа, рейтинг, отзывы, число продаж и региональный контекст.
- TikTok Shop Hot Products API — Собирайте самые продаваемые товары рынка TikTok Shop по коду региона в порядке рейтинга: цена, валюта, продажи, оценка и магазин.
- TikTok Shop Category Products API — Получайте товары одной категории TikTok Shop по ID категории и рынку: цена, продажи, оценка, отзывы и магазин.