API de Walmart: Buscar
Search Walmart by keyword with optional sort, price-range, facet, and page filters and get title, price, rating, seller, and availability for each product in one normalized response.
Precios y proveedores
Precios del endpoint Buscar de la API de Walmart: una API, 2 proveedores intercambiables
El proveedor más barato responde primero. Si falla, el siguiente toma el relevo en la misma llamada.
Pruébalo
Obtén Buscar de Walmart en una sola solicitud
{
"data": {
"items": [
{
"availability": "example",
"brand": "Acme Inc",
"currency": "USD",
"image": "https://example.com/image.jpg",
"inStock": true,
"isSponsored": true,
"itemId": "a1b2c3d4",
"listPrice": 19.99,
"position": 1,
"price": 19.99,
"rating": 4.6,
"reviewsCount": 12500,
"sellerId": "a1b2c3d4",
"sellerName": "Example title",
"title": "Example title",
"url": "https://example.com/page"
}
],
"totalPages": 12500,
"totalResults": 12500
},
"found": true,
"reason": "not_found"
}Referencia completa de parámetros y respuesta: cada campo, tipo y ejemplo de este endpoint.
Referencia
Una solicitud, un formato de respuesta.
Cada campo que envías y cada campo que recibes, cada uno con un ejemplo real.
Verificado por última vez el 2026-11-21 · disponibilidad y latencia medidas en 30d
Cuerpo de la solicitud
JSON, enviado por POST a este endpoint.
- querystring
airpods
Search keywords, e.g. "airpods" or "paper towels".
- facetstring
Optional Walmart facet filter token, e.g. brand:HP to keep only HP products.
- maxPricenumber
Optional maximum product price in USD.
- minPricenumber
Optional minimum product price in USD.
- pageinteger
1-based results page of about 40 to 60 products; Walmart serves no products past page 10. Each page is billed as one request. Walmart re-ranks between requests, so consecutive pages can repeat a product: deduplicate on itemId.
- requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `totalPages`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. Naming a combination that no single source returns together is refused as invalid input, with no charge.
- sortenum
best_seller
Result sort order; omit for Walmart's Best Match (e.g. price_low sorts by lowest price first).
Respuesta
JSON, un valor de ejemplo por campo.
Matching Walmart product records for the requested page. Populated whenever the provider has data for the entity.
- availabilitystring
Stock status as Walmart reports it, e.g. "IN_STOCK" or "OUT_OF_STOCK".
- brandstring
Brand name, or null when Walmart omits it from the search grid (it publishes brand on clothing-style grids and on no row elsewhere; the Walmart Product SKU always carries it).
- currencystring
Price currency code, e.g. "USD"; empty when no price is shown.
- imagestring
Primary product image URL. Populated whenever the provider has data for the entity.
- inStockboolean
True when the product is in stock, false when it is not, or null when not reported.
- isSponsoredboolean
True when the result is a sponsored placement.
- itemIdstring
Walmart US item id (usItemId), the number in a walmart.com/ip/ URL; use the product URL with the Walmart Product or Walmart Reviews SKU. Populated whenever the provider has data for the entity.
- listPricenumber
Pre-discount "was" price when the product is on sale, or null when it is not discounted.
- positioninteger
1-based position of the result in this page.
- pricenumber
Current price in USD as a number, or null when the result shows no current price. Populated whenever the provider has data for the entity.
- ratingnumber
Average customer rating, 0-5, or null when the product is unrated.
- reviewsCountinteger
Number of customer ratings, or null when the product has none.
- sellerIdstring
Identifier of the seller fulfilling the shown offer.
- sellerNamestring
Name of the seller fulfilling the shown offer.
- titlestring
Product title. Populated whenever the provider has data for the entity.
- urlstring
Walmart product page URL with tracking query parameters removed. Populated whenever the provider has data for the entity.
Search result wrapper, or null when nothing matched.
- totalPagesintegerse puede exigir
Highest page number available for the query; request pages 1 through this value. Absent or null when the serving source does not report it.
- totalResultsinteger
Total number of matching products Walmart reports for the query, or null when not reported.
- foundboolean
True when the search returned at least one product.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Preguntas frecuentes
Acerca del endpoint Buscar de la API de Walmart
El endpoint Buscar de AnyAPI para Walmart devuelve datos de Walmart como JSON normalizado con una sola llamada POST a /v1/run/walmart.search. Search Walmart by keyword with optional sort, price-range, facet, and page filters and get title, price, rating, seller, and availability for each product in one normalized response. AnyAPI enruta cada solicitud entre 2 fuentes y recurre automáticamente a otra cuando una falla. Cuesta desde US$0.90 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. En los últimos 30 días, el 99.7% de las llamadas al endpoint Buscar de la API de Walmart a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 3.4 segundos en 2063 llamadas medidas.