https://api.nexscope.ai/dl/productSearchEjecutar 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/dl/productSearch |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
keyWord | string | opcional | palabra clave de búsqueda, debe estar en chino, máximo 50 caracteres Ejemplo: 瑜伽垫 |
goodsUrl | string | opcional | Dirección del enlace del producto, elija uno de `keyWord` |
productIds | string | opcional | ID del producto, multiples separados por comas, hasta 20 |
cycle | string | opcional | Período estadístico: `7` los últimos 7 días o `30` los últimos 30 días |
searchType | integer | opcional | Tipo de búsqueda: `1` - ¿Qué? `3` correspondencia precisa Ejemplo: 1 |
sortField | string | opcional | `orderCount7d`、`saleCount7d`、`saleVolume7d`、`orderCount30d`、`saleCount30d`、`saleVolume30d`、`offerCreateTime`、`price`、`consignPrice` Ejemplo: orderCount30d |
sortType | string | opcional | Tipo de clasificación: `desc` orden descendente, `asc` orden ascendente Ejemplo: desc |
pageIndex | integer | opcional | Número de página, a partir de 1 Ejemplo: 1 |
pageSize | integer | opcional | Cantidad por página, rango 10-100 Ejemplo: 20 |
beginPrice | number | opcional | Valor inicial del precio al por mayor |
endPrice | number | opcional | precio al por mayor valor final |
beginConsignPrice | number | opcional | Valor de inicio del precio de agencia |
endConsignPrice | number | opcional | El valor final del precio de la agencia |
beginOrderCount | integer | opcional | Valor de partida del número de ventas |
endOrderCount | integer | opcional | Valor final de las ventas |
beginSaleCount | integer | opcional | Valor de partida de las unidades de venta |
endSaleCount | integer | opcional | Valor final de las ventas |
beginSaleVolume | number | opcional | valor inicial de las ventas |
endSaleVolume | number | opcional | valor final de las ventas |
beginStartQuantity | integer | opcional | Valor de partida de la cantidad mínima de compra |
endStartQuantity | integer | opcional | Cantidad mínima de compra valor final |
beginTpYear | integer | opcional | Valor inicial del período de aprobación del crédito |
endTpYear | integer | opcional | Integridad Valor final de vida |
beginOfferCreateTime | string | opcional | Valor inicial del tiempo de estante, formato `YYYY-MM-DD` |
endOfferCreateTime | string | opcional | Fecha de vencimiento, formato `YYYY-MM-DD` |
companyType | integer | opcional | Tipo de empresa: `0` ilimitada, `1` tienda, `2` fábrica Ejemplo: 0 |
offerType | integer | opcional | Identificación del producto: `0` no está limitado, `2` es nuevo, `3` es 1688 cuidadosamente seleccionado, `4` es transfronteriza, `5` admite la personalización, `6` es el tesoro de la tienda Ejemplo: 0 |
shiLiType | string | opcional | Tipo de vendedor, múltiples selecciones separadas por comas: `superFactory`, `Power`, `TrustPass` |
sendTime | string | opcional | Tiempo de envío, selecciones múltiples separadas por comas: `24`, `48`, `72` |
faceToFaceSupport | string | opcional | Apoyo de despedida, selecciones múltiples separadas por comas: `441218` Taobao, `386434` Douyin, `422914` Pinduoduo, `422978` Xiaohongshu, `386370` Kuaishou |
proxyRights | string | opcional | Para los derechos de envío de bajada, varias opciones deben estar separadas por comas: `4360897`, envío gratuito por una sola pieza, `449154`, compra primero, paga después |
shopService | string | opcional | Servicios de venta, selecciones múltiples separadas por comas: `4057409` Compra segura, `888777` Informe de certificación a fondo |
buyerProtections | string | opcional | Protección de derechos, opciones múltiples separadas con comas: `Free shipping for goods`, `7-day return guarantee`, `Support freight insurance` |
Respuesta de ejemplo
Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.
{
"code": 0,
"cost": "0",
"data": {
"products": [
{
"currency": "CNY",
"offerId": "1234567890123456789",
"price": 4.2,
"title": "Example product"
}
],
"total": 1,
"columns": []
},
"msg": null,
"time": "2026-10-20T00:00:00Z",
"traceId": null,
"ts": "0"
}Campos de respuesta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | integer | opcional | Nexscope transport/business envelope code; 0 means the request was processed. Inspect data for operation outcomes. |
cost | string | opcional | Processing time in milliseconds, not credits. |
data | object | opcional | Valor de Data usado por esta operación de API. |
data.columns | array | opcional | Render column definition |
data.columns[] | any | obligatorio | Elemento de data columns. |
data.products | array | opcional | Valor de Products usado por esta operación de API. |
data.products[] | object | obligatorio | Elemento de data products. |
data.products[].asin | string | opcional | Item number |
data.products[].asinUrl | string | opcional | Product link address |
data.products[].availableDate | string | opcional | Product shelf time |
data.products[].company | string | opcional | Store name |
data.products[].consignPrice | number | opcional | Price on behalf of others |
data.products[].currency | string | opcional | Currency |
data.products[].dataType | string | opcional | Data type: `weeklyData` weekly data, `monthlyData` monthly data |
data.products[].deliveryTime | string | opcional | Shipping time |
data.products[].estimatedSalesAmount | integer | opcional | Estimated sales, returned according to statistical period |
data.products[].imageUrl | string | opcional | Product picture address |
data.products[].levelName | string | opcional | Category level name |
data.products[].offerId | string | opcional | Product ID |
data.products[].price | number | opcional | wholesale price |
data.products[].quantityBegin | integer | opcional | Minimum batch size |
data.products[].quantityPrices | string | opcional | price range |
data.products[].salesOrderCount | integer | opcional | Number of sales, returned according to statistical period |
data.products[].salesQuantity | integer | opcional | Number of pieces sold, returned according to statistical period |
data.products[].shopId | string | opcional | Store ID |
data.products[].shopUrl | string | opcional | Store link address |
data.products[].sourceType | string | opcional | Source platform (1688) |
data.products[].title | string | opcional | Product title |
data.products[].unit | string | opcional | unit |
data.total | integer | opcional | Total number of records |
data.type | string | opcional | rendering style |
msg | string | null | opcional | Safe response message. |
time | string | opcional | Server response time. |
traceId | string | null | opcional | Request trace identifier. |
ts | string | opcional | Server timestamp. |
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.