https://api.nexscope.ai/amazon/searchEjecutar 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/amazon/search |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
keyword | string | opcional | Buscar palabras clave, se recomienda utilizar el idioma del sitio objetivo, la longitud máxima es 1024. |
amazonDomain | string | opcional | Sitio del Amazonas: `amazon.com`, `amazon.co.uk`, `amazon.de`, `amazon.fr`, `amazon.it`, `amazon.es`, `amazon.co.jp`, `amazon.ca`, `amazon.com.au`, `amazon.com.br`, `amazon.in`. `amazon.nl`, `amazon.se`, `amazon.pl`, `amazon.sg`, `amazon.sa`, `amazon.ae`, `amazon.com.mx`, `amazon.com.tr`, `amazon.com.be`, `amazon.cn`, `amazon.eg`. |
node | string | opcional | Nodo categoría Amazon, longitud máxima 1000. |
language | string | opcional | Código local, longitud máxima 1000, por ejemplo `en_US`, `de_DE`, `ja_JP`, `fr_FR`. |
sort | string | opcional | `relevanceblender`, `price-asc-rank`, `price-desc-rank`, `review-rank`, `date-desc-rank` o `exact-aware-popularity-rank`. Ejemplo: relevanceblender |
page | integer | opcional | Números de página, a partir de 1, aproximadamente 20 entradas por página. Ejemplo: 1 |
deliveryZip | string | opcional | Lugar de entrega código postal, utilizado para simular dirección de recepción Amazon, longitud máxima 1000. |
device | string | opcional | Tipo de dispositivo: `desktop`, `mobile`, `tablet`, longitud máxima 1000. Ejemplo: desktop |
includeSellerSpriteData | boolean | opcional | Habilitar el enriquecimiento adicional de datos sobre productos, incluidos los availableDate Si está disponible. Por defecto: falso. Habilitar el enriquecimiento conlleva cargas dinámicas adicionales y no garantiza una fecha para cada ASIN. Ejemplo: false |
Respuesta de ejemplo
Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.
{
"data": {
"products": []
}
}Campos de respuesta
Referencia de campos de respuesta (38 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
total | integer | opcional | Total number of rows. |
keyword | string | opcional | Search keywords. |
type | string | opcional | Rendering style. |
sellerSpriteEnriched | boolean | opcional | Whether additional product-data enrichment was enabled for this request. May be absent. Not a plan or account entitlement indicator and not a guarantee that every product was enriched. Ejemplo: false |
columns | array | opcional | Rendered column definitions. |
costToken | integer | opcional | Consume Token. |
products | array | opcional | List of search results. |
asin | string | opcional | ASIN。 |
title | string | opcional | title. |
brand | string | opcional | brand. |
price | number | opcional | price. |
extractedPrice | number | opcional | The parsed price. |
oldPrice | number | opcional | Underline price. |
extractedOldPrice | number | opcional | The parsed underlined price. |
currency | string | opcional | Currency. |
priceUnit | string | opcional | price unit. |
extractedPriceUnit | number | opcional | The parsed price unit. |
rating | number | opcional | Rating. |
ratings | integer | opcional | Rating number. |
position | integer | opcional | location. |
sponsored | boolean | opcional | Sponsor or not. |
imageUrl | string | opcional | Thumbnail. |
asinUrl | string | opcional | Product link. |
delivery | string | opcional | Shipping information. |
fulfillment | string | opcional | Shipping information, such as FBA. |
availableDate | string (date) | opcional | Data-source listing date, populated through includeSellerSpriteData=true when available; may still be absent. Not a verified brand launch date; timezone is unspecified. For direct ASIN lookups, use amazon-product-history or amazon-market-product-detail. |
monthlySalesUnits | integer | opcional | Monthly sales volume. |
monthlySalesRevenue | string | opcional | Monthly sales. |
sellerNation | string | opcional | Seller’s nationality. |
dimension | string | opcional | size. |
weight | string | opcional | weight. |
options | string | opcional | options. |
offers | string | opcional | Offer information. |
badges | string | opcional | Amazon front search logo. |
tags | string | opcional | label. |
snapEbtEligible | boolean | opcional | SNAP/EBT eligibility. |
sourceType | string | opcional | Source type: `amazon`. |
keyword | string | opcional | Keywords. |
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.