tiktok-shop/
categories

Получайте полное дерево товарных категорий рынка TikTok Shop по необязательному коду региона — по одной строке на категорию с ID, названием, английским slug, уровнем, родителем и путем.

TikTok Shop Categories API

Полное дерево категорий
Необязательный регион
Родитель и уровень
ID категорий
0,5 кредита за запрос
Готово
Готово

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

README

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

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

Запросите дерево одного рынка и соберите его из полученных строк.

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

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

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

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

TikTok Shop Categories API — FAQ

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

region принимает US, SG, MY, PH, TH, VN, ID, JP и MX, а если он не указан, используется US.

Выберите строки, у которых parent_id равен id этой категории. Строка с is_leaf, равным true, не имеет подкатегорий и завершает свою ветку.

name следует языку интерфейса рынка, а slug дает английскую URL-метку для каждой категории, что помогает при чтении рынков на других языках.

Каждый вызов стоит 0,5 кредита и возвращает все категории рынка, сколько бы строк ни было в дереве.