TikTok Shop Products
Los productos de TikTok Shop son artículos públicos del catálogo de una tienda, con identidad del producto, contexto del vendedor, imágenes, precios, categorías, datos de SKU, calificaciones, cantidad de reseñas y unidades vendidas. Estos registros sirven para tomar instantáneas del catálogo de una tienda, comparar surtidos, monitorear precios públicos y enriquecer a nivel de producto.
Funcionalidades de la TikTok Shop Products API
- Controles de catálogo por tiendaRecopile productos de la URL de una tienda pública admitida con un límite de resultados solicitado, un orden por más vendidos o por novedades, y una región de mercado documentada.
- Identidad de producto, vendedor y contenido multimediaDevuelve en cada registro los ID de producto, los títulos, las descripciones disponibles, las URL canónicas, la identidad del vendedor o de la tienda, y las referencias de imágenes públicas sin duplicados.
- Precios y señales comerciales visiblesConserva los precios de venta y originales expuestos, la moneda, los valores con formato, los descuentos, las calificaciones, la cantidad de reseñas y las unidades vendidas para comparar productos.
- Filas de catálogo estructuradasMantiene el estado, la categoría y las estructuras de SKU disponibles en filas de producto normalizadas, y excluye los contadores a nivel de tienda que no están asociados a un producto individual.
Parámetros de la TikTok Shop Products API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | URL pública obligatoria de una tienda de TikTok Shop que coincida con /shop/store/{slug}/{numeric_shop_id}; una tarea acepta una tienda. |
results_limit | Opcional | Máximo de productos únicos que se guardan entre las páginas de origen; el valor predeterminado es 100 y acepta enteros de 20 a 2,000. |
sort_by | Opcional | Orden de origen del catálogo de la tienda: top para el orden por más vendidos o new_releases para el orden por lanzamientos más recientes; el valor predeterminado es top. |
region | Opcional | Región de mercado de TikTok Shop; el valor predeterminado es US, y la disponibilidad pública del catálogo en otras regiones aceptadas puede variar. |
Cómo usar la TikTok Shop Products API
Envíe la URL de una tienda pública de TikTok Shop con controles de recopilación opcionales, siga la tarea asíncrona y lea los registros de producto normalizados con paginación por cursor.
- Prepare una URL /shop/store/{slug}/{numeric_shop_id} admitida y elija los valores de results_limit, sort_by y region.
- Envíe la solicitud por POST a /v1/tiktok-shop/products y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
- Lea data.results.items y solicite el next_cursor devuelto mientras has_more siga siendo true.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079","results_limit":100,"sort_by":"top","region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la TikTok Shop Products API
- Instantáneas del catálogo de una tienda: Use los ID de producto, los títulos, las URL, los vendedores, los precios, las imágenes, las categorías, las estructuras de SKU y collected_at para armar un catálogo público de una tienda en un momento dado.
- Comparación de surtidos de más vendidos y novedades: Recopile la misma tienda con los órdenes top y new_releases y compare la identidad de los productos devueltos, los precios, las categorías y las señales visibles de los productos.
- Seguimiento de precios y señales públicas: Compare los campos de precio, descuento, calificación, cantidad de reseñas, unidades vendidas, estado y hora de recopilación obtenidos de forma independiente para los mismos ID de producto.
- Preparación de una lista corta de URL de productos: Use las URL canónicas de los productos, los títulos, las imágenes, el contexto del vendedor y las métricas visibles para elegir productos devueltos que pasen a flujos de detalle o de reseñas.
Consejos de expertos para la TikTok Shop Products API
- Valide antes de enviar la tarea que la entrada use una ruta pública /shop/store/ de tiktok.com con un ID de tienda numérico.
- Defina region con el mercado de la tienda que quiere inspeccionar; cuando una tienda válida no devuelva registros, verifique la disponibilidad regional antes de reintentar.
- Use top para el orden de más vendidos del origen o new_releases para el orden de lanzamientos más recientes, y no interprete ninguno de los dos modos como una garantía de rentabilidad ni de tendencia.
- Trate results_limit como el máximo de recopilación y siga el cursor independiente del resultado de la tarea hasta que has_more sea false para leer todas las filas guardadas.
- Identifique las instantáneas repetidas por ID de producto, conserve collected_at y maneje los campos de vendedor, precio, estado, categoría, SKU, contenido multimedia y métricas como opcionales.
APIs relacionadas
Además de la TikTok Shop Products 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 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.