API de búsqueda amplia de productos de Amazon

Encuentra productos de Amazon por ventas, precio, valoraciones y logística. Invoca la API mediante REST o MCP desde 21 créditos por llamada.

Coste21 créditos / llamada

Probar en línea

POST · https://api.nexscope.ai/ss/productSearchMCP · nexscope_amazon_broad_product_search

Qué hace esta API

Encuentre los productos de Amazon por ventas, precio, calificaciones y cumplimiento.

Casos de uso de API de búsqueda amplia de productos de Amazon

Buscar productos que coincidan con un resumen de abastecimiento

Para encontrar productos que coincidan con un informe de abastecimiento, un analista de mercado presenta chatId y uid a la búsqueda de productos de Amazon Broad. Los productos devueltos, palabra clave, nodeIdPath ayudar a identificar productos que coincidan con los criterios de búsqueda solicitados.

Comparar una lista de búsqueda de productos

Un analista de mercado utiliza Amazon Broad Búsqueda de productos con chatId y uid comparar una lista de búsqueda de productos. Los productos devueltos, palabra clave, nodeIdPath ayudar a comparar candidatos antes de solicitar detalles individuales del producto.

Reunir a los candidatos para una revisión del mercado

Para este flujo de trabajo, un analista de mercado llama a la búsqueda de productos de Amazon Broad con chatId y uid para recoger candidatos para una revisión del mercado. El resultado ayuda a elegir productos para un proveedor o la revisión de competidor.

Preguntas frecuentes sobre API de búsqueda amplia de productos de Amazon

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

Encuentre los productos de Amazon por ventas, precio, calificaciones y cumplimiento. `products`, `keyword`, `nodeIdPath`, `nodeLabel`, `dataSnapshotMonth`, `sourceType`, `message`, `asin`. Corresponde a los parámetros proporcionados `chatId`, `uid`, `requestId`, `teamId`, `keyword`. 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 de Amazon Broad API ¿costo?

El coste documentado actualmente es 21 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 de Amazon Broad API desde mi aplicación o un MCP ¿Cliente?

Enviar a POST solicitud a /ss/productSearch 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_broad_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/ss/productSearch

Método MCP

nexscope_amazon_broad_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/ss/productSearch

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/ss/productSearch' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "keyword": "yoga mat",
  "marketplace": "US",
  "maxPrice": 50,
  "minPrice": 10,
  "minUnits": 300,
  "order": {
    "desc": "true",
    "field": "total_units"
  },
  "page": 1,
  "size": 20
}'

Ejemplo de código

{
  "keyword": "yoga mat",
  "marketplace": "US",
  "maxPrice": 50,
  "minPrice": 10,
  "minUnits": 300,
  "order": {
    "desc": "true",
    "field": "total_units"
  },
  "page": 1,
  "size": 20
}

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/ Inteligencia de Amazon SS

POSThttps://api.nexscope.ai/ss/productSearch

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/ss/productSearch`
Autenticación	`Bearer API key`
Content-Type	`application/json`

Parámetros de la solicitud

Nombre	Tipo	Obligatorio	Descripción
`chatId`	`string`	opcional	Id de conversación, maxLength 1000
`uid`	`string`	opcional	Identificador del usuario, maxLength 1000
`requestId`	`string`	opcional	Identificador de envío. maxLength es 1000 caracteres.
`teamId`	`string`	opcional	Equipo id, maxLength 1000
`keyword`	`string`	opcional	Palabras clave de búsqueda, se recomienda utilizar el idioma del sitio objetivo; maxLength 10240
`matchType`	`integer`	opcional	Método de coincidencia: `1` correspondencia de frases, `2` - ¿Qué? `3` correspondencia precisa Ejemplo: 1
`excludeKeywords`	`string`	opcional	Excluir las palabras clave; maxLength 10240
`marketplace`	`string`	opcional	Sólo `US`, `UK`, `DE`, `FR`, `JP`, `CA`, `IT`, `ES`, `MX`, `IN` permitido Ejemplo: US
`nodeLabel`	`string`	opcional	Nombre de la categoría de Amazon; maxLength 1000
`nodeIdPath`	`string`	opcional	ID del nodo de categoría Amazon; maxLength 1000
`filterSubNode`	`boolean`	opcional	Si filtrar nodos de subcategoría; solo tiene efecto cuando nodeLabel o nodeIdPath tiene un valor
`dataSnapshotMonth`	`string`	opcional	Datos de producto instantánea año y mes en `yyyyMM` formato, o `nearly` representa los últimos 30 días de datos en tiempo real; maxLength 1000 Ejemplo: nearly
`minPrice`	`number`	opcional	precio más bajo (> 0)
`maxPrice`	`number`	opcional	Precio más alto (> = 0)
`minProfit`	`number`	opcional	Margen de beneficio bruto mínimo, unidad % (1–100)
`maxProfit`	`number`	opcional	Máximo margen de beneficio bruto, unidad % (1–100)
`minRevenue`	`number`	opcional	Ventas mensuales mínimas (> 0)
`maxRevenue`	`number`	opcional	Las ventas mensuales más altas (> = 0)
`minFba`	`number`	opcional	Envío mínimo de FBA (> 0)
`maxFba`	`number`	opcional	Tasa máxima de envío de FBA (> 0)
`minUnits`	`integer`	opcional	Volumen mínimo de ventas mensuales (> 0)
`maxUnits`	`integer`	opcional	Las ventas mensuales más altas (> = 0)
`minAmzUnit`	`integer`	opcional	Volumen mínimo de ventas de los subcuerpos en los últimos 30 días; sólo `dataSnapshotMonth` es compatible con consultas en los últimos 30 días, el valor mínimo es 0
`maxAmzUnit`	`integer`	opcional	El mayor volumen de ventas del subgrupo en los últimos 30 días; sólo la consulta en los últimos 30 días es compatible, el valor mínimo es 0
`minUnitsGrowthRate`	`number`	opcional	Tasa mínima de crecimiento mensual de las ventas, % unitario
`maxUnitsGrowthRate`	`number`	opcional	Tasa máxima mensual de crecimiento de las ventas, % unitario
`minBsr`	`integer`	opcional	Categoría BSR, clasificación más baja
`maxBsr`	`integer`	opcional	Categoría superior de clasificación BSR
`minBsrGrowthRate`	`number`	opcional	Tasa de crecimiento mínimo de las RMB, % unitario
`maxBsrGrowthRate`	`number`	opcional	Tasa máxima de crecimiento de la RBS, % unitario
`minBsrGrowthCount`	`integer`	opcional	Número mínimo de crecimiento de la RMB
`maxBsrGrowthCount`	`integer`	opcional	BSR mayor número de crecimiento
`minSubNodeBsrRank`	`integer`	opcional	Subcategoría BSR clasificación más baja; requiere `filterSubNode=true`
`maxSubNodeBsrRank`	`integer`	opcional	Subcategoría BSR, clasificación máxima; requiere `filterSubNode=true`
`minRating`	`number`	opcional	Valor de calificación más bajo (0-5)
`maxRating`	`number`	opcional	Valor de calificación más elevado (0-5)
`minRatings`	`integer`	opcional	Número mínimo de calificaciones (0-10000)
`maxRatings`	`integer`	opcional	Número máximo de habilitaciones (0–10000)
`minRatingsGrowthCount`	`integer`	opcional	Número mínimo de nuevas calificaciones por mes (> = 0)
`maxRatingsGrowthCount`	`integer`	opcional	Número más alto de nuevas calificaciones por mes (> = 0)
`minListingQualityScore`	`number`	opcional	Puntuación mínima de calidad de la página de listado (>= 0)
`maxListingQualityScore`	`number`	opcional	Puntuación de calidad de página más alta (>= 0)
`minVariations`	`integer`	opcional	Número mínimo de variantes
`maxVariations`	`integer`	opcional	Número más elevado de variantes
`minWeights`	`number`	opcional	Peso mínimo (> 0)
`maxWeights`	`number`	opcional	Peso máximo (> 0)
`weightUnit`	`string`	opcional	Unidad de peso: `g`, `kg`, `oz`, `lb`;debe especificarse cuando se utilice el filtro de peso
`dimensionType`	`string`	opcional	Tamaño del envase tipo, por favor vea la descripción a continuación para cada código del sitio
`minSellers`	`integer`	opcional	Número mínimo de vendedores
`maxSellers`	`integer`	opcional	Número máximo de vendedores
`badgeBestSeller`	`string`	opcional	Logotipo de mejor vendedor: `Y`, `N` o dejar en blanco
`badgeAmazonsChoice`	`string`	opcional	Logotipo de Amazon's Choice: `Y`, `N` o dejar en blanco
`badgeNewRelease`	`string`	opcional	Nueva identificación de la versión: `Y`, `N` o dejar en blanco
`fulfillment`	`string`	opcional	Método de entrega: `AMZ`, `FBA`, `FBM`, múltiples valores separados por comas inglesas
`showVariation`	`string`	opcional	Si se deben consultar variantes: `Y` o `N` Ejemplo: N
`hideUnlistedProduct`	`boolean`	opcional	Si se deben ocultar los productos retirados Ejemplo: true
`listedWithinLastMonths`	`integer`	opcional	Plazos de validez (meses), únicamente `1`, `3`, `6`, `12`, `24` permitido
`sellerNation`	`string`	opcional	Código de ubicación del vendedor, varios valores separados por comas
`includeSellers`	`string`	opcional	Incluye al vendedor; maxLength 10240
`excludeSellers`	`string`	opcional	Excluidos los vendedores; maxLength 10240
`includeBrands`	`string`	opcional	Contiene la marca; maxLength 10240
`excludeBrands`	`string`	opcional	Excluir las marcas; maxLength 10240
`order`	`object`	opcional	Configuración de clasificación; se recomienda proporcionar ambos `field` y `desc` cuando pasa
`order.field`	`string`	opcional	Campos de clasificación: `total_units`, `total_amount`, `bsr_rank`, `price`, `rating`, `reviews`, `profit`, `reviews_rate`, `available_date`, `questions`, `total_units_growth`, `total_amount_growth`, `reviews_increasement`, `bsr_rank_cv`, `bsr_rank_cr`, `amz_unit`; pasar una cadena vacía significa no ordenar por los campos de negocio anteriores Ejemplo: total_units
`order.desc`	`string`	opcional	`"true"` orden descendente, `"false"` orden ascendente Ejemplo: true
`page`	`integer`	opcional	Número de página, a partir de 1 Ejemplo: 1
`size`	`integer`	opcional	Número de artículos por página, 10–100 Ejemplo: 20

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

Nombre	Tipo	Obligatorio	Descripción
`total`	`integer`	opcional	Número total de productos que coinciden
`products`	`array`	opcional	Lista de productos
`columns`	`array`	opcional	Definiciones de columna renderizadas
`keyword`	`string`	opcional	Buscar palabras clave utilizadas (si las hay)
`nodeIdPath`	`string`	opcional	Buscar nodo de categoría
`nodeLabel`	`string`	opcional	Nombre de la categoría Amazon
`dataSnapshotMonth`	`string`	opcional	Mes de consulta de datos
`sourceType`	`string`	opcional	Tipo de fuente, como `amazon`
`type`	`string`	opcional	estilo de renderizado
`message`	`string`	opcional	Mensaje adicional o mensaje de error
`costToken`	`integer`	opcional	Consumir token
`asin`	`string`	opcional	Amazon ASIN
`title`	`string`	opcional	Título del producto
`asinUrl`	`string`	opcional	Amazon detalle del producto página URL
`imageUrl`	`string`	opcional	Imagen del producto URL
`price`	`number`	opcional	Precio actual
`averagePrice`	`number`	opcional	Precio medio
`primePrice`	`number`	opcional	Precio principal, -1 significa ninguno
`currency`	`string`	opcional	Moneda
`monthlySalesUnits`	`integer`	opcional	ventas mensuales
`monthlySalesRevenue`	`number`	opcional	ventas mensuales
`monthlySalesUnitsGrowthRate`	`number`	opcional	tasa mensual de crecimiento de las ventas
`bsr`	`integer`	opcional	Clasificación BSR
`bsrGrowthRate`	`number`	opcional	Tasa de crecimiento de la RSE
`rating`	`number`	opcional	Calificación
`ratings`	`integer`	opcional	Número de calificación
`ratingsRate`	`number`	opcional	Tasa de revisión
`profit`	`number`	opcional	Margen de beneficio bruto (%)
`fba`	`number`	opcional	FBA naviera
`sellerNum`	`integer`	opcional	Número de vendedores
`sellerId`	`string`	opcional	ID del vendedor de BuyBox
`sellerName`	`string`	opcional	BuyBox vendedor nombre
`sellerNation`	`string`	opcional	BuyBox vendedor nacionalidad
`brand`	`string`	opcional	marca
`brandUrl`	`string`	opcional	Marca URL
`fulfillment`	`string`	opcional	Método de envío (AMZ)/FBA/FBM)
`availableDate`	`string`	opcional	Tiempo de liberación (momento)
`availableDateString`	`string`	opcional	Fecha de lanzamiento (cadena formateada)
`variationNum`	`integer`	opcional	número de variantes
`variant30DayUnits`	`integer`	opcional	Volumen mensual de ventas de cuerpos de hijas (número de piezas)
`variant30DayRevenue`	`number`	opcional	Ventas mensuales subsidiarias
`variant30DayUpdatedAt`	`string`	opcional	Tiempo de actualización de los datos del subsistema
`weight`	`string`	opcional	peso
`packageWeight`	`string`	opcional	Peso del envase
`dimension`	`string`	opcional	Tamaño
`packageDimensions`	`string`	opcional	Tamaño del envase
`dimensionsType`	`string`	opcional	tipo de tamaño
`packageDimensionType`	`string`	opcional	Tamaño del envase
`listingQualityScore`	`number`	opcional	Listado de puntuación de calidad
`deliveryPrice`	`number`	opcional	Cargo por envío del vendedor, -1 significa ninguno
`nodeLabelPath`	`string`	opcional	Ruta de categoría
`nodeIdPath`	`string`	opcional	Ruta del ID del nodo
`nodeId`	`integer`	opcional	ID del nodo
`dataSnapshotMonth`	`string`	opcional	Mes de consulta de datos
`badgeBestSeller`	`string`	opcional	Logotipo del mejor vendedor (Y/N)
`badgeAmazonChoice`	`string`	opcional	Logotipo de la opción de Amazon (Y/N)
`badgeNewRelease`	`string`	opcional	Logotipo de nueva versión (Y/N)
`badgeVideo`	`string`	opcional	Logotipo de introducción de vídeo (Y/N)
`badgeEbc`	`string`	opcional	Identificación de la página A+ (Y/N)
`badge`	`object`	opcional	Objeto de resumen de identidad, incluido `bestSeller`, `amazonChoice`, `newRelease`, `video`, `ebc`
`subcategories`	`array`	opcional	Lista de subcategorías, cada una de las cuales contiene: `code`, `rank`, `label`
`sku`	`string`	opcional	SKU
`keyword`	`string`	opcional	Palabras clave correspondientes al filtrado
`sourceType`	`string`	opcional	Tipo de fuente

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_broad_product_search",
    "arguments": {
      "keyword": "phone case",
      "marketplace": "US",
      "matchType": 1,
      "page": 1,
      "size": 20
    }
  }
}

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.

21 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

/ss/productSearch

Método de MCP

nexscope_amazon_broad_product_search

Clave de API*

Contenido JSON*

cURL

curl -X POST \
  https://api.nexscope.ai/ss/productSearch \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "keyword": "yoga mat", "marketplace": "US", "maxPrice": 50, "minPrice": 10, "minUnits": 300, "order": { "desc": "true", "field": "total_units" }, "page": 1, "size": 20 }'

Respuesta

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

API relacionadas

Amazon Competitor Lookup

Compare competing Amazon products by sales, price, and growth.

Amazon Market Research

Assess niche size, competition, and seller concentration.

Amazon Market Statistics

Compare sales, prices, and ratings within an Amazon category.

Amazon Traffic Keywords

Find keywords bringing traffic to an Amazon product and compare organic and ad rankings.