Una API de búsqueda de productos recibe una palabra clave y devuelve productos en JSON. Suena a «los resultados de búsqueda de Amazon, sin la página». No es exactamente eso, y la diferencia decide si los resultados sirven.
Dos ajustes importan más que todo lo demás en la petición: el tipo de concordancia y saber cómo se ordenan los resultados.
Una palabra clave, tres tipos de concordancia
El 12 de octubre de 2026 ejecutamos la misma palabra clave, pet water fountain, en el marketplace de Estados Unidos, cambiando solo match_type:
match_type | Productos coincidentes | Qué apareció primero |
|---|---|---|
broad (el valor por defecto) | 265.533 | Agua embotellada, una botella térmica, toallitas para bebé |
phrase | 1.880 | Fuentes para mascotas y filtros de recambio, todo en Productos para mascotas |
exact | 750 | La misma categoría, reducida a títulos que contienen la frase |
El resultado amplio no es un error de los datos. La concordancia amplia acepta productos que contengan cualquiera de las palabras, y «water» coincide con una parte muy grande del catálogo. Los productos más vendidos que contienen alguna de tus palabras salen primero, y ninguno de los primeros era una fuente para mascotas.
Así que, para investigar productos, pon match_type en phrase o exact salvo que de verdad quieras todos los productos cercanos a una palabra. Dejar el valor por defecto es el motivo más habitual de que una primera prueba parezca errónea.
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": "pet water fountain",
"match_type": "phrase",
"include_variations": false,
"page": 1,
"size": 20
}'Los resultados se ordenan por ventas estimadas
En las tres pruebas, los elementos llegaron en orden descendente de units, las ventas mensuales estimadas en unidades. En concordancia de frase, los ocho primeros iban de 32.461 a 6.290.
Ese no es el orden que ve un comprador. La página de resultados de Amazon se ordena según su propia clasificación de relevancia e incluye posiciones patrocinadas. Este endpoint responde a otra pregunta: de los productos que coinciden con esta palabra clave, cuáles venden más.
Es el orden correcto para dimensionar el mercado de una palabra clave. Es el orden equivocado si necesitas saber quién ocupa la posición 3.
Qué contiene cada elemento
| Campo | Qué te dice |
|---|---|
asin, parent, title, brand | Qué producto es y cuál es su listing padre |
price, averagePrice | Precio actual y precio medio |
bsr, subcategories | Ranking de más vendidos y rankings de subcategoría |
units, revenue | Unidades e ingresos mensuales estimados |
rating, ratings | Valoración en estrellas y número de valoraciones |
sellers, sellerNation, fulfillment | Cuántos vendedores hay, dónde está el vendedor y cómo se envía |
nodeLabelPath | La ruta de categoría, como Pet Supplies:Cats:Feeding & Watering Supplies:Fountains |
availableDate | Fecha de alta, como marca de tiempo en milisegundos |
La respuesta también incluye total y pages. page llega hasta 100 y size hasta 200.
La página de la API de búsqueda de productos de Amazon tiene la lista completa de campos.
Tres cosas que hacer con los resultados
1. Filtra por categoría antes de contar. Incluso en concordancia de frase, la prueba devolvió filtros de recambio junto a las fuentes: los accesorios llevan en el título la palabra clave del producto principal. Agrupa por nodeLabelPath y por precio antes de tratar la lista como un solo mercado.
2. Lee units en el nivel correcto. units es la estimación del listing padre, así que un producto con muchas variaciones parece mayor que un competidor de una sola variación. include_variations controla si las variaciones se listan por separado. ASIN padre e hijo explica qué se agrupa.
3. Mira cómo se reparten las ventas. Si los tres primeros productos concentran la mayoría de las unidades, la palabra clave está concentrada; si las unidades caen despacio, hay sitio más abajo. Llevar una palabra clave a la primera página explica cómo leer ese reparto.
Cuándo necesitas posiciones de búsqueda
Si la pregunta es «en qué posición está este producto para esta palabra clave», usa una búsqueda inversa en lugar de una búsqueda de productos. El endpoint de palabras clave de tráfico devuelve, para un ASIN, los términos para los que aparece, con rankPosition (orgánica) y adPosition (patrocinada). Búsqueda inversa de palabras clave por ASIN muestra cómo leerlo.
| Quieres saber | Usa |
|---|---|
| Qué productos venden más para una palabra clave | Búsqueda de productos, phrase o exact |
| Precio, ranking y ventas de una lista de ASIN | Búsqueda de productos con asins (búsqueda por ASIN) |
| En qué posición está un producto para sus palabras clave | Búsqueda inversa |
| Todos los productos de una categoría según filtros | Endpoint de investigación de productos |
Lo que estos datos no pueden hacer
No reproducen la página de resultados de un comprador. Sin posiciones patrocinadas, sin personalización, sin el diseño de la página.
units y revenue son estimaciones. Sirven para ordenar productos entre sí, no como volúmenes exactos. Consulta qué dicen y qué no dicen los datos de ventas de Amazon.
Una instantánea es un día. La prueba anterior refleja el 12 de octubre de 2026; los totales cambian.
Preguntas frecuentes
¿Es esto la Amazon Product Advertising API? No. Esa API es para afiliados que crean enlaces de producto. Este endpoint devuelve campos de investigación como las ventas estimadas y el BSR.
¿Qué tipo de concordancia debo usar?
Empieza por phrase. Usa exact cuando la de frase siga trayendo demasiados productos poco relacionados, y broad solo cuando quieras todo lo cercano a una palabra.
¿Puedo buscar por ASIN en lugar de por palabra clave?
Sí. Envía asins con hasta 40 ASIN en lugar de keyword. Envía uno u otro, no ambos.
¿Puedo obtener el orden de posicionamiento orgánico de Amazon? No con la búsqueda de productos. Para la posición de un producto en un término, usa la búsqueda inversa.