---
title: "Scrape Walmart product search"
method: POST
path: "/marketplace/walmart-search"
tags: ["Plugins"]
---

# Scrape Walmart product search

`POST /marketplace/walmart-search`

## Request

- Base URL: `https://api.scrapeunblocker.com`
- URL: `https://api.scrapeunblocker.com/marketplace/walmart-search`
- Auth: API key in header `x-scrapeunblocker-key`

Searches Walmart for `query` and returns the products as JSON: `name`, `price` and `wasPrice`, `rating`, `reviewCount`, `brand`, `seller`, `availability`, `image` and a product `url`. Sort with `sort`, filter with `min_price`/`max_price`, and collect up to `max_results` across pages.

## Query parameters

- `query` string, required: What to search, e.g. 'laptop' or 'coffee maker'.
- `sort` string: Ordering: best_match, price_low, price_high, best_seller, rating_high, new.
- `min_price` integer, nullable: Lowest price to include (USD).
- `max_price` integer, nullable: Highest price to include (USD).
- `page` integer: 1-based page to start from (~40 per page).
- `max_results` integer: How many products to collect across pages.
- `proxy_country` string, nullable: Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE'). Defaults to US.

## Response `200`

JSON with a `products` array.

- unknown

## Other responses

- `400`: Invalid parameters.
- `422`: Validation Error
- `502`: Blocked by Walmart, no results page returned, or the search did not finish in time.

---

[API](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api.md) · [All operations](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/revisions/c02f1254cc47?raw)