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

# Walmart

> Get Walmart products with every seller's offer, search and browse results, category pages and reviews as structured data, on walmart.com, walmart.ca and walmart.com.mx, for 1 credit per link.

Send a Walmart link to [Scrape](https://docs.spidra.io/scrape.md) or [Batch scrape](https://docs.spidra.io/batch-scrape.md) and you get the page's data as JSON: a product's price, sellers, stock and reviews, search or browse results, a category page, or a page of reviews. walmart.com, walmart.ca and walmart.com.mx all work. Each link costs 1 credit, and links that can't be read cost nothing.

## Example

```json theme={null}
{ "urls": ["https://www.walmart.com/search?q=espresso+machine"], "output": "json", "wait": true }
```

The item's `result`, shortened to one item:

```json theme={null}
{
  "type": "search",
  "query": "espresso machine",
  "totalResults": 1679,
  "page": 1,
  "maxPage": 13,
  "itemCount": 52,
  "items": [
    {
      "usItemId": "2258193826",
      "title": "Nespresso Vertuo Pop Coffee and Espresso Maker by De'Longhi, Liquorice Black",
      "brand": "Nespresso",
      "price": 84.97,
      "wasPrice": 119,
      "rating": 4.4,
      "reviewCount": 4438,
      "seller": { "name": "Walmart.com", "isWalmart": true },
      "availability": "In stock"
    }
  ],
  "location": { "postalCode": "02746", "city": "New Bedford", "state": "MA", "storeId": "1906" }
}
```

`location` is the store Walmart priced the page for.

## Links that work

| Link | Example | You get |
| - | - | - |
| Product | `walmart.com/ip/<slug>/<id>`, `/ip/<id>`, `/product/<id>/sellers` | The product with every seller's offer, reviews, specs and variants |
| Search | `walmart.com/search?q=...` (page, sort, filters kept) | Totals and every item, with related searches |
| Browse | `walmart.com/browse/<path>/<id>` | The same as search, with breadcrumbs |
| Category | `walmart.com/cp/<slug>/<id>` | The item grid and every product carousel on the page |
| Reviews | `walmart.com/reviews/product/<id>?page=N&sort=...` | Rating summary, topics and the reviews on the page (about 10) |

## Fields

**Search item:** `position`, `usItemId`, `productId`, `title`, `url`, `image`, `brand`, `price`, `wasPrice`, `unitPrice`, `savings`, `shippingPrice`, `currency`, `rating`, `reviewCount`, `sponsored`, `badges`, `fulfillmentBadges`, `isRollback`, `isBestSeller`, `availability`, `outOfStock`, `seller` and `variantCount`.

**Product:** ids (`usItemId`, `productId`, `offerId`, `upc`, `gtin`, `model`), `title`, `brand`, `price`, `wasPrice`, `listPrice`, `savings`, `unitPrice`, `isRollback`, `isClearance`, `availability`, `inStock`, `fulfillment` (shipping, pickup and delivery with dates and prices), `seller`, `offers` (every other seller), `rating`, `reviewCount`, `ratingBreakdown`, `reviewTopics`, `topReviews`, `highlights`, `description`, `specifications`, `warnings`, `variants` (each option's item id, price and stock), `images`, `videos`, `breadcrumbs`, `badges`, `returnPolicy` and `location`.

## Pricing for a location

Walmart prices and stocks by store. Add `deliveryZip` to the URL object on [Scrape](https://docs.spidra.io/scrape.md) to read the page near a US ZIP or Canadian postal code:

```json theme={null}
{ "urls": [{ "url": "https://www.walmart.com/ip/2258193826", "deliveryZip": "90210" }], "output": "json" }
```

The page is read from that state or province (and the metro's main city for big metros). `location` says which store Walmart used and how close it is to what you asked for; for 90210 it was a Los Angeles store, with `"requestedPostcode": "90210"` and `"matchesRequest": "state"`. An exact ZIP isn't possible for signed-out visitors. `deliveryZip` isn't available on batch scrapes yet.

## Templates

Ready-made [templates](https://docs.spidra.io/templates.md) for Walmart: products for a search or category, product details and product reviews.

> [!NOTE]
>
> Check Walmart's terms before you collect data from it. You're responsible for how you use what you collect.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.