# Store-Scoped Page Fetch

> Source: https://scrape.do/documentation/walmart-scraper-api/store/

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`](/documentation/walmart-scraper-api/search) and [`/product`](/documentation/walmart-scraper-api/product) are lighter and return parsed JSON instead.

---

## Endpoint

```
GET https://api.scrape.do/plugin/walmart/store
```

---

## Input 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` |

> [!NOTE]
> 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

```bash
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

```bash
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.