Búsqueda de productos en Amazon
Busca productos de Amazon por palabra clave o por una lista exacta de ASIN y devuelve datos para validar oportunidades.
Ejemplos de datos de la API
Consulta el cuerpo de la solicitud y la estructura completa de la respuesta de este endpoint.
{
"marketplace": "US",
"keyword": "wireless charger",
"match_type": "broad",
"include_variations": false,
"page": 1,
"size": 20
}{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"guestId": null,
"pages": 8644,
"page": 1,
"size": 1,
"total": 8644,
"took": 754,
"url": null,
"order": {
"field": "",
"desc": true
},
"items": [
{
"asin": "B0DGVP84B5",
"brand": "Apple",
"brandUrl": "https://www.amazon.com/s?k=Apple",
"imageUrl": "https://images-na.ssl-images-amazon.com/images/I/61886B78v4L._AC_US200_.jpg",
"title": "Apple Watch Series 10 [GPS + Cellular 46mm] with Natural Titanium Case with Stone Grey Sport Band - S/M. Fitness Tracker, ECG App, Always-On Retina Display, Water Resistant with AppleCare+ (2 Years)",
"parent": "B0FH2CCLPX",
"nodeLabelPath": null,
"nodeIdPath": null,
"nodeId": null,
"bsrId": null,
"bsr": 4,
"bsrCv": -3,
"bsrCr": -300,
"amzUnit": null,
"amzUnitDate": null,
"amzSales": null,
"units": 167539,
"unitsGr": null,
"revenue": 123276872,
"price": 728.99,
"averagePrice": 735.81,
"primePrice": -1,
"profit": 98.52,
"fba": 10.75,
"ratings": 8707,
"ratingsRate": 0.66,
"rating": 4.7,
"ratingsCv": 1103,
"ratingDelta": 0,
"availableDate": 1726012800000,
"fulfillment": "AMZ",
"variations": 84,
"sellers": 1,
"sellerName": "Amazon",
"sellerId": null,
"sellerNation": "US",
"lqs": null,
"weight": "4.8 ounces",
"dimension": "24 x 7.7 x 3 inches",
"pkgDimensions": null,
"pkgDimensionType": null,
"pkgWeight": null,
"sku": "Color: Natural Titanium Case with Stone Grey Sport Band | Size: 46mm case + Small/Medium band | Style: GPS + Cellular | Configuration: With AppleCare+ (2 Years)",
"dimensionsType": "LB",
"deliveryPrice": -1,
"badge": {
"bestSeller": "#1 Best Seller in Smartwatches",
"amazonChoice": "N",
"newRelease": "N",
"ebc": "Y",
"video": "Y"
},
"subcategories": [
{
"code": "14130292011",
"rank": 1,
"label": "Smartwatches"
}
]
}
],
"terminal": null,
"hasNextPage": null,
"guestVisited": false
}
}Disponibilidad: disponible
Esta API está activa en el gateway v1, OpenAPI y el catálogo de planes. Cada llamada correcta consume 1 unidad.
POST /v1/amazon/product/competitor-lookup
Correspondencia de la API
| Elemento | Valor |
|---|---|
| MCP Code | competitor_lookup |
| Método REST original | POST |
| Ruta REST original | /v1/product/competitor-lookup |
| Documentación original | Ver la documentación oficial |
La ruta anterior /v1/amazon/products/search sigue disponible como alias obsoleto. Las solicitudes antiguas reciben las cabeceras Deprecation: true y Link hacia la ruta canónica.
Llamada rápida
Crea una clave API y guárdala como secreto del servidor:
export ECOMMERCE_DATA_API_KEY="your_api_key"
curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/product/competitor-lookup \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{"marketplace":"US","keyword":"wireless charger","match_type":"broad","include_variations":false,"page":1,"size":20}'La solicitud debe incluir directamente los campos JSON, sin envolverlos en request. Proporciona exactamente uno de keyword o asins; los campos no documentados se rechazan.
Parámetros
| Campo | Tipo | Obligatorio | Descripción | Ejemplo |
|---|---|---|---|---|
marketplace | String | No | Código del marketplace de Amazon. | US |
keyword | String | No | Palabra clave que se consulta. No se usa junto con asins. | wireless charger |
asins | Array | No | Lista de ASIN. No se usa junto con keyword. | ["B08CK5Z5Q1"] |
match_type | String | No | Tipo de coincidencia: broad, phrase o exact. | broad |
include_variations | Boolean | No | Incluye variantes del producto. | false |
page | Integer | No | Número de página desde 1. | 1 |
size | Integer | No | Resultados por página. | 20 |
Respuesta
{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"pages": 1,
"page": 1,
"size": 20,
"total": 1,
"items": [
{ "asin": "B08CK5Z5Q1", "title": "Example product", "price": 19.99 }
]
}
}request_id identifica la solicitud. Los elementos de data.items pueden incluir asin, brand, title, imageUrl, price, rating, ratings, bsr, units, revenue, fulfillment y categorías, según la disponibilidad del producto. Consulta el esquema OpenAPI para conocer todos los campos y sus tipos; no asumas que un campo opcional siempre está presente.
Node.js y Python
const response = await fetch(
'https://ecommercedataapi.com/v1/amazon/product/competitor-lookup',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
},
body: JSON.stringify({
marketplace: 'US',
keyword: 'wireless charger',
match_type: 'broad',
page: 1,
size: 20,
}),
}
);
const result = await response.json();
if (!response.ok)
throw new Error(`${result.error?.code}: ${result.error?.message}`);
console.log(result.data);import os, requests
response = requests.post(
"https://ecommercedataapi.com/v1/amazon/product/competitor-lookup",
headers={"X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"]},
json={"marketplace": "US", "keyword": "wireless charger", "match_type": "broad", "page": 1, "size": 20},
timeout=30,
)
response.raise_for_status()
print(response.json()["data"])Límites y uso responsable
Comprueba error.code y request_id en errores. Respeta Retry-After para 429, 503 y 504, y no reintentes automáticamente errores de validación o autenticación sin corregir la solicitud. Los precios, ventas estimadas y señales de competencia son datos para investigación; valida las decisiones de inventario, cumplimiento y rentabilidad con información independiente.