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ámetros | Obligatorio | Descripción |
|---|---|---|
category_id | Obligatorio | ID numérico de categoría tomado del campo id de TikTok Shop Categories, como 601450. |
region | Opcional | Mercado de la categoría: US, SG, MY, PH, TH, VN, ID, JP o MX. El valor predeterminado es US. |
results_limit | Opcional | Cantidad 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.
- Envíe {"category_id": "601450", "region": "US", "results_limit": 30} por POST a /v1/tiktok-shop/category-products.
- Consulte GET /v1/tasks/{task_id}; los productos están listos cuando status es succeeded.
- 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.
APIs relacionadas
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.