# Walmart Scraper API - Store-Accurate Product Data

> Source: https://scrape.do/products/ready-api/walmart-scraper/

Scrape Walmart search results, product details, and any Walmart page pinned to a specific store or ZIP code. Structured JSON with store-accurate pricing, stock, and fulfillment.

> Each successful request costs **10 credits**.

**Store-Accurate Walmart Data Pinned to the Shelf You Choose**

Extract Walmart search results, product details, and full pages scoped to one store. Structured JSON with the prices, stock, and pickup options that store actually offers.

![Store-Accurate Walmart Data Pinned to the Shelf You Choose](/uploads/walmart-scraper-api.svg)

## Highlights

### Every Request Pinned to One Store

- Walmart prices, stock, and pickup availability differ store to store. Scraping without pinning a store gives you **whichever store Walmart guessed**, which makes runs impossible to compare.
- Target by `store` id when you track fixed locations, or by `zipcode` to model what a shopper in that area sees. Every response reports the store it reflects.

### Parsed JSON, Not Walmart's Internal Payload

- A raw Walmart product page is over **500 KB of HTML** with the state JSON buried inside. The same data comes back as **6 KB of clean JSON**.
- Item ids, prices, availability, fulfillment methods, and the full specification table arrive as named fields. No HTML parsing, no anti-bot handling on your side.

## How It Works

### Search Results

Run a keyword search against one Walmart store and get structured listings with that store's prices, stock, and fulfillment options. Sponsored placements are included and flagged.

![Search Results](/uploads/walmart-search-results.png)

**cURL (API mode)**

```bash
curl --location --request GET 'https://api.scrape.do/plugin/walmart/search?token=<SDO-token>&q=milk&store=1735'
```

**Python (API mode)**

```python
import requests
from urllib.parse import urlencode

token = "<SDO-token>"

params = {
    "q": "milk",
    "store": "1735",
}

url = f"https://api.scrape.do/plugin/walmart/search?token={token}&{urlencode(params)}"

response = requests.get(url)
print(response.json())
```

**Node.js (API mode)**

```javascript
const token = "<SDO-token>";

const params = new URLSearchParams({
  token,
  q: "milk",
  store: "1735"
});

const url = `https://api.scrape.do/plugin/walmart/search?${params}`;

const response = await fetch(url);
const data = await response.json();

console.log(data);
```

*(Go, Ruby, Java, C#, PHP examples are also available on the HTML version.)*

**Example response**

```json
{
  "store": {
    "store_id": "1735",
    "city": "Hoffman Estates",
    "state": "IL",
    "postal_code": "60192"
  },
  "query": "milk",
  "total_results": 425,
  "page": 1,
  "total_pages": 20,
  "results": [
    {
      "position": 4,
      "item_id": "10450114",
      "name": "Great Value Whole Vitamin D Milk, Gallon",
      "url": "https://www.walmart.com/ip/Great-Value-Whole-Vitamin-D-Milk-Gallon/10450114",
      "image": "https://i5.walmartimages.com/seo/Great-Value-Whole-Vitamin-D-Milk.jpeg",
      "price": 2.92,
      "currency": "USD",
      "rating": 4.6,
      "reviews_count": 365792,
      "seller": "Walmart.com",
      "availability": "IN_STOCK",
      "fulfillment": ["delivery", "pickup"],
      "sponsored": false,
      "category": "Home Page/Food/Dairy & Eggs/Milk/Whole Milk"
    }
  ]
}
```

### Product Details

Get one item's price, stock, and full specification table as sold at a specific store, including the description and highlights only the product page carries.

![Product Details](/uploads/walmart-product-details.png)

**cURL (API mode)**

```bash
curl --location --request GET 'https://api.scrape.do/plugin/walmart/product?token=<SDO-token>&item=18611919209&store=1735'
```

**Python (API mode)**

```python
import requests
from urllib.parse import urlencode

token = "<SDO-token>"

params = {
    "item": "18611919209",
    "store": "1735",
}

url = f"https://api.scrape.do/plugin/walmart/product?token={token}&{urlencode(params)}"

response = requests.get(url)
print(response.json())
```

**Node.js (API mode)**

```javascript
const token = "<SDO-token>";

const params = new URLSearchParams({
  token,
  item: "18611919209",
  store: "1735"
});

const url = `https://api.scrape.do/plugin/walmart/product?${params}`;

const response = await fetch(url);
const data = await response.json();

console.log(data);
```

*(Go, Ruby, Java, C#, PHP examples are also available on the HTML version.)*

**Example response**

```json
{
  "store": {
    "store_id": "1735",
    "city": "Hoffman Estates",
    "state": "IL",
    "postal_code": "60192"
  },
  "product": {
    "item_id": "18611919209",
    "name": "HP 14 inch HD Windows Laptop Intel Processor N150 4GB 128GB UFS Tranquil Pink",
    "brand": "HP",
    "url": "https://www.walmart.com/ip/HP-14-N150-4-128-Pink/18611919209",
    "images": [
      "https://i5.walmartimages.com/seo/HP-14-N150-4-128-Pink.jpeg"
    ],
    "price": 259,
    "currency": "USD",
    "availability": "IN_STOCK",
    "order_limit": 2,
    "seller": "Walmart.com",
    "seller_type": "INTERNAL",
    "fulfillment": ["delivery"],
    "rating": 4.1,
    "reviews_count": 684,
    "category": "Home Page/Electronics/Computers, Laptops and Tablets/Laptops",
    "condition": "New",
    "upc": "199764359179",
    "gtin": "00199764359179",
    "model_number": "CQ5J5UA#ABA",
    "return_policy": "Free 30-day returns",
    "short_description": "The HP 14 inch Laptop PC has it all to get it done...",
    "highlights": [
      { "name": "Proc. speed", "value": "3.7 GHz" },
      { "name": "Battery life", "value": "11.25 h" }
    ],
    "specifications": [
      { "name": "RAM memory", "value": "4 GB" },
      { "name": "Screen size", "value": "14 in" },
      { "name": "OS", "value": "Windows 11" }
    ]
  }
}
```

### Store-Scoped Page Fetch

Fetch any Walmart URL through a session already warmed for a specific store and get the upstream response verbatim. Use it for category pages, Walmart API endpoints, or full product HTML.

![Store-Scoped Page Fetch](/uploads/walmart-store-page.png)

**cURL (API mode)**

```bash
curl --location --request GET 'https://api.scrape.do/plugin/walmart/store?token=<SDO-token>&url=https%3A%2F%2Fwww.walmart.com%2Fip%2F18611919209&zipcode=10001&storeid=5376'
```

**Python (API mode)**

```python
import requests
from urllib.parse import urlencode

token = "<SDO-token>"

params = {
    "url": "https://www.walmart.com/ip/18611919209",
    "zipcode": "10001",
    "storeid": "5376",
}

url = f"https://api.scrape.do/plugin/walmart/store?token={token}&{urlencode(params)}"

response = requests.get(url)
print(response.json())
```

**Node.js (API mode)**

```javascript
const token = "<SDO-token>";

const params = new URLSearchParams({
  token,
  url: "https://www.walmart.com/ip/18611919209",
  zipcode: "10001",
  storeid: "5376"
});

const url = `https://api.scrape.do/plugin/walmart/store?${params}`;

const response = await fetch(url);
const data = await response.json();

console.log(data);
```

*(Go, Ruby, Java, C#, PHP examples are also available on the HTML version.)*

**Example response**

```html
<!DOCTYPE html>
<html lang="en">
<head>
  <title>HP 14 inch HD Windows Laptop - Walmart.com</title>
</head>
<body>
  <span itemprop="price">259.00</span>
  <span class="availability">In stock at Store 5376</span>
  <script id="__NEXT_DATA__" type="application/json">
    { "props": { "pageProps": { "initialData": {
      "storeId": "5376", "price": 259.00
    } } } }
  </script>
  <!-- ... full Walmart page HTML ... -->
</body>
</html>
```

## FAQ

### What is a Walmart scraper API?

A Walmart scraper API is an endpoint that returns Walmart data as structured JSON without you having to render the page, solve anti-bot challenges, or parse Walmart's internal state payload. Our API covers three endpoints: search results for a keyword, full product details for an item id, and a raw page fetch for any Walmart URL.

### Why does pinning a store matter?

Walmart shows different prices, stock levels, and pickup availability depending on which store serves the shopper. If you scrape without pinning a store, you get whichever store Walmart guessed for that request, so the same item can return different numbers run to run. Every request to this API is scoped to one store, so results stay comparable over time.

### How do I target a specific store?

The `/search` and `/product` endpoints take exactly one of two parameters. Pass `store` with a Walmart store id when you are tracking a fixed set of locations, or `zipcode` with a 5-digit US ZIP when you care about an area and any nearby store will do. Passing both, or neither, returns a `400`.

### What data can I extract from Walmart?

Search results return item ids, names, prices, list prices, ratings, review counts, seller, stock status, fulfillment methods, sponsored flags, and category paths. Product details add the full specification table, highlights, images, UPC and GTIN barcodes, model number, return policy, order limits, and both short and long descriptions.

### How much does the Walmart Scraper API cost?

Each successful request costs **10 credits**. Failed requests are never charged, so a `4xx` or `5xx` response costs you nothing. The premium proxy pool is always used for these endpoints, so you do not need to pass `super`.

### Is Walmart outside the US supported?

Not currently. Walmart's store-level pricing model applies to US stores and ZIP codes, and these endpoints are US only. For international Walmart domains, use the [Web Scraping API](/products/web-scraping-api/) against the URL directly.

### Can I run Walmart jobs in bulk?

Yes. The `walmart/store` plugin is available through the [Async API](/documentation/async-api/plugins/), so you can submit a batch of jobs and have them processed in parallel server-side rather than managing concurrency yourself.

### How does this compare to other Walmart scraper APIs?

We benchmarked five providers with dedicated Walmart parsers on success rate, response time, and field coverage. See the full comparison in our [best Walmart scraper API](/blog/best-walmart-scraper-api/) roundup.

### Is there a step-by-step guide?

Yes. Our [Walmart scraping](/blog/walmart-scraping/) guide walks through store selection, product pages, variants, category pagination, and price tracking with full Python code.

### I need more information..

We got you! Visit the [Scrape.do Walmart Scraper Docs](/documentation/walmart-scraper-api/) for the full parameter list, response fields, and error reference.