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 | Número total de filas. |
keyword | string | opcional | Buscar palabras clave. |
type | string | opcional | Estilo de representación. |
sellerSpriteEnriched | boolean | opcional | Si se permitió el enriquecimiento adicional de datos sobre productos para esta solicitud. Puede estar ausente. No hay un indicador de derecho de plan o cuenta y no una garantía de que cada producto fue enriquecido. Ejemplo: false |
columns | array | opcional | Definiciones de columna renderizadas. |
costToken | integer | opcional | Consumir Token. |
products | array | opcional | Lista de resultados de la búsqueda. |
asin | string | opcional | ASIN。 |
title | string | opcional | título. |
brand | string | opcional | marca. |
price | number | opcional | precio. |
extractedPrice | number | opcional | El precio de la persiana. |
oldPrice | number | opcional | Destacar el precio. |
extractedOldPrice | number | opcional | El analizado subrayaba el precio. |
currency | string | opcional | Moneda. |
priceUnit | string | opcional | unidad de precio. |
extractedPriceUnit | number | opcional | La unidad de precio analizado. |
rating | number | opcional | Puntuación. |
ratings | integer | opcional | Número de calificación. |
position | integer | opcional | ubicación. |
sponsored | boolean | opcional | Patrocinador o no. |
imageUrl | string | opcional | En miniatura. |
asinUrl | string | opcional | Enlace al producto. |
delivery | string | opcional | Información de envío. |
fulfillment | string | opcional | Información de envío, como FBA. |
availableDate | string (date) | opcional | Fecha de inclusión en la lista de fuentes de datos, poblada a través includeSellerSpriteData=true cuando esté disponible; puede que todavía esté ausente. No hay una fecha de lanzamiento de marca verificada; zona horaria no está especificada. ASIN buscar, utilizar amazon-producto-historia o amazon-mercado-producto-detalles. |
monthlySalesUnits | integer | opcional | Volumen de ventas mensual. |
monthlySalesRevenue | string | opcional | Ventas mensuales. |
sellerNation | string | opcional | Nacionalidad del vendedor. |
dimension | string | opcional | tamaño. |
weight | string | opcional | peso. |
options | string | opcional | opciones. |
offers | string | opcional | Ofrecer información. |
badges | string | opcional | Logo de búsqueda frontal de Amazon. |
tags | string | opcional | etiqueta. |
snapEbtEligible | boolean | opcional | SNAP/EBT elegibilidad. |
sourceType | string | opcional | Tipo de fuente: `amazon`. |
keyword | string | opcional | Palabras clave. |
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.