https://api.nexscope.ai/et/batchProductDetailEjecutar esta API
Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.
Endpoint
| Método | POST |
| Ruta | https://api.nexscope.ai/et/batchProductDetail |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
productIds | string[] | opcional | Lista de IDs de productos (hasta 1000). Ejemplo: `["1729382310407603945", "1729382310407603946"]` |
productUrls | string[] | opcional | Producto URL (hasta 1000), en forma de `https://shop.tiktok.com/us/pdp/<slug>/<productId>?...`; el motor extraerá la `productId` al final de cada URL y fusionarlo en `productIds`, que no es mutuamente excluyente con `productIds` |
Respuesta de ejemplo
Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.
No hay un ejemplo de respuesta publicado para esta API. Consulta los campos de respuesta siguientes.
Campos de respuesta
Referencia de campos de respuesta (88 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
total | integer | opcional | Número de registros |
products | array | opcional | Lista de detalles del producto (ver objeto del producto para más detalles) |
columns | array | opcional | Columnas renderizadas |
type | string | opcional | Estilo de representación |
costToken | integer | opcional | Consumir token |
productId | string | opcional | ID del producto |
productName | string | opcional | Nombre del producto |
imageUrl | string | opcional | Imágenes del producto |
productImageUrls | array | opcional | Lista de imágenes del producto |
region | string | opcional | código de área |
sellerId | string | opcional | ID del vendedor |
categoryId | string | opcional | ID de clasificación del primer nivel |
categoryL2Id | string | opcional | ID de clasificación secundaria |
categoryL3Id | string | opcional | ID de clasificación de tercer nivel |
minPrice | number | opcional | Mínimo SKU Precio (USD) |
maxPrice | number | opcional | Máximo SKU Precio (USD) |
spuAvgPrice | number | opcional | Precio medio de la SPU (USD) |
productRating | number | opcional | calificación del producto |
reviewCount | integer | opcional | Número de comentarios |
productCommissionRate | number | opcional | Relación de la comisión de productos |
totalSaleCnt | integer | opcional | ventas totales |
totalSale1dCnt | integer | opcional | Volumen de ventas en el último día |
totalSale7dCnt | integer | opcional | Volumen de ventas en los últimos 7 días |
totalSale15dCnt | integer | opcional | Volumen de ventas en los últimos 15 días |
totalSale30dCnt | integer | opcional | Volumen de ventas en los últimos 30 días |
totalSale60dCnt | integer | opcional | Volumen de ventas en los últimos 60 días |
totalSale90dCnt | integer | opcional | Volumen de ventas en los últimos 90 días |
totalSaleGmvAmt | number | opcional | ventas totales |
totalSaleGmv1dAmt | number | opcional | Ventas en el último día |
totalSaleGmv7dAmt | number | opcional | Ventas en los últimos 7 días |
totalSaleGmv15dAmt | number | opcional | Ventas en los últimos 15 días |
totalSaleGmv30dAmt | number | opcional | Ventas en los últimos 30 días |
totalSaleGmv60dAmt | number | opcional | Ventas en los últimos 60 días |
totalSaleGmv90dAmt | number | opcional | Ventas en los últimos 90 días |
totalLiveCnt | integer | opcional | Número total de emisiones en directo |
totalLive1dCnt | integer | opcional | Número de emisiones en directo en el último día |
totalLive7dCnt | integer | opcional | Número de emisiones en directo en los últimos 7 días |
totalLive15dCnt | integer | opcional | Número de emisiones en directo en los últimos 15 días |
totalLive30dCnt | integer | opcional | Número de emisiones en directo en los últimos 30 días |
totalLive60dCnt | integer | opcional | Número de emisiones en directo en los últimos 60 días |
totalLive90dCnt | integer | opcional | Número de emisiones en directo en los últimos 90 días |
totalLiveSale1dCnt | integer | opcional | Ventas en vivo en streaming en el último día |
totalLiveSale7dCnt | integer | opcional | Ventas en vivo en los últimos 7 días |
totalLiveSale15dCnt | integer | opcional | Ventas en vivo en streaming en los últimos 15 días |
totalLiveSale30dCnt | integer | opcional | Ventas en vivo en los últimos 30 días |
totalLiveSale60dCnt | integer | opcional | Ventas en directo en los últimos 60 días |
totalLiveSale90dCnt | integer | opcional | Ventas en vivo en los últimos 90 días |
totalLiveSaleGmv1dAmt | integer | opcional | Ventas en vivo en el último día |
totalLiveSaleGmv7dAmt | integer | opcional | Ventas en vivo en los últimos 7 días |
totalLiveSaleGmv15dAmt | integer | opcional | Ventas en vivo en los últimos 15 días |
totalLiveSaleGmv30dAmt | integer | opcional | Ventas en vivo en los últimos 30 días |
totalLiveSaleGmv60dAmt | integer | opcional | Ventas en vivo en streaming en los últimos 60 días |
totalLiveSaleGmv90dAmt | integer | opcional | Ventas en vivo en los últimos 90 días |
totalVideoCnt | integer | opcional | Número total de vídeos |
totalVideo1dCnt | integer | opcional | Número de vídeos en el último día |
totalVideo7dCnt | integer | opcional | Número de vídeos en los últimos 7 días |
totalVideo15dCnt | integer | opcional | Número de vídeos en los últimos 15 días |
totalVideo30dCnt | integer | opcional | Número de vídeos en los últimos 30 días |
totalVideo60dCnt | integer | opcional | Número de vídeos en los últimos 60 días |
totalVideo90dCnt | integer | opcional | Número de vídeos en los últimos 90 días |
totalIflCnt | integer | opcional | Número total de expertos |
totalIflVideo1dCnt | integer | opcional | El número de vídeos de expertos en el pasado día |
totalIflVideo7dCnt | integer | opcional | El número de vídeos de expertos en los últimos 7 días |
totalIflVideo15dCnt | integer | opcional | El número de vídeos de expertos en los últimos 15 días |
totalIflVideo30dCnt | integer | opcional | El número de vídeos de expertos en los últimos 30 días |
totalIflVideo60dCnt | integer | opcional | El número de vídeos de expertos en los últimos 60 días |
totalIflVideo90dCnt | integer | opcional | Número de vídeos de expertos en los últimos 90 días |
totalIflLive1dCnt | integer | opcional | Número de emisiones en directo por expertos en el último día |
totalIflLive7dCnt | integer | opcional | Número de emisiones en directo por expertos en los últimos 7 días |
totalIflLive15dCnt | integer | opcional | Número de emisiones en directo por expertos en los últimos 15 días |
totalIflLive30dCnt | integer | opcional | Número de emisiones en directo por expertos en los últimos 30 días |
totalIflLive60dCnt | integer | opcional | Número de emisiones en directo por expertos en los últimos 60 días |
totalIflLive90dCnt | integer | opcional | Número de emisiones en directo por expertos en los últimos 90 días |
totalViewsCnt | integer | opcional | Total de opiniones |
totalViews1dCnt | integer | opcional | Número de opiniones en el pasado día |
totalViews7dCnt | integer | opcional | Número de opiniones en los últimos 7 días |
totalViews15dCnt | integer | opcional | Número de opiniones en los últimos 15 días |
totalViews30dCnt | integer | opcional | Número de opiniones en los últimos 30 días |
totalViews60dCnt | integer | opcional | Número de opiniones en los últimos 60 días |
totalViews90dCnt | integer | opcional | Número de opiniones en los últimos 90 días |
discount | string | opcional | Información sobre descuentos |
freeShipping | integer | opcional | ¿Es gratis el envío? |
salesFlag | integer | opcional | Principales métodos de entrega |
salesTrendFlag | integer | opcional | Identificación de la tendencia de ventas: 0=estable, 1=aumento, 2=declinación |
isSShop | integer | opcional | Si la tienda está completamente gestionada |
offMark | integer | opcional | Marca de eliminación del producto |
firstCrawlDt | string | opcional | Primera fecha de arrastre |
descDetail | string | opcional | Descripción de los detalles del producto |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado. |
| 429 | Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente. |
| 503 | La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente. |
| Opcional | X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200. |
Fuente de datos, vigencia y limitaciones
La fuente, la vigencia, la cobertura, los límites de frecuencia y las notas de estimación no se especifican en esta definición de API salvo que aparezcan en la documentación de campos de solicitud o respuesta anterior. No supongas datos oficiales del mercado ni actualización en tiempo real cuando no estén documentados explícitamente.