Compras · Walmart
API de búsqueda de Walmart
La API de búsqueda de Walmart te da datos de Walmart en tiempo real en el momento en que los pides, limpios y estructurados, listos para tu propia app, una hoja de cálculo o un asistente de IA. Sin scraping, nada que mantener.
100 solicitudes gratis al mes · sin tarjeta de crédito · una clave de API para todas las plataformas
Datos clave
Actualizado el
Al escribir una palabra clave en walmart.com aparece una cuadrícula de hasta 40 productos por página, cada uno con precio, precio anterior tachado, valoración en estrellas, vendedor e insignia de stock. La API de búsqueda de Walmart de everydata.io ejecuta esa misma búsqueda por ti (cualquier palabra clave, cualquier página, ordenada por relevancia, más vendidos o precio) y devuelve los datos de resultados de Walmart en JSON. Es la forma más rápida de descubrir los usItemId de una categoría, ver quién se posiciona para un término de búsqueda o construir una comparación de precios entre todos los vendedores que compiten en una consulta.
- Plataforma
- Walmart
- Endpoint principal
- /walmart-search-by-keyword
- Cuota por llamada
- 1 solicitud
- Plan gratuito
- 100 solicitudes / mesdespués, desde 30 € / mes
Datos de Walmart, listos para usar
La parte superior de la respuesta repite tu consulta: keyword, sortStrategy y domainCode. La lista de resultados está en item.props.pageProps.initialData.searchResult, donde aggregatedCount da el número total de coincidencias (3998 para "Lego star wars" en el ejemplo) e itemStacks[0].items es la cuadrícula de productos. Cada elemento con __typename Product incluye usItemId, name, canonicalUrl, image, price como número y un bloque priceInfo con itemPrice, wasPrice, linePriceDisplay ("Now $15.99") y savingsAmt.
También llega el contexto del ranking: flag marca insignias de Walmart como "Popular pick" o "Best seller", rating.averageRating y numberOfReviews aportan prueba social, sellerName indica si la oferta es de Walmart.com o de un vendedor del marketplace, y fulfillmentSpeed / fulfillmentType muestran si el artículo se envía, está hoy en una tienda o es solo para recogida. isOutOfStock y availabilityStatusDisplayValue te permiten descartar artículos no disponibles antes de consultarlos en detalle.
- usItemId, name, canonicalUrl e image de cada resultado: el ID sirve directamente para los endpoints de producto y reseñas
- price (número) más priceInfo.itemPrice, wasPrice, savingsAmt y el texto que ven los compradores
- rating.averageRating y numberOfReviews por resultado
- sellerName y sellerId para separar las ofertas propias de Walmart de las del marketplace
- Insignias flag ("Popular pick", "Best seller"), isOutOfStock, fulfillmentSpeed y fulfillmentType
- aggregatedCount para toda la consulta y variantList para artículos con varias variantes
- Ordenación con sortBy: best_match (por defecto), best_seller, price_low, price_high
Lo que los equipos construyen con esto
Seguimiento de posiciones en la búsqueda
Las marcas registran cada día dónde aparecen sus artículos para sus palabras clave principales con best_match y best_seller, junto con la insignia flag y los vendedores que compiten a su alrededor.
Descubrimiento de surtido
Recopila los usItemId de toda una categoría ("cordless drill", "air fryer", "Lego star wars") página a página y enriquece después la lista corta con consultas de producto y reseñas.
Análisis de la escala de precios
Ordena por price_low y price_high para ver las ofertas más baratas y más caras de una consulta y en qué franja se sitúa tu propio producto.
Inteligencia competitiva sobre vendedores
Agrupa los resultados por sellerName para ver qué parte de la primera página tiene Walmart.com frente a los vendedores del marketplace y qué vendedores dominan un nicho.
Solicitud y respuesta de ejemplo
Llama a GET /wlm/walmart-search-by-keyword con keyword y page; ambos son obligatorios, así que empieza en page=1 y ve incrementando. Añade sortBy=best_seller para reproducir el orden de más vendidos de Walmart, o price_low / price_high para una escala de precios. El ejemplo está reducido a un producto; una página real tiene hasta 40 elementos, y los resultados patrocinados y los módulos de anuncios aparecen con otros valores de __typename.
GET /wlm/walmart-search-by-keyword
curl "https://api.everydata.io/wlm/walmart-search-by-keyword?keyword=Lego+star+wars&page=1&sortBy=best_seller" \
-H "x-api-key: YOUR_API_KEY"Respuesta (abreviada)
{
"responseStatus": "PRODUCT_FOUND_RESPONSE",
"responseMessage": "Product successfully found!",
"sortStrategy": "best_seller",
"domainCode": "com",
"keyword": "Lego star wars",
"item": {
"page": "/search",
"query": {
"q": "Lego star wars",
"page": "1",
"sort": "best_seller"
},
"props": {
"pageProps": {
"initialData": {
"searchResult": {
"title": "Results for \"Lego star wars\"",
"aggregatedCount": 3998,
"itemStacks": [
{
"count": 3998,
"items": [
{
"__typename": "Product",
"usItemId": "1520961263",
"name": "LEGO Star Wars 501st Clone Troopers Battle Pack Set 75345",
"canonicalUrl": "/ip/LEGO-Star-Wars-501st-Clone-Troopers-Battle-Pack-Set-75345/1520961263",
"image": "https://i5.walmartimages.com/seo/LEGO-Star-Wars-501st-Clone-Troopers-Battle-Pack-Set-75345.jpeg",
"price": 15,
"priceInfo": {
"itemPrice": "$19.97",
"linePrice": "$15.99",
"wasPrice": "$19.97",
"linePriceDisplay": "Now $15.99",
"savingsAmt": 3.98,
"savings": "SAVE $3.98"
},
"rating": {
"averageRating": 4,
"numberOfReviews": 287
},
"flag": "Popular pick",
"availabilityStatusDisplayValue": "In stock",
"isOutOfStock": false,
"fulfillmentSpeed": [
"TODAY"
],
"fulfillmentType": "STORE",
"sellerName": "Walmart.com",
"numberOfReviews": 287
}
]
}
]
}
}
}
}
}
}Filtra los elementos por __typename === "Product" antes de mapearlos. La cuadrícula contiene también módulos de anuncios, banners de marca y bloques de "búsquedas relacionadas" que comparten el array pero no tienen usItemId. La posición en el array filtrado es el ranking orgánico que verías en la página para ese orden y ese contexto de tienda.
La paginación es explícita: mantén la misma keyword y el mismo sortBy, aumenta page de uno en uno y para cuando se agote aggregatedCount o el array items llegue vacío. Walmart limita la profundidad de una búsqueda, así que las palabras clave muy amplias no devolverán las 3998 coincidencias: acota la palabra clave o divide por orden de clasificación para cubrir más surtido.
Los precios de los resultados de búsqueda son los del contexto de tienda de la ubicación predeterminada y pueden diferir en unos céntimos de la página del producto tras un cambio de precio. Cuando un resultado importa comercialmente, confírmalo con /wlm/walmart-lookup-product usando el canonicalUrl que ya tienes.
Endpoints relacionados
Buscar productos. Búsqueda por palabra clave con paginación y ordenación.
Detalles del producto. Página de producto por URL.
Reseñas. Reseñas de clientes paginadas de un producto.
Paga por solicitud, con todas las plataformas incluidas
Cada página de búsqueda es una solicitud, devuelva 40 productos o 3. Seguir 50 palabras clave en las tres primeras páginas cada día son 150 solicitudes diarias, unas 4500 al mes, dentro del plan Starter (5000 solicitudes, 30 €). Conjuntos de palabras clave mayores caben en Production (50.000 solicitudes, 80 €) o Business (300.000, 300 €). Las consultas fallidas al sitio de origen nunca se cuentan.
- Free
- 100 solicitudes / mes
- Starter
- 5000 solicitudes · 30 €
- Production
- 50.000 solicitudes · 80 €
- Business
- 300.000 solicitudes · 300 €
API de búsqueda de Walmart: preguntas frecuentes
¿Cuántos resultados contiene una página?
Walmart muestra hasta 40 productos por página. El número exacto varía según los anuncios y módulos de la cuadrícula, así que filtra siempre por __typename Product.
¿Qué opciones de ordenación hay?
sortBy acepta best_match (por defecto), best_seller, price_low y price_high. La respuesta repite el valor aplicado en sortStrategy.
¿page es realmente obligatorio?
Sí, keyword y page son obligatorios. Empieza con page=1 y avanza; no hay cursor.
¿Puedo buscar en walmart.ca?
De momento la búsqueda por palabra clave se ejecuta en walmart.com y devuelve domainCode com. Para Canadá hay cobertura de reseñas con domainCode=ca.
¿Los resultados incluyen productos patrocinados?
Los datos de resultados contienen lo que muestra la página, incluidos los resultados patrocinados. Los patrocinados se reconocen por los flags y módulos propios del elemento, así que puedes excluirlos del cálculo del ranking orgánico.
Casos de uso relacionados
Lanza tu primera búsqueda en Walmart
Crea una cuenta gratuita y llama al endpoint de búsqueda con cualquier palabra clave: 100 solicitudes al mes incluidas, sin tarjeta de crédito.