walmart.com.mx APIwalmart.com.mx ↗
Access Walmart Mexico product data via API. Search products, get pricing and availability, browse categories, and fetch similar items from walmart.com.mx.
curl -X GET 'https://api.parse.bot/scraper/ea0bc2df-b753-4a65-9458-80d8167fb00d/search_products?page=1&limit=44&query=televisor' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on walmart.com.mx. Returns paginated search results including product names, prices, images, ratings, and availability. Results are extracted from server-side rendered pages.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| sort | string | Sort order: best_match, price_low, price_high |
| facet | string | Facet filter string for additional filtering |
| queryrequired | string | Search keyword |
| cat_id | string | Category ID filter to narrow search to a specific department |
| max_price | string | Maximum price filter value |
| min_price | string | Minimum price filter value |
{
"type": "object",
"fields": {
"query": "search query string",
"searchResult": "object containing title, aggregatedCount, itemStacks (array of product groups with items), paginationV2, and categoryNavigation"
},
"sample": {
"data": {
"query": "leche",
"searchResult": {
"title": "Resultados para \"leche\"",
"itemStacks": [
{
"count": 166,
"items": [
{
"id": "00750105590414",
"name": "Leche Alpura deslactosada light 1 l",
"brand": "Alpura",
"image": "https://i5.walmartimages.com/asr/878d6552-55eb-4992-9628-3fbd4111e5a4.36b77e05b114fce7296bfa62b8ff92d6.jpeg",
"price": 37,
"rating": {
"averageRating": 4.8,
"numberOfReviews": 5
},
"usItemId": "00750105590414",
"canonicalUrl": "/ip/leche-alpura-deslactosada-light-1-l/00750105590414",
"availabilityStatusV2": {
"value": "IN_STOCK",
"display": "Disponible"
}
}
],
"title": "Resultados para \"leche\""
}
],
"paginationV2": {
"maxPage": 4
},
"aggregatedCount": 166
}
},
"status": "success"
}
}About the walmart.com.mx API
The Walmart Mexico API exposes 4 endpoints that cover product search, full product details, category listings, and similar-product recommendations from walmart.com.mx. The get_product_details endpoint returns over 8 distinct fields per product — including current price, savings data, fulfillment options, and stock status — identified by Walmart Mexico product ID.
Search and Browse
The search_products endpoint accepts a required query string and several optional filters: min_price, max_price, cat_id, facet, and sort (accepting best_match, price_low, or price_high). Results are paginated via a page parameter. The response wraps results inside a searchResult object containing aggregatedCount, itemStacks (groups of product listings), paginationV2 for navigating pages, and categoryNavigation for drill-down filtering.
Product Details
get_product_details takes a single product_id (e.g. 00750105590414) and returns a structured object with fields including name, brand, shortDescription, availabilityStatus (such as IN_STOCK), priceInfo (with currentPrice, wasPrice, and savings details), imageInfo (with allImages and thumbnailUrl), category (including categoryPathId and a path array for breadcrumbs), and fulfillmentSummary with estimated delivery dates.
Categories and Similar Products
list_categories requires no inputs and returns an array of top-level department objects, each carrying a name object (title and URL slug), an image, and a subcategories array — useful for building navigation trees or scoping searches by department. get_similar_products accepts a product_id and returns a carousels array of related and recommended products, which can feed recommendation features or cross-sell analysis.
Coverage Notes
All endpoints reflect the walmart.com.mx catalog, which carries pricing in Mexican pesos and covers the product assortment available in Mexico. Product IDs are Mexico-specific and differ from Walmart US identifiers. Pagination in search uses integer page numbers; there is no cursor-based pagination.
- Track price changes on specific products using
priceInfo.wasPriceandpriceInfo.currentPricefields over time - Build a product comparison tool using
get_product_detailsacross multiple product IDs - Index the full department tree from
list_categoriesto map Walmart Mexico's category structure - Filter search results by price range using
min_priceandmax_priceto analyze product distribution within a budget segment - Power a recommendation widget using the
carouselsarray fromget_similar_products - Audit stock availability across SKUs by checking
availabilityStatusfromget_product_details - Aggregate brand presence in a category by combining
cat_idfiltering insearch_productswith thebrandfield from product details
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Walmart Mexico have an official developer API?+
What does the `fulfillmentSummary` field in `get_product_details` actually contain?+
fulfillmentSummary is an array of fulfillment option objects, each including available delivery methods and estimated delivery dates for the product. It reflects the options shown on the product page, which can vary by item and region within Mexico.Does the search endpoint return customer reviews or review counts?+
search_products response includes ratings data within the itemStacks items, but the get_product_details endpoint does not return a dedicated reviews array or individual review text. The API currently covers product metadata, pricing, and fulfillment. You can fork it on Parse and revise to add a review-fetching endpoint if that data is accessible on the product page.Is there a way to retrieve all products within a category without a search query?+
query string in search_products; there is no browse-by-category-only endpoint that returns all items in a department without a keyword. The cat_id parameter narrows search results to a department but still requires a query. You can fork the API on Parse and revise it to add a category-browse endpoint that accepts only a cat_id.Are product IDs from Walmart US interchangeable with Walmart Mexico product IDs?+
get_product_details and get_similar_products) are specific to the walmart.com.mx catalog and do not correspond to Walmart US item IDs or UPCs, even for identical products. Always source IDs from search_products results for use with the other endpoints.