Walmart API
- Data from Walmart
Walmart API for product search, prices and reviews
Search walmart.com and get each item as JSON: item ID, name, brand, price, rating, review count and whether it is sponsored. Then page through an item’s reviews with Walmart’s own rating summary.
1,000 free credits a month · Failed requests are free · Free during the beta
Endpoints and prices checked against the API on
Brands, retailers and pricing teams track what Walmart charges and how its customers rate products, often next to Amazon. Walmart’s developer APIs are built for its sellers, suppliers, advertisers and affiliates, not for reading the catalog at large. This API reads the public search and review pages and returns the data Walmart’s own store uses: about 40 items per search page and up to 50 pages, in Walmart’s sort orders, with sponsored items labelled rather than removed.
Every item has a numeric item ID, the same number that ends its walmart.com URL, and the reviews endpoint takes it. Reviews come 10 per page in Walmart’s own orders (most relevant, most helpful, newest, highest or lowest rating) with the Verified Purchase badge. Every page also carries the item’s rating summary: the average, the total, the count and percentage at each star level, and the share of reviewers who recommend it. Walmart’s M/D/YYYY dates are returned as ISO dates.
What you get
item_id— Walmart’s numeric item ID, the number at the end of the product URL, which the reviews call takesname, brand, url— product name, brand and walmart.com linkprice, currency— the current price and its currencyrating, ratings_count— average rating and number of reviews shown on the resultsponsored— true for paid placements, which keep their position in the resultsaggregated_count— the number of matching items Walmart reports for the searchsummary— average, total, per-star counts and percentages, and recommended_pctreviews[]— rating, title, text, ISO date, author and labels such as Verified Purchase
One call, structured JSON
POST /v1/walmart/search — 2 credits per successful call.
curl -X POST "https://api.scrapercompany.com/v1/walmart/search" \
-H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"q": "bathrobe"
}'{
"search_parameters": {
"engine": "walmart_search",
"q": "bathrobe"
},
"products": [
{
"item_id": "5255687930",
"name": "Black Womens Robe, Fleece Plush Soft Fluffy Bathrobe, S/M",
"brand": "Pavilia",
"price": 19.99,
"currency": "USD",
"rating": 4.4,
"ratings_count": 2484,
"url": "https://www.walmart.com/ip/PAVILIA-Black-Women-Robe-5255687930",
"image": "https://i5.walmartimages.com/seo/PAVILIA-Black-Women-Robe_482875EB",
"sponsored": false
},
{
"item_id": "17299362344",
"name": "Mainstays Fleece Bathrobe, Unisex, Adult",
"brand": "Mainstays",
"price": 16.98,
"currency": "USD",
"rating": 4.5,
"ratings_count": 1290,
"url": "https://www.walmart.com/ip/Mainstays-Fleece-Bathrobe-17299362344",
"sponsored": true
}
],
"aggregated_count": 387,
"total": 2,
"meta": {
"source": "walmart_search",
"wire_bytes": 181760,
"elapsed_s": 1.344
}
}Endpoints and price per call
Credits per successful call, and what one call costs on the Starter, Growth, Scale plans. Failed requests cost nothing. See all plans.
| Endpoint | What it returns | Credits | Starter · Growth · Scale |
|---|---|---|---|
| Product search POST /v1/walmart/search | One page of about 40 items for a keyword, in Walmart’s sort orders | 2 credits | $0.0020 · $0.0012 · $0.0008 |
| Reviews POST /v1/walmart/reviews | One page of 10 reviews for an item, with its rating summary | 2 credits | $0.0020 · $0.0012 · $0.0008 |
FAQ
Frequently asked questions
Read next
Does Walmart have a public API?
Not for reading the catalog at large. Walmart’s developer portal offers Marketplace APIs for sellers and solution providers, Supplier APIs for companies that sell to Walmart directly, and advertising and carrier APIs; Walmart I/O offers an Affiliates API for publishers who promote Walmart products. ScraperCompany is independent of Walmart: this API reads the public walmart.com search and review pages and needs no partner account.
How do I find a Walmart item ID?
Every search result carries item_id. It is also the number at the end of a walmart.com product URL (for walmart.com/ip/PAVILIA-Black-Women-Robe-5255687930 it is 5255687930). Pass it to the reviews endpoint.
How many reviews can I get for an item?
Walmart serves reviews 10 per page and page goes up to 100, so up to 1,000 reviews per sort order. Each page is one call. The rating summary with per-star counts comes with every page, so one call is enough for an item’s rating breakdown.
Are sponsored products included?
Yes, labelled. Sponsored items stay in the position Walmart shows them, with sponsored set to true, so you can measure paid placement or filter it out.
How do sorting and paging work in search?
Each page returns about 40 items and page goes up to 50. sort takes Walmart’s own orders: best match, price low to high or high to low, highest rating, best sellers and newest. An empty page is free.
Do failed requests cost credits?
No. A failed or blocked call (any 4xx or 5xx response) costs 0 credits, and so does a search page that comes back empty. You pay only for successful results.
How do I get an API key?
Create an account on the sign-up page. Public sign-up is invite-only during the beta, so join the waitlist there and we will email you when your account is ready. The Free plan includes 1,000 credits a month, and the API is free while it is in beta. You create and rotate keys yourself in the dashboard.
More APIs on the same key
All APIsAmazon API
Search amazon.com the way a shopper does and get each result as JSON: ASIN, title, price, rating, ratings count and whether it is sponsored. Then read a product’s star breakdown and the reviews Amazon features on its page.
Booking.com API
Look a hotel up by name, then read what Booking.com shows a guest: a nightly price calendar, each room type with its rate plans, and the reviews with the property’s replies. Structured JSON, priced per call.
Expedia API
Look a hotel up by name, then read what Expedia shows a guest for one stay: every room type and rate plan with its total, nightly price and cancellation terms, and the guest reviews with the property’s replies.
Hotels.com API
Find a hotel’s Hotels.com id by name, then read what a guest on the Hotels.com site for their country sees: the headline price for a stay, every room type and rate plan, and the guest reviews.
Start with 1,000 free credits a month
Join the waitlist and we will email you when your account is ready: your own API keys, 1,000 free credits a month, and the API is free during the beta.