Store-Scoped Page Fetch
Fetch any Walmart URL through a session warmed for a specific store
The Store endpoint fetches any Walmart URL through a session already warmed for a specific store, and returns the upstream response verbatim. Use it when you need a page the structured endpoints do not cover — a category listing, a Walmart API endpoint, or the full product HTML.
If you only need search results or product details, /search and /product are lighter and return parsed JSON instead.
Endpoint
GET https://api.scrape.do/plugin/walmart/storeInput Parameters
Required
| Parameter | Type | Required | Description |
|---|---|---|---|
token | string | * | Your Scrape.do API authentication token |
url | string | * | Full Walmart URL. Must be on walmart.com. Product (/ip/…), category (/browse/…), search, and Walmart API endpoints are all accepted |
Store Selection
Pass both zipcode and storeid, or omit both to let the API pick a random major-market store. Passing only one returns a 400.
| Parameter | Type | Description |
|---|---|---|
zipcode | string | 5-digit US ZIP for the store, e.g. 10001 (NYC), 90210 (LA), 60601 (Chicago) |
storeid | integer | Walmart store id matching that ZIP, e.g. 5376 for ZIP 10001 |
This differs from /search and /product, which take either store or zipcode. Here the two are a pair and must match a real Walmart store, otherwise the request returns a 502.
Optional
| Parameter | Type | Default | Description |
|---|---|---|---|
timeout | integer | system max | Per-request timeout in milliseconds |
disableretry | boolean | false | Return the first response, success or failure, without the internal retry loop |
transparentresponse | boolean | false | If the request runs out of time but a partial body is already available, return that body instead of a 502 |
Response
The upstream Walmart response is returned verbatim, with its original content type:
| URL type | Response |
|---|---|
Product pages (/ip/…) | Full Walmart HTML, with the page state JSON embedded inline. The requested store id is guaranteed to be present in it |
Category pages (/browse/…) | Full HTML |
| Walmart API endpoints | JSON, with content-type: application/json |
For product and category URLs, realistic marketing query parameters (such as utm_source or gclid) are sometimes appended so the request looks like an organic landing. Your url is never otherwise rewritten.
Example Usage
A Product Page at a Specific Store
curl "https://api.scrape.do/plugin/walmart/store\
?url=https://www.walmart.com/ip/SS-BTN-FT-PANEL-MIDI/15586351437\
&zipcode=10001&storeid=5376&token=YOUR_TOKEN"A Category Page, Any Store
curl "https://api.scrape.do/plugin/walmart/store\
?url=https://www.walmart.com/browse/electronics&token=YOUR_TOKEN"Error Responses
| Status | Body | Cause |
|---|---|---|
| 400 | {"error":"token is required"} | Missing token |
| 400 | {"error":"invalid url provided"} | url parameter missing |
| 400 | {"error":"valid walmart url expected"} | URL is not on walmart.com |
| 400 | {"error":"invalid parameters","message":"Either provide both zipcode and storeid, or omit both for random selection"} | Only one of the two was provided |
| 400 | {"error":"invalid storeid provided"} | storeid is not an integer |
| 400 | {"error":"timeout is invalid"} | timeout is not an integer |
| 502 | {"error":"invalid combination of zipcode and storeid","message":"…"} | Walmart does not recognize this ZIP and store pair |
| 502 | {"error":"Walmart-store plugin failure.","message":"…"} | All retries exhausted. Not charged |
Notes
- US only. Walmart's store-level pricing model applies to US stores and ZIP codes.
- The response is guaranteed to be scoped to the ZIP and store you asked for.
- Each successful request costs 10 credits. Failed requests are never charged.
- If a ZIP and store pair repeatedly fails, contact support.
