tiktok-shop/
category-products

Liste los productos de una categoría de TikTok Shop a partir de su ID de categoría y su mercado, con título, precio y moneda, unidades vendidas, calificación, reseñas y tienda, hasta 500 por llamada.

TikTok Shop Category Products API

ID de categoría
9 mercados
Hasta 500 productos
0.5 créditos por resultado
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 Category Products

Los productos de una categoría de TikTok Shop son los artículos clasificados bajo una categoría de un mercado, cada uno con su título, descripción, precio y moneda, unidades vendidas, calificación, cantidad de reseñas, tienda e imágenes. Recopilados categoría por categoría, revelan los rangos de precio, los más vendidos y las tiendas activas de un rubro, y en qué se diferencian de una subcategoría a otra.

Funcionalidades de la TikTok Shop Category Products API

  • Explorar por ID de categoría en lugar de palabra clavecategory_id recibe el ID numérico que devuelve TikTok Shop Categories, así que los productos de una categoría se leen directamente sin adivinar términos de búsqueda.
  • Nueve mercados, US de forma predeterminadaregion cubre US, SG, MY, PH, TH, VN, ID, JP y MX, y usa US cuando se omite.
  • Hasta 500 productos por categoríaresults_limit va de 1 a 500 con 30 como valor predeterminado, así que una solicitud puede tomar una muestra rápida o una porción profunda de una categoría.
  • Campos comerciales en cada productoCada fila trae title, text, price con importe y moneda, sold_count, rating, reviews_count, seller y las imágenes de media, además de url para la página del producto.

Parámetros de la TikTok Shop Category Products API

ParámetrosObligatorioDescripción
category_idObligatorioID numérico de categoría tomado del campo id de TikTok Shop Categories, como 601450.
regionOpcionalMercado de la categoría: US, SG, MY, PH, TH, VN, ID, JP o MX. El valor predeterminado es US.
results_limitOpcionalCantidad de productos que se devuelven, de 1 a 500. El valor predeterminado es 30.

Cómo usar la TikTok Shop Category Products API

Tome un ID de categoría de TikTok Shop Categories y lea los productos que contiene.

  1. Envíe {"category_id": "601450", "region": "US", "results_limit": 30} por POST a /v1/tiktok-shop/category-products.
  2. Consulte GET /v1/tasks/{task_id}; los productos están listos cuando status es succeeded.
  3. Lea los productos en results.items y, si has_more es true, pida la página siguiente con 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}'

Casos de uso de la TikTok Shop Category Products API

  • Comparar rangos de precio entre subcategorías: Ejecute una solicitud por cada categoría hija y compare la dispersión de price.amount para ver en qué precios se ubican los productos de cada subcategoría.
  • Seguir los más vendidos de una categoría: Vuelva a consultar una categoría de forma periódica y siga el sold_count de cada id de producto para encontrar los artículos que no dejan de sumar unidades.
  • Mapear las tiendas de un rubro: Agrupe los productos por seller.id y seller.name para encontrar las tiendas con más artículos y más ventas en una categoría.

Consejos de expertos para la TikTok Shop Category Products API

  • Use la misma region de la que leyó el ID de categoría en TikTok Shop Categories, ya que cada mercado tiene su propio árbol de categorías.
  • Guarde el category_id que envió junto a cada producto que conserve, porque la categoría proviene de su solicitud y no de un campo de la fila del producto.
  • Use id como clave al combinar varias categorías o ejecuciones repetidas, para que un producto recopilado dos veces se cuente una sola vez.

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

  • 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 Product Reviews API — Recolecta reseñas públicas de la URL de la página de un producto de TikTok Shop, con campos de texto, calificación, autor, imagen, SKU, país y contexto de compra.
  • 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 Categories API — Obtiene el árbol completo de categorías de un mercado de TikTok Shop con IDs, nombres, slugs en inglés, niveles, categorías padre y rutas.

Explorar otras plataformas

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

TikTok Shop Category Products API — FAQ

TikTok Shop Category Products API es una interfaz programática para listar los productos de una categoría de TikTok Shop, identificada por su ID de categoría y su mercado. Devuelve el título, la descripción, el precio y la moneda, las unidades vendidas, la calificación, la cantidad de reseñas, la tienda, las imágenes y la URL de la página de cada producto.

Ejecute TikTok Shop Categories y copie el id de la categoría que necesita. Los ID están formados solo por dígitos, como 601450.

Se acepta cualquier ID de categoría del árbol. La solicitud de ejemplo de Cómo usarla envía 601450, la categoría de primer nivel Beauty & Personal Care, y un ID más profundo concentra la lista en una sola rama.

Cada producto cuesta 0.5 créditos, así que los 30 productos predeterminados cuestan 15 créditos y 500 productos cuestan 250.