---
title: "Walmart"
description: "Walmart US through the shared marketplace schema. Prices are in USD."
---

## Operations

| Operation | Endpoint | Returns | Price |
|---|---|---|---|
| [Search](/docs/api-reference/walmart/search) | `GET \| POST /v1/walmart/search` | `SearchResult` | $0.001 |
| [Browse](/docs/api-reference/walmart/browse) | `GET \| POST /v1/walmart/browse` | `SearchResult` | $0.001 |
| [Categories](/docs/api-reference/walmart/categories) | `GET \| POST /v1/walmart/categories` | `CategoryList` | $0.001 |
| [Product](/docs/api-reference/walmart/product) | `GET \| POST /v1/walmart/product` | `Product` | $0.001 |
| [Reviews](/docs/api-reference/walmart/reviews) | `GET \| POST /v1/walmart/reviews` | `ReviewPage` | $0.001 |

No `image-search`: Walmart offers no visual search.

All five operations cost one call each, including `reviews`.

## What Actually Arrives

**search items**

| Field | Fill |
|---|---|
| `title` `url` | 100% |
| `price` `imageUrl` `seller.name` | ~85% |
| `delivery` | ~80% |
| `badges` | ~35% |

**product**

| Field | Fill |
|---|---|
| `title` | 100% |
| `price` `media.images` `attributes` | ~90% |
| `brand` `rating.average` `seller.name` `description` `category` | ~85% |
| `brandUrl` `returnsPolicy` | ~80% |
| `reviews` | ~70% |
| `reviewAspects` | ~50% |

**reviews**

| Field | Fill |
|---|---|
| `rating` | 100% |
| `id` `date` `author` `helpfulCount` | ~85% |

`price` is not 100% on search because Walmart's marketplace-seller listings sometimes show a range
rather than a price. `badges` is low because most items simply have none.

Walmart is one of only two marketplaces here that returns `reviewAspects` (Amazon is the other), and it
carries `returnsPolicy` and `brandUrl` more reliably than any of the others.

## The Filter Rail

Every Walmart search returns `facets` — the site's own filter groups for that query — and facets are
free. One socks search carries 25 groups: Price, Brand and
Customer Rating map onto typed parameters, and the rest (Sock Rise, Sleeve Length, Fabric Material,
Colour…) are reachable only through `facets`. See
[Filters](/docs/api-reference/marketplaces/filters#facets--the-marketplaces-own-filter-rail).

## Things Specific to Walmart

**Variants are not separately fetchable.** Sizes and colours are SKUs inside one product, so
`variant.productId` is absent.

**Both Walmart and marketplace sellers appear.** `seller.name` distinguishes them; a Walmart-fulfilled
item and a third-party one carry different delivery promises.

**Grocery items carry `unitPrice`.** Walmart and Amazon are the two that state price per unit of
measure, which is the only way to compare a 12-pack against a 24-pack.