> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Walmart Search plugin

> Walmart product search as clean JSON - title, price, was-price, rating, review count, brand, seller, availability, image and a direct product link.

The **Walmart Search** plugin turns any Walmart search into structured JSON. Give it a keyword, and it returns the products Walmart shows - each with title, price and was-price, star rating and review count, brand, seller, availability, image and a clean product URL. Sort, filter by price and page through to `max_results`.

It runs on the same fetch chain that serves `getPageSource`. Walmart sits behind PerimeterX and blocks non-US exits, so the plugin renders the search on a clean US exit and reads the products from Walmart's own `__NEXT_DATA__` island - no Walmart developer account needed.

<Note>
  Try it in the dashboard first: [app.scrapeunblocker.com/dashboard/plugins](https://app.scrapeunblocker.com/dashboard/plugins). You get a live results view plus a copy-paste snippet.
</Note>

## Endpoint

```
POST /marketplace/walmart-search
```

| Field                     | Required | Notes                                                                                     |
| ------------------------- | -------- | ----------------------------------------------------------------------------------------- |
| `query`                   | yes      | What to search, e.g. `laptop` or `coffee maker`.                                          |
| `sort`                    | no       | `best_match` (default), `price_low`, `price_high`, `best_seller`, `rating_high` or `new`. |
| `min_price` / `max_price` | no       | Price range in USD.                                                                       |
| `page`                    | no       | 1-based page to start from (\~40 products per page). Default `1`.                         |
| `max_results`             | no       | How many products to collect across pages. Default `40`, max `1000`.                      |
| `proxy_country`           | no       | Exit-IP country (ISO-2). Defaults to a US exit (required by Walmart).                     |

```bash theme={null}
curl -X POST "https://api.scrapeunblocker.com/marketplace/walmart-search?query=laptop&sort=price_low&max_results=60" \
  -H "x-scrapeunblocker-key: YOUR_API_KEY"
```

## Response

```json theme={null}
{
  "query": "laptop",
  "resultsCollected": 60,
  "products": [
    {
      "id": "5689919121",
      "name": "Lenovo IdeaPad Slim 3 15.6\" FHD Laptop, Intel Core i5, 8GB, 512GB SSD",
      "url": "https://www.walmart.com/ip/5689919121",
      "price": 329.0,
      "wasPrice": 449.0,
      "currency": "USD",
      "rating": 4.4,
      "reviewCount": 1287,
      "brand": "Lenovo",
      "seller": "Walmart.com",
      "availability": "In stock",
      "image": "https://i5.walmartimages.com/asr/....jpeg",
      "description": "15.6-inch FHD display, 8GB RAM, 512GB SSD..."
    }
  ]
}
```

### Product fields

| Field                    | Notes                                                                                                      |
| ------------------------ | ---------------------------------------------------------------------------------------------------------- |
| `price` / `wasPrice`     | Current price and the struck-through original, as numbers. `wasPrice` is `null` when there is no markdown. |
| `currency`               | ISO currency (USD).                                                                                        |
| `rating` / `reviewCount` | Star rating and number of reviews, when the tile shows them.                                               |
| `brand`                  | Product brand. `null` on search tiles that do not carry it.                                                |
| `seller`                 | `Walmart.com` or a marketplace seller name.                                                                |
| `availability`           | Stock state as Walmart words it.                                                                           |
| `url`                    | Clean `/ip/` product URL.                                                                                  |

<Note>
  Any field with no value is omitted from a product, so each item carries only the fields Walmart's search tile actually showed (e.g. `wasPrice` or `brand` may be absent).
</Note>

## What you can build

* **Price monitoring and repricing** - track price and `wasPrice` for a product over time.
* **Catalog and assortment research** - pull a whole category with brands and sellers.
* **Review-volume signals** - `rating` and `reviewCount` show what is actually selling.
* **Competitor tracking** - compare the same keyword against your own listings.

## Next steps

<CardGroup cols={2}>
  <Card title="Open the plugins" icon="play" href="https://app.scrapeunblocker.com/dashboard/plugins">
    Run a Walmart search and grab the JSON.
  </Card>

  <Card title="Get an API key" icon="key" href="https://scrapeunblocker.com/pricing">
    Free trial available on the pricing page.
  </Card>
</CardGroup>