ScrapeUnblocker Documentation

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.

Try it in the dashboard first: app.scrapeunblocker.com/dashboard/plugins. You get a live results view plus a copy-paste snippet.

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).

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

{
  "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.

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).

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.

Get Started

No-code area

Spider Cloud

Plugins

AI Assistants

Guides

Code Examples

Walmart Search plugin

Endpoint

Response

Product fields

What you can build

Next steps

Open the plugins

Get an API key

​Endpoint

​Response

​Product fields

​What you can build

​Next steps

Open the plugins

Get an API key

Endpoint

Response

Product fields

What you can build

Next steps