TikTok Shop Product
Los productos de TikTok Shop son páginas públicas de detalle de producto con señales de identidad, vendedor, precios, contenido multimedia, categoría, variantes, calificación, cantidad de reseñas y unidades vendidas. Estos campos sirven para enriquecer productos, investigar catálogos, revisar el merchandising y comparar en un momento dado.
Funcionalidades de la TikTok Shop Product API
- Consulta del detalle de una sola PDPEnvíe una URL PDP pública de TikTok Shop admitida y reciba, como máximo, un registro de producto normalizado, lo que hace al endpoint adecuado para enriquecer un artículo conocido y no para descubrir productos.
- Vendedor, precio y señales comerciales visiblesEl registro del producto conserva la identidad del vendedor expuesta, el precio de venta y el original, la moneda, el descuento, la calificación, la cantidad de reseñas y las unidades vendidas para una evaluación directa por campo.
- Contexto de contenido multimedia, categoría y SKULos registros devueltos incluyen las imágenes del producto expuestas, con sus dimensiones, además de las estructuras de categoría y de SKU o variantes de la página pública del producto.
Parámetros de la TikTok Shop Product API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | URL pública obligatoria de TikTok Shop que coincida con /shop/pdp/{numeric_id} o /shop/pdp/{slug}/{numeric_id}; una tarea acepta un producto. |
region | Opcional | Región de mercado de TikTok Shop, opcional; el valor predeterminado es US, y la disponibilidad de productos en otras regiones aceptadas puede variar. |
Cómo usar la TikTok Shop Product API
Envíe una URL de producto admitida, guarde el ID de la tarea asíncrona y lea el producto normalizado cuando la tarea tenga éxito.
- Envíe una solicitud POST a /v1/tiktok-shop/product con una url PDP admitida y una region opcional.
- Guarde el task_id devuelto y consulte GET /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
- Tras el éxito, lea data.results.items y siga next_cursor solo cuando has_more sea true.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/product" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.tiktok.com/shop/pdp/example-product/1729587769570529799","region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after status becomes succeededCasos de uso de la TikTok Shop Product API
- Enriquecimiento de resultados de búsqueda o de catálogo: Use una URL PDP conocida para agregar los campos de vendedor, precio, calificación, contenido multimedia, categoría y SKU a un producto seleccionado de una búsqueda o del catálogo de una tienda.
- Comparación de instantáneas de señales del producto: Compare el precio de venta, el precio original, el descuento, la calificación, la cantidad de reseñas y las unidades vendidas recopilados entre registros de producto de momentos distintos.
- Revisión de categorías y variantes: Inspeccione las estructuras de categoría, imagen y SKU expuestas para revisar cómo se organiza y se presenta un producto público.
Consejos de expertos para la TikTok Shop Product API
- Valide antes del envío que la entrada sea una URL PDP completa de tiktok.com con un ID de producto numérico, para evitar que se rechace la solicitud.
- Mantenga region en US a menos que el producto pertenezca a otro mercado aceptado, y trate un resultado vacío fuera de US como un posible límite de disponibilidad.
- No envíe results_limit: una tarea acepta una URL de producto y puede devolver, como máximo, un registro normalizado.
- Trate los campos anulables de vendedor, precio, señales, contenido multimedia, categoría y SKU como una instantánea de la página pública, y maneje una tarea exitosa sin elementos sin crear un producto de relleno.
APIs relacionadas
Además de la TikTok Shop Product 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 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.