https://api.nexscope.ai/eh/etsy/storeQueryEjecutar 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/storeQuery |
| 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 colecciones de tiendas (comenzando), y el valor final forman los favoritos |
beginFavoritesWeekly | integer | opcional | La tienda agrega nuevos favoritos en la semana (start), que junto con el valor final forman la favorites_weekly |
beginReviews | integer | opcional | El número de revisiones de los almacenes (comenzando), que junto con el valor final forman las revisiones de las aguas arriba |
beginReviewsWeekly | integer | opcional | Revisiones agregadas para la semana de la tienda (start), que junto con el valor final forman la corriente reviews_weekly |
beginSales | integer | opcional | El volumen total de ventas de la tienda (a partir de), y el valor final forman las ventas anteriores |
beginSalesWeekly | integer | opcional | Almacenar las ventas semanales (start), que junto con el valor final forman la sales_weekly, como 10.100 |
beginStoreOpenedAt | string | opcional | El inicio del intervalo de apertura del almacén (AAAA-MM-DD), y la fecha de finalización forman la fuente start_at, como 2020-01-01~2023-01-01 |
category | string | opcional | Almacenar las categorías principales |
country | string | opcional | País de la tienda |
endFavorites | integer | opcional | Número de colecciones de tiendas (final) |
endFavoritesWeekly | integer | opcional | Tienda Favoritos agregados semanales (finales) |
endReviews | integer | opcional | Número de reseñas de tiendas (final) |
endReviewsWeekly | integer | opcional | Nuevos comentarios para la semana de la tienda (final) |
endSales | integer | opcional | Total de ventas en los almacenes (final) |
endSalesWeekly | integer | opcional | Tienda ventas semanales (finales) |
endStoreOpenedAt | string | opcional | El intervalo de tiempo de apertura de la tienda termina (AAAA-MM-DD) |
isRaving | integer | opcional | Si Raving Shop: 1=Sí |
isStar | integer | opcional | Si se debe protagonizar la tienda: 1=Sí |
page | integer | opcional | Número de página (a partir de 1) |
pageSize | integer | opcional | Número de artículos por página, máximo 100 |
searchKey | string | opcional | Buscar palabras clave o nombre de tienda, tienda URL |
sortBy | integer | opcional | Campo de clasificación sort_by: 8=ventas totales, 9=ventas semanales, 10=número de comentarios, 11=número de colecciones |
sortDesc | integer | opcional | Dirección de clasificación (correspondiente a la desc): 1=orden descendente, 0=orden ascendente |
status | integer | opcional | Estado de la tienda: 1=activa, 0=inactiva |
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 (number of records returned on this page) |
sourceType | string | opcional | Source type: etsy |
stores | array | opcional | Store list |
columns | array | opcional | Rendered columns |
costToken | integer | opcional | Token consumption (estimated based on the number of items returned on this page) |
storeNum | integer | opcional | Total number of eligible stores (upstream store_num) |
title | string | opcional | Title |
type | string | opcional | Rendering style |
category | array | opcional | List of main categories |
country | array | opcional | Country list |
favorites | integer | opcional | Number of collections |
favoritesWeekly | integer | opcional | Number of new favorites per week |
isRaving | integer | opcional | Whether Raving: 1=Yes |
isStar | integer | opcional | Star or not: 1=Yes |
logoUrl | string | opcional | Store avatar URL |
productCount | integer | opcional | Store product quantity |
rating | number | opcional | Valoración |
reviews | integer | opcional | Number of comments |
reviewsWeekly | integer | opcional | New comments per week |
salesTotal | integer | opcional | total sales |
salesWeekly | integer | opcional | Weekly sales |
shopWebsite | string | opcional | Store official website/external link |
startAt | string | opcional | Store opening date |
status | integer | opcional | Store status: 1=active, 0=inactive |
storeId | string | opcional | Store ID |
storeName | string | opcional | Store name |
storeUrl | string | opcional | Store link |
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.