API de búsqueda de productos del mercado de Amazon

Filtra productos de Amazon con datos del mercado e instantáneas mensuales. Invoca la API mediante REST o MCP desde 42 créditos por llamada.

Coste42 créditos / llamada

Probar en línea

POST · https://api.nexscope.ai/st/amazon/productQueryMCP · nexscope_amazon_market_product_search

Qué hace esta API

Filtrar productos de Amazon usando datos de mercado y instantáneas mensuales.

Casos de uso de API de búsqueda de productos del mercado de Amazon

Comparar las pruebas de mercado

Para comparar las pruebas de mercado, un analista del mercado presenta mercado y queryMode a Amazon Market Búsqueda de Productos. La página devuelta, pageCount, requestConsumed ayudar a comparar las señales de investigación de mercado o producto solicitadas.

Revisar una señal de demanda de productos

Un analista de mercado utiliza Amazon Market Búsqueda de productos con mercado y queryMode revisar una señal de demanda de producto. pageCount, requestConsumed ayudar a identificar la demanda de pruebas que vale la pena verificar contra otras fuentes.

Preparar un examen de fuentes o inventarios

Para este flujo de trabajo, un analista de mercado llama Amazon Market Product Search con marketplace y queryMode El resultado ayuda a informar a un examen de abastecimiento sin asumir futuras ventas.

Preguntas frecuentes sobre API de búsqueda de productos del mercado de Amazon

¿Qué hace la búsqueda de productos del mercado de Amazon API ¿Volver?

Filtrar productos de Amazon utilizando datos de mercado y instantáneas mensuales. La salida documentada incluye `page`, `pageCount`, `requestConsumed`, `products`, `asin`, `title`, `brand`, `asinUrl`. Corresponde a los parámetros proporcionados `marketplace`, `queryMode`, `queryType`, `queryValue`, `page`. Los campos opcionales pueden estar ausentes; un valor que falta no debe interpretarse como un cero medido. Los valores de ejemplo ilustran la forma de respuesta, en lugar de los resultados reales de la cuenta.

¿Cuántos créditos hace la búsqueda de productos del mercado de Amazon API ¿costo?

El coste documentado actualmente es 42 créditos / llamada. Es el mismo que figura en la parte superior de esta página. Si se muestra un intervalo o una estimación, el cargo final depende de la solicitud. Antes de llamar a la API, revisa los créditos disponibles y la página de precios. Consulta el registro de uso de la API para comprobar el cargo aplicado.

¿Cómo llamo a la búsqueda de productos del mercado de Amazon? API desde mi aplicación o un MCP ¿Cliente?

Enviar a POST solicitud a /st/amazon/productQuery con tu API como un símbolo de portador y la JSON datos de entrada API En una MCP cliente como Claude o Cursor, conectar Nexscope y llamar nexscope_amazon_market_product_search. Utilice el MCP argumentos mostrados en el MCP guía, o cambiar la prueba en línea a MCP para revisar su solicitud antes de añadirla a tu aplicación.

Ver planes y créditos Conecta esta API con MCP (en inglés)

Prueba esta API

Endpoint

https://api.nexscope.ai/st/amazon/productQuery

Método MCP

nexscope_amazon_market_product_search

Paso 1 de 3 · Autenticarse

Autenticación

Todos los endpoints de ejecución requieren una clave de API de usuario. Envíala como token bearer en la cabecera Authorization .

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

Las claves de API ausentes o no válidas devuelven un error de autenticación. Gestiona las claves desde .

Paso 2 de 3 · Enviar una solicitud

POSThttps://api.nexscope.ai/st/amazon/productQuery

Ejecutar una API

Envía un cuerpo de solicitud JSON usando los parámetros descritos abajo.

Solicitud de ejemplo

Sustituye YOUR_API_KEY y ejecuta este comando en tu terminal.

curl -X POST 'https://api.nexscope.ai/st/amazon/productQuery' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "marketplace": "us",
  "queryMode": 1,
  "queryType": 2,
  "queryValue": "3743561"
}'

Ejemplo de código

{
  "marketplace": "us",
  "queryMode": 1,
  "queryType": 2,
  "queryValue": "3743561"
}

Paso 3 de 3 · Inspeccionar el resultado

Comprueba la respuesta

Consulta code para ver el estado de la solicitud y data para ver el resultado. Abre la referencia de parámetros y respuestas para consultar las definiciones completas de los campos.

Códigos de estado HTTP

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.

Ver parámetros y respuesta Probar en línea

Todas las categorías/ Investigación de Amazon ST

POSThttps://api.nexscope.ai/st/amazon/productQuery

Ejecutar esta API

Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.

Abrir área de pruebas

Endpoint

Método	`POST`
Ruta	`https://api.nexscope.ai/st/amazon/productQuery`
Autenticación	`Bearer API key`
Content-Type	`application/json`

Parámetros de la solicitud

Nombre	Tipo	Obligatorio	Descripción
`marketplace`	`string`	obligatorio	Códigos de sitio del Amazonas: `us`, `gb`, `de`, `fr`, `in`, `ca`, `jp`, `es`, `it`, `mx`, `ae`, `au`, `br`, `sa`. Usos del Reino Unido `gb`. UA, BR, y IN no apoyan revisión histórica.
`queryMode`	`integer`	opcional	Método de consulta: `1` una sola condición, `2` combinación multicondición (AND). Ejemplo: 1
`queryType`	`integer`	opcional	Tipo de consulta de una sola condición, rango 1-16; no válido cuando `queryMode=2`. Véase el cuadro que figura a continuación.
`queryValue`	`string`	opcional	Valor de la consulta, el formato está determinado por `queryType`; cuando `queryMode=2`, el JSON condición de la cadena de matriz se pasa en.
`page`	`integer`	opcional	Números de página; máximo 100 productos por página, máximo 200 páginas. Ejemplo: 1
`queryMonth`	`string`	opcional	Mes histórico de instantáneas, formato `yyyy-MM`; consultar datos en tiempo real si no se especifica, soportados desde 2024-01.

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 (49 campos)

Nombre	Tipo	Obligatorio	Descripción
`code`	`integer`	opcional	Código de respuesta, `200` indica éxito.
`msg`	`string`	opcional	Responda al mensaje.
`total`	`integer`	opcional	Número total de resultados.
`page`	`integer`	opcional	Número actual de página.
`pageCount`	`integer`	opcional	Número total de páginas, hasta 200 páginas.
`costTime`	`integer`	opcional	Tiempo tomado, unidad ms.
`costToken`	`integer`	opcional	El número de fichas consumidas.
`requestConsumed`	`integer`	opcional	Número de solicitudes recibidas.
`type`	`string`	opcional	Estilo de representación.
`columns`	`array`	opcional	Renderiza la columna.
`products`	`array`	opcional	Lista de productos; los campos de elementos se muestran en la tabla de abajo.
`asin`	`string`	opcional	ASIN。
`title`	`string`	opcional	Título del producto.
`brand`	`string`	opcional	marca.
`asinUrl`	`string`	opcional	Amazon Lista de detalle página URL.
`imageUrl`	`string`	opcional	Imagen principal URL.
`productImageUrls`	`array`	opcional	Todas las URLs de imagen del producto.
`parentAsin`	`string`	opcional	Padre ASIN; `null` si no hay niños.
`variationNum`	`integer`	opcional	Número de variantes.
`weight`	`string`	opcional	Peso, unidad g.
`size`	`array`	opcional	Dimensiones exteriores del envase `[longest side, second longest side, shortest side]`, unidad cm.
`price`	`number`	opcional	Precio actual, antes de cupones, en moneda local.
`oldPrice`	`number`	opcional	Precio de la huelga en moneda local.
`salesPrice`	`number`	opcional	Precio después de deducir cupones, en moneda local.
`coupon`	`integer`	opcional	Política de cupones; valor no negativo es el importe de descuento, valor negativo es el porcentaje de descuento.
`fbaFees`	`number`	opcional	Tasas de FBA en moneda local.
`fbaDetail`	`array`	opcional	Detalles de la FBA.
`platformFee`	`number`	opcional	Comisión de la plataforma, en moneda local.
`profitAmount`	`number`	opcional	Resultado, calculado como precio recibido - comisión de la FBA - comisión, en moneda local.
`profitRate`	`number`	opcional	Margen de beneficio, por ejemplo `25.83` significa el 25,83 %.
`monthlySalesUnits`	`integer`	opcional	Lista de las ventas mensuales en los últimos 30 días; `-1` indica que no puede ser estimado.
`monthlySalesRevenue`	`number`	opcional	- Las ventas mensuales estimadas en moneda local; `-1` no pueden estimarse los medios.
`listingSalesVolumeOfDaily`	`integer`	opcional	Listar el volumen de ventas diarias; `-1` significa que no puede ser estimado.
`listingSalesOfDaily`	`number`	opcional	Lista de ventas diarias en moneda local; `-1` significa que no puede ser estimado.
`salesRank`	`integer`	opcional	Clasificación de la categoría BSR. Cuanto menor sea el valor, mejor será el ranking.
`category`	`array`	opcional	Categoría `[category name, NodeId]`.
`bsrCategory`	`array`	opcional	Lista de clasificación de categorías pequeñas, entre los elementos se incluyen `nodeId`, `name`, `rank`, `date` (`yyyyMMdd`).
`rating`	`number`	opcional	Valoración actual, rango 0,0-5.0.
`ratings`	`integer`	opcional	Número de valoraciones.
`availableDate`	`string`	opcional	Plazo de presentación de la solicitud, formato `yyyy-MM-dd`.
`onlineDays`	`integer`	opcional	Número de días en la estantería.
`buyboxSeller`	`string`	opcional	Buybox nombre del vendedor.
`buyBoxSellerId`	`string`	opcional	ID del vendedor de cajas de compra.
`buyboxSellerAddress`	`string`	opcional	El código de dos dígitos del país/región del vendedor de Buybox; cuando Amazon es auto-operado, es `null`.
`isFBA`	`boolean`	opcional	Haga Buybox vendedores utilizan FBA.
`sellerNum`	`integer`	opcional	Número de vendedores.
`aPlus`	`boolean`	opcional	A+ o no.
`hasVideo`	`boolean`	opcional	¿Hay un video?
`hasBrandStore`	`boolean`	opcional	¿Hay una tienda de marcas?

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.

Paso 1 de 2 · Conectar tu cliente MCP

MCP

Usa el endpoint MCP cuando un agente necesite descubrir y llamar a herramientas de API con JSON-RPC.

GET /mcp/legacy

POST /mcp/legacy
Authorization: Bearer nk-xxxxxxxxxxxxxxxxx
Content-Type: application/json

Paso 2 de 2 · Llamar a la herramienta

Llamar a una herramienta

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_market_product_search",
    "arguments": {
      "marketplace": "us",
      "page": 1,
      "queryMode": 1,
      "queryType": 1,
      "queryValue": "B072MQ5BRX"
    }
  }
}

Prueba en línea

Ejecuta la API actual con tu clave de API y la carga JSON. Las pruebas en línea usan el entorno de API configurado de este sitio; el Endpoint y los ejemplos que puedes copiar usan la dirección de integración pública.

42 créditos / llamadaRegistros de uso de la API

Pruébalo

Envía una solicitud real con el mismo contrato que se muestra en la referencia.

Endpoint

/st/amazon/productQuery

Método de MCP

nexscope_amazon_market_product_search

Clave de API*

Contenido JSON*

cURL

curl -X POST \
  https://api.nexscope.ai/st/amazon/productQuery \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "marketplace": "us", "queryMode": 1, "queryType": 2, "queryValue": "3743561" }'

Respuesta

Todavía no hay respuesta. Ejecuta la solicitud para ver la respuesta aquí.

API relacionadas

Amazon Market Product Detail

Look up product details and historical trends by ASIN.