# Walmart API guide



## Start with Walmart



Search retail products, resolve a selected item and inspect available customer reviews. Treat product identity, seller identity, price and availability as separate data points.



These requests use your API key and can spend credits. Check the current price on the endpoint page; each new page is a separate request. Later examples use illustrative identifiers: replace them with values from your earlier response.



### 1. Find a product



Preserve the query and supported sort when requesting another page. Similar titles can be different products or variants. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/walmart/search)



**walmart/search**

```
curl "https://www.monocrawl.com/v1/walmart/search?query=coffee%20grinder&page=1" \
  -H "x-api-key: mn_your_key_here"
```



### 2. Inspect an item



Replace the example id with the selected Walmart item ID. Read current price and availability together; neither reserves inventory. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/walmart/product)



**walmart/product**

```
curl "https://www.monocrawl.com/v1/walmart/product?id=6138924168" \
  -H "x-api-key: mn_your_key_here"
```



### 3. Read product reviews



Use the same item id. These are product reviews, not seller reviews; a page is a sample of available discussion. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/walmart/reviews)



**walmart/reviews**

```
curl "https://www.monocrawl.com/v1/walmart/reviews?id=265952442&page=1" \
  -H "x-api-key: mn_your_key_here"
```



## Choose filters with the source behavior in mind



| Control | Behavior and limits |
| --- | --- |
| Paging and sorting | Use the documented page and sort controls. Do not send filters merely because another retail endpoint accepts them. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/walmart/search) |
| Review identity | Product and seller reviews use different IDs and operations. Do not combine their rating populations. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/walmart/reviews) |



Source availability, ordering and field coverage can change. Inspect warnings and partial-result metadata alongside the rows. See [runnable workflows](https://www.monocrawl.com/docs/workflows), [metric semantics](https://www.monocrawl.com/docs/metric-semantics), [computed fields](https://www.monocrawl.com/docs/computed-fields) and the [pagination matrix](https://www.monocrawl.com/docs/pagination).



## Match the operation to your task



| Your task | Endpoint | When to use it |
| --- | --- | --- |
| Compare seller offers | [`offers`](https://www.monocrawl.com/docs/endpoints/walmart/offers) | Use the product_id accepted by this operation. Compare seller, currency and available fulfillment information. |
| Inspect a seller | [`seller`](https://www.monocrawl.com/docs/endpoints/walmart/seller) | Use a seller identifier, not the product item ID. |
| Seller feedback | [`seller-reviews`](https://www.monocrawl.com/docs/endpoints/walmart/seller-reviews) | Keep seller reputation separate from the product’s rating. |



Explore all documented operations by purpose below. Each endpoint reference contains its accepted parameters and current price.



### Products and categories



- [`category`](https://www.monocrawl.com/docs/endpoints/walmart/category)

- [`product`](https://www.monocrawl.com/docs/endpoints/walmart/product)



### Reviews and offers



- [`offers`](https://www.monocrawl.com/docs/endpoints/walmart/offers)

- [`reviews`](https://www.monocrawl.com/docs/endpoints/walmart/reviews)

- [`seller`](https://www.monocrawl.com/docs/endpoints/walmart/seller)

- [`seller-reviews`](https://www.monocrawl.com/docs/endpoints/walmart/seller-reviews)



### Other operations



- [`rollbacks`](https://www.monocrawl.com/docs/endpoints/walmart/rollbacks)



### Search and discovery



- [`search`](https://www.monocrawl.com/docs/endpoints/walmart/search)



## Endpoint reference

## walmart/category

`GET /v1/walmart/category`

Products listed in a Walmart category with price, rating, review count, image, availability and seller, paged.

*Walmart category products*

| Parameter | Required | Description |
| --- | --- | --- |
| `category_id` | yes | A Walmart category id — e.g. `3944` |
| `page` | no | Page number — e.g. `1` |
| `sort_by` | no | best_match, price_low, price_high, best_seller or top_rated Accepted values: best_match, price_low, price_asc, price_high, price_desc, best_seller, top_rated. Case, spaces, hyphens and underscores are interchangeable. — e.g. `best_match` |
| `min_price` | no | Minimum price |
| `max_price` | no | Maximum price |
| `zip_code` | no | ZIP code for local availability |
| `store_id` | no | Store id |
| `country` | no | us or ca Accepted values: us, ca. Case, spaces, hyphens and underscores are interchangeable. — e.g. `us` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `country`: Select the documented market or country filter. Read this endpoint’s country semantics; filtering and source request location can differ.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 3 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/walmart/category?category_id=3944" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "category_id": "example",
  "count": 0,
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "availability": "example",
      "best_seller": false,
      "currency": "example",
      "description": "example",
      "free_shipping": false,
      "id": "example",
      "image": "https://example.com/example",
      "original_price": 0,
      "out_of_stock": false,
      "platform": "example",
      "price": 0,
      "rating": {
        "max": 0,
        "value": 0,
        "votes": 0
      },
      "reviews_count": 0,
      "savings": 0,
      "seller": "example",
      "seller_id": "example",
      "sponsored": false,
      "title": "example",
      "type": "example",
      "url": "https://example.com/example"
    }
  ],
  "page": 0,
  "total_pages": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/walmart/category#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/walmart/category.json)


## walmart/offers

`GET /v1/walmart/offers`

Every seller offering a Walmart item: seller, price, stock, condition, shipping and pickup, return policy.

*Walmart offers*

| Parameter | Required | Description |
| --- | --- | --- |
| `product_id` | yes | A Walmart item id or product URL — e.g. `609040889` |
| `country` | no | us or ca Accepted values: us, ca. Case, spaces, hyphens and underscores are interchangeable. — e.g. `us` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `country`: Select the documented market or country filter. Read this endpoint’s country semantics; filtering and source request location can differ.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/walmart/offers?product_id=609040889" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "has_more": false,
  "items": [
    {
      "availability": "example",
      "condition": "example",
      "currency": "example",
      "free_shipping": false,
      "fulfilled_by_walmart": false,
      "in_stock": false,
      "offer_id": "example",
      "offer_type": "example",
      "pickup_available": false,
      "position": 0,
      "price": 0,
      "price_display": "example",
      "return_policy": "example",
      "seller": "example",
      "seller_id": "example",
      "seller_type": "example",
      "storefront_url": "https://example.com/example"
    }
  ],
  "product_id": "example",
  "title": "example",
  "total_offers": 0,
  "url": "https://example.com/example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/walmart/offers#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/walmart/offers.json)


## walmart/product

`GET /v1/walmart/product`

One Walmart product: title, brand, price and savings, rating and review counts, seller, category path, description, highlights, specifications and images.

*Walmart product*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Walmart item id (the number after /ip/ in its URL), or the URL — e.g. `6138924168` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 3 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/walmart/product?id=6138924168" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "availability": "example",
  "brand": "example",
  "categories": [
    "example"
  ],
  "category": "example",
  "condition": "example",
  "currency": "example",
  "description": "example",
  "highlights": [
    "example"
  ],
  "id": "example",
  "image": "https://example.com/example",
  "images": [
    "example"
  ],
  "model": "example",
  "original_price": 0,
  "out_of_stock": false,
  "platform": "example",
  "price": 0,
  "rating": {
    "max": 0,
    "value": 0,
    "votes": 0
  },
  "rating_breakdown": {
    "five": 0,
    "four": 0,
    "one": 0,
    "three": 0,
    "two": 0
  },
  "recommended_percentage": 0,
  "return_window_days": 0,
  "reviews_count": 0,
  "savings": 0,
  "seller": "example",
  "seller_id": "example",
  "seller_type": "example",
  "specifications": [
    {
      "name": "example",
      "value": "example"
    }
  ],
  "title": "example",
  "type": "example",
  "upc": "example",
  "url": "https://example.com/example",
  "variants_count": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/walmart/product#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/walmart/product.json)


## walmart/reviews

`GET /v1/walmart/reviews`

Reviews of a Walmart product, ten per page, with the rating distribution.

*Walmart product reviews*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Walmart item id — e.g. `265952442` |
| `page` | no | Page number (10 per page) — e.g. `1` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 3 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/walmart/reviews?id=265952442" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "items": [
    {
      "id": null,
      "text": "Illustrative review.",
      "rating": 4,
      "verified_purchase": null
    }
  ],
  "cursor": null,
  "has_more": null
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/walmart/reviews#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/walmart/reviews.json)


## walmart/rollbacks

`GET /v1/walmart/rollbacks`

Products currently on rollback (marked-down) at Walmart, with the old and new prices.

*Walmart rollbacks*

| Parameter | Required | Description |
| --- | --- | --- |
| `page` | no | Page number (about 40 per page) — e.g. `1` |
| `cursor` | no | Return the previous response cursor unchanged to continue with its original source; omit page. An empty filtered Rollback page can still have a continuation. Each request retains the normal price. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/walmart/rollbacks" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "items": [],
  "count": 0,
  "cursor": null
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/walmart/rollbacks#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/walmart/rollbacks.json)


## walmart/search

`GET /v1/walmart/search`

Products matching a keyword, forty per page, with price, rating, seller and availability.

*Walmart product search*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search keyword — e.g. `mobile` |
| `page` | no | Page number (40 per page) — e.g. `1` |
| `sort` | no | best_match, price_low, price_high or best_seller Accepted values: best_match, price_low, price_asc, price_high, price_desc, best_seller, top_rated. Case, spaces, hyphens and underscores are interchangeable. — e.g. `best_match` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `sort`: Choose the documented source ordering before paging through results. Ordering keeps the normal endpoint price and does not guarantee exhaustive results.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 3 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/walmart/search?query=mobile" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "availability": "example",
      "best_seller": false,
      "currency": "example",
      "description": "example",
      "free_shipping": false,
      "id": "example",
      "image": "https://example.com/example",
      "out_of_stock": false,
      "platform": "example",
      "price": 0,
      "rating": {
        "max": 0,
        "value": 0,
        "votes": 0
      },
      "reviews_count": 0,
      "savings": 0,
      "seller": "example",
      "seller_id": "example",
      "sponsored": false,
      "title": "example",
      "type": "example",
      "url": "https://example.com/example"
    }
  ],
  "page": 0,
  "query": "example",
  "total_pages": 0,
  "total_results": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/walmart/search#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/walmart/search.json)


## walmart/seller

`GET /v1/walmart/seller`

One Walmart marketplace seller: contact details, address, rating summary and distribution.

*Walmart seller*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Catalog seller id from a product — e.g. `8026` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 10 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/walmart/seller?id=8026" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "about": "example",
  "email": "example",
  "id": "example",
  "kind": "example",
  "logo": "example",
  "name": "example",
  "phone": "example",
  "platform": "example",
  "rating": {
    "max": 0,
    "value": 0
  },
  "seller_id": "example",
  "type": "example",
  "url": "https://example.com/example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/walmart/seller#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/walmart/seller.json)


## walmart/seller-reviews

`GET /v1/walmart/seller-reviews`

Reviews of a Walmart marketplace seller, ten per page, each naming the product bought.

*Walmart seller reviews*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Catalog seller id from a product — e.g. `8026` |
| `page` | no | Page number (10 per page) — e.g. `1` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 10 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/walmart/seller-reviews?id=8026" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "author": "example",
      "features": [],
      "id": "example",
      "media": [],
      "platform": "example",
      "posted_at": "2026-09-01T12:00:00Z",
      "product": {
        "id": "example",
        "image": "https://example.com/example",
        "title": "example"
      },
      "product_id": "example",
      "rating": 0,
      "responses": [],
      "text": "example"
    }
  ],
  "page": 0,
  "seller": {
    "email": "example",
    "id": "example",
    "kind": "example",
    "name": "example",
    "platform": "example",
    "rating": {
      "max": 0,
      "value": 0,
      "votes": 0
    },
    "seller_id": "example",
    "type": "example",
    "url": "https://example.com/example"
  },
  "total": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/walmart/seller-reviews#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/walmart/seller-reviews.json)