https://api.nexscope.ai/eh/etsy/productQueryEjecutar 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/eh/etsy/productQuery |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
beginFavorites | integer | opcional | El número de favoritos (comenzando), junto con el valor final, forman los favoritos |
beginFavoritesWeekly | integer | opcional | Número de nuevos favoritos por semana (start), que junto con el valor final forman la corriente favorites_weekly |
beginPrice | number | opcional | Precio (start), junto con el precio final, forman el precio ascendente (como 20~100); al rellenar sólo un lado, el upstream es start~ o ~end |
beginReviews | integer | opcional | Número de revisiones (comenzando), que junto con el valor final forman las revisiones iniciales |
beginReviewsWeekly | integer | opcional | Número de nuevos comentarios por semana (start), que junto con el valor final forman la parte superior reviews_weekly |
beginSales | integer | opcional | Ventas totales (a partir de), que junto con el valor final forman las ventas anteriores |
beginSalesWeekly | integer | opcional | Volumen de ventas semanales (start), junto con el valor final, forman la sales_weekly (como 1~100) |
category | string | opcional | ID de clasificación de productos (categoría única), consulte la interfaz de clasificación de productos para más detalles |
country | string | opcional | País de expedición |
currencyCode | string | opcional | Código de moneda, por defecto `USD` |
endFavorites | integer | opcional | Número de colecciones (fin) |
endFavoritesWeekly | integer | opcional | Número de nuevos favoritos por semana (final) |
endPrice | number | opcional | Precio (fin), que junto con el precio inicial forma el precio ascendente |
endReviews | integer | opcional | Número de comentarios (fin) |
endReviewsWeekly | integer | opcional | Número de nuevos comentarios por semana (final) |
endSales | integer | opcional | Total de ventas (finales) |
endSalesWeekly | integer | opcional | Ventas semanales (finales) |
isBestsell | integer | opcional | ¿Es un producto de gran venta? |
isPick | integer | opcional | Define si se debe seleccionar el producto |
isRaving | integer | opcional | Si el producto Raving |
listedTime | string | opcional | La fecha de caducidad no es anterior a esta fecha (AAAA-MM-DD) |
page | integer | opcional | Número de página (a partir de 1) |
pageSize | integer | opcional | Número de entradas por página, máximo 100, recomendado no exceder de 50 |
productType | string | opcional | Tipo de producto, múltiples comas separadas: 1=Hecha a mano 2=Vintage 3=Digital 4=Personalizado 9=Otro |
searchKey | string | opcional | Buscar palabras clave o URLs de productos Etsy |
sortBy | integer | opcional | Campo de clasificación (correspondiente a aguas arriba sort_by, valor 1~6) |
sortDesc | integer | opcional | Dirección de clasificación (correspondiente a aguas arriba `desc`). Ejemplo de esquema: Descendiendo `1`, Ascendiendo `2` |
status | integer | opcional | Estado del producto (ejemplo: 1 en los estantes, 0 en los estantes) |
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 (27 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
total | integer | opcional | Number of records (this page returns the number of records to facilitate alignment with the length of the list) |
sourceType | string | opcional | Source type: etsy |
columns | array | opcional | Rendered columns |
costToken | integer | opcional | Token consumption (estimated based on the number of items returned on this page) |
productNum | integer | opcional | Total number of eligible products (upstream product_num) |
title | string | opcional | Title |
type | string | opcional | Rendering style |
products | array | opcional | Etsy product listings |
category | string | opcional | Category name |
favorites | integer | opcional | Number of collections |
favoritesWeekly | integer | opcional | Number of new favorites per week |
imageUrl | string | opcional | Main image URL |
isBestsell | integer | opcional | Best seller or not: 1=yes |
isPick | integer | opcional | Whether to Pick: 1=Yes |
isRaving | integer | opcional | Whether Raving: 1=Yes |
price | number | opcional | price |
productUrl | string | opcional | Product link |
releaseTime | string | opcional | Shelf/release time |
reviews | integer | opcional | Number of comments |
reviewsWeekly | integer | opcional | New comments per week |
salesTotal | integer | opcional | total sales |
salesWeekly | integer | opcional | Weekly sales |
shipsFrom | string | opcional | Shipping country |
status | integer | opcional | Product status: 1=on the shelves, 0=off the shelves |
storeName | string | opcional | Store name |
tags | string | opcional | tag |
title | string | opcional | Título 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 una clave API ausente o no válida (code 11209, incluida una copia incompleta o dañada) o una sesión web caducada (code 12001), 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.