Walmart APIwalmart.com ↗
Search Walmart products, retrieve pricing and specs, read customer reviews, browse categories, and look up store locations via a single REST API.
What is the Walmart API?
This API gives programmatic access to Walmart.com across 6 endpoints, covering product search, full item details, customer reviews, category browsing, grocery search, and store directory data. The search_products endpoint returns paginated product summaries including price, rating, review count, and sponsored status, while get_product_details exposes brand, seller identity, variant criteria, and the full image array for any individual item.
curl -X GET 'https://api.parse.bot/scraper/17a61761-c01e-4c8c-8a28-89538156d89e/search_products?page=1&sort=best_match&query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Full-text search over Walmart product catalog. Returns paginated product summaries with price, rating, and availability badges. Supports sorting and facet filtering. Each ProductSummary can be drilled into via get_product_details for full specifications.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| sort | string | Sort order for results |
| queryrequired | string | Search keyword (e.g. 'laptop', 'wireless headphones') |
| filters | string | Facet filter string to narrow results (e.g. 'brand:Samsung') |
{
"type": "object",
"fields": {
"items": "array of product summary objects with id, us_item_id, name, price, rating, review_count, image, url, badge, is_sponsored",
"facets": "array of available filter facets",
"total_pages": "integer total number of pages",
"current_page": "integer current page number or null",
"total_results": "integer total number of matching products"
},
"sample": {
"data": {
"items": [
{
"id": "24H72HS7PA9J",
"url": "https://www.walmart.com/ip/example/19075520026",
"name": "Lenovo IdeaPad Slim 3x 15.3\" Laptop",
"badge": "",
"image": "https://i5.walmartimages.com/seo/example.jpeg",
"price": 449,
"rating": 4.5,
"us_item_id": "19075520026",
"is_sponsored": true,
"review_count": 119
}
],
"facets": [],
"total_pages": 14,
"current_page": null,
"total_results": 67
},
"status": "success"
}
}About the Walmart API
Product Search and Detail
search_products accepts a required query string plus optional sort, page, and filters parameters (e.g. brand:Samsung). Each result in the items array includes us_item_id, price, rating, review_count, badge, and is_sponsored. The facets array and total_results field let you build filter UIs or measure category depth. To go deeper on any item, pass its us_item_id or a full product URL to get_product_details, which returns brand, seller (name and id), currency, images, variants, and the current price.
Reviews and Category Data
get_product_reviews takes a product_id (the us_item_id from search or detail) and an optional page number. Each entry in the reviews array carries rating, reviewText, userNickname, and reviewSubmissionTime. The pagination object includes currentSpan, next, previous, and pages fields alongside total_reviews and average_rating at the top level. get_category_listings mirrors the shape of search_products but scopes results to a Walmart category ID (e.g. 1115193 for electronics); an optional slug aligns the request to a specific browse URL path.
Grocery Search and Store Locations
search_grocery_products scopes results by a required 5-digit zip_code, returning store-specific pricing and availability. Each product object includes brand (nullable), package_size parsed from the product name, price, price_per_unit, protein_per_serving, and serving. get_store_locations takes a 2-letter US state abbreviation and returns every Walmart location in that state with store_id, store_type, address, phone, hours, open_24_hours, and a services array. Response time for this endpoint scales with the number of cities in the state.
The Walmart API is a managed, monitored endpoint for walmart.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when walmart.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official walmart.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track Walmart price changes on specific items using
get_product_detailsand thepricefield - Compare sponsored vs. organic product placement in search results via the
is_sponsoredflag insearch_products - Aggregate customer sentiment by pulling
reviewTextandratingfields fromget_product_reviewsacross multiple products - Build a store locator showing hours, services, and phone numbers using
get_store_locationsfiltered by state - Monitor in-store grocery pricing by ZIP code for a specific keyword using
search_grocery_productsandprice_per_unit - Enumerate all products in an electronics or food department using
get_category_listingswith known category IDs - Identify seller diversity on Walmart marketplace by extracting the
sellerobject fromget_product_detailsacross a product set
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Walmart have an official developer API?+
What does `get_product_details` return beyond price and name?+
brand, seller (name and id), currency, an images array of full-resolution URLs, a variants array of variant criteria objects, and the us_item_id. The rating field is nullable — some items have no reviews yet.How does grocery search differ from the general product search?+
search_grocery_products requires a zip_code parameter to scope results to a specific store's inventory and pricing. It also returns grocery-specific fields like package_size, price_per_unit, protein_per_serving, and serving that are absent from the general search_products response.Are Walmart+ membership prices or subscription details available?+
price fields in product and grocery endpoints but does not expose Walmart+ member pricing, savings badges, or subscription plan data. You can fork the API on Parse and revise it to add an endpoint targeting those fields if they become accessible.