tiktok-shop/
categories

Obtenga el árbol completo de categorías de productos de un mercado de TikTok Shop con un código de región opcional, con una fila por categoría que incluye ID, nombre, slug en inglés, nivel, categoría padre y ruta.

TikTok Shop Categories API

Árbol completo de categorías
Región opcional
Categoría padre y nivel
ID de categoría
0.5 créditos por solicitud
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

TikTok Shop Categories

Las categorías de TikTok Shop forman la taxonomía de productos de un mercado, donde cada categoría tiene un ID, un nombre en el idioma local, un slug en inglés, un nivel de profundidad, una categoría padre y la cadena de nombres que tiene por encima. Organizadas como árbol, muestran cómo agrupa sus productos un mercado y aportan los ID necesarios para mapear catálogos, planificar estudios por categoría y explorar una sola rama.

Funcionalidades de la TikTok Shop Categories API

  • Todas las categorías en una llamadaUna sola solicitud devuelve el árbol completo del mercado elegido, desde los grandes rubros del primer nivel hasta las subcategorías más profundas, cada una como una fila propia.
  • Categoría padre, nivel e indicador de hojaparent_id vincula cada fila con la categoría superior, level cuenta la profundidad empezando en 1 arriba e is_leaf marca las categorías que no tienen subcategorías.
  • Nombres de los ancestros en pathpath enumera los nombres de todas las categorías que hay por encima de una fila, de arriba hacia abajo, para mostrar una categoría profunda en contexto sin recorrer el árbol.
  • ID que abren los productos de una categoríaCada id se puede pasar como category_id a TikTok Shop Category Products para listar los productos clasificados en esa categoría.

Parámetros de la TikTok Shop Categories API

ParámetrosObligatorioDescripción
regionOpcionalMercado cuyo árbol de categorías se devuelve: US, SG, MY, PH, TH, VN, ID, JP o MX. El valor predeterminado es US.

Cómo usar la TikTok Shop Categories API

Pida el árbol de un mercado y ármelo con las filas devueltas.

  1. Envíe {"region": "US"} por POST a /v1/tiktok-shop/categories, u omita region para obtener el árbol de US.
  2. Consulte GET /v1/tasks/{task_id} hasta que la tarea termine con éxito.
  3. Reúna todas las filas de results.items, siguiendo results.next_cursor mientras has_more sea true, y luego anídelas por 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"}'

Casos de uso de la TikTok Shop Categories API

  • Reconstruir el menú de categorías: Anide las filas por parent_id y ordénelas por level para recrear la navegación por categorías del mercado, con name como etiqueta y cover_url como ícono.
  • Mapear las categorías a su propio catálogo: Compare name, slug y path con sus categorías de productos para traducir entre su taxonomía y la que TikTok Shop usa en ese mercado.
  • Planificar un recorrido por categorías: Filtre las filas de un rubro elegido donde is_leaf es true para armar la lista de ID que enviará a TikTok Shop Category Products.

Consejos de expertos para la TikTok Shop Categories API

  • Cuando has_more sea true, siga results.next_cursor hasta la última página antes de armar el árbol, ya que una página faltante deja filas hijas sin su categoría padre.
  • Tome las filas con parent_id vacío y level 1 como raíces del árbol; su path es una lista vacía.
  • Envíe los ID de categoría a TikTok Shop Category Products con la misma region de la que se leyó el árbol, porque cada árbol pertenece a un mercado.

Además de la TikTok Shop Categories API, use estas APIs cuando necesite otro tipo de datos públicos de TikTok Shop.

  • TikTok Shop Search API — Busca productos públicos de TikTok Shop por palabra clave y región de mercado, con campos de vendedor, precio, contenido multimedia, calificación, reseñas y cantidad vendida.
  • TikTok Shop Products API — Recolecta productos públicos de la URL de una tienda de TikTok Shop, con campos de vendedor, precio, contenido multimedia, categoría, SKU, calificación, reseñas y cantidad vendida.
  • TikTok Shop Product API — Obtiene un producto público de TikTok Shop desde la URL de su página de producto, con campos de vendedor, precio, contenido multimedia, categoría, SKU, calificación, reseñas y cantidad vendida.
  • TikTok Shop User Showcase API — Recolecta los productos públicos de la vitrina de un nombre de usuario de TikTok, con precio, vendedor, contenido multimedia, calificación, reseñas, cantidad vendida y contexto regional.
  • TikTok Shop Hot Products API — Recolecta los productos más vendidos de un mercado de TikTok Shop por código de región, en el orden de la clasificación, con precio, moneda, unidades vendidas, calificación y tienda.
  • TikTok Shop Category Products API — Lista los productos de una categoría de TikTok Shop por ID de categoría y mercado, con precio, unidades vendidas, calificación, reseñas y tienda.

Explorar otras plataformas

Combine los datos de TikTok Shop con datos públicos de otras plataformas sociales compatibles.

TikTok Shop Categories API — FAQ

TikTok Shop Categories API es una interfaz programática para obtener el árbol completo de categorías de productos de un mercado de TikTok Shop, elegido con un código de región opcional. Devuelve el ID, el nombre, el slug en inglés, la categoría padre, el nivel, el indicador de hoja, la ruta de ancestros y la URL del ícono de cada categoría.

region acepta US, SG, MY, PH, TH, VN, ID, JP y MX, y usa US cuando se omite.

Seleccione las filas cuyo parent_id sea igual al id de esa categoría. Una fila con is_leaf en true no tiene subcategorías y marca el final de su rama.

name sigue el idioma de visualización del mercado, mientras que slug da una etiqueta de URL en inglés para cada categoría, algo útil al leer mercados en otros idiomas.

Cada llamada cuesta 0.5 créditos y devuelve todas las categorías del mercado, sin importar cuántas filas tenga el árbol.