---
type: "firecrawl-provider"
description: "Walmart US storefront: product search, category browsing, product detail with variants, prices and fulfillment options, customer reviews, search suggestions and store pages, read from the server-rendered __NEXT_DATA__ of www.walmart.com and its public typeahead JSON."
use_when: "Walmart US storefront: product search, category browsing, product detail with variants, prices and fulfillment options, customer reviews, search suggestions and store pages, read from the server-rendered __NEXT_DATA__ of www.walmart.com and its public typeahead JSON."
categories: "Retail"
capabilities: 6
credits_per_call: 5
---
# Walmart.com on Firecrawl Alexandria

Walmart US storefront: product search, category browsing, product detail with variants, prices and fulfillment options, customer reviews, search suggestions and store pages, read from the server-rendered __NEXT_DATA__ of www.walmart.com and its public typeahead JSON.

- Categories: Retail
- Category index: [Retail category](https://firecrawl.dev/alexandria/agents/categories/retail)
- Provider key: `walmart-com`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/walmart-com)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/walmart-com/openapi.json)

## Capabilities

- [Browse](https://firecrawl.dev/alexandria/agents/providers/walmart-com/products/browse): List products in a Walmart category by its `cat_id` (underscore-joined department path such as `4044_90548_90546_1115306_5438660`, as found in `/browse/` URLs, search breadcrumbs and `product.category_path`). Same result shape and location behaviour as `search`.
- [Product](https://firecrawl.dev/alexandria/agents/providers/walmart-com/products/product): Product detail for one Walmart item (`us_item_id`, the numeric id in `/ip/<slug>/<id>` URLs): name, brand, UPC, model, price in USD, availability, seller, images, category path, specifications, variant options with the sibling items' ids and prices, and shipping / pickup / delivery options for the store nearest the proxy exit (see `location`). Store selection by ZIP is not supported.
- [Reviews](https://firecrawl.dev/alexandria/agents/providers/walmart-com/products/reviews): Customer reviews for one Walmart item, 10 per page, with the rating summary (average, histogram, recommended percentage). Sort by relevancy, submission date, rating or helpfulness.
- [Search](https://firecrawl.dev/alexandria/agents/providers/walmart-com/products/search): Search Walmart.com products by keyword. Returns one page (up to 40 primary results plus secondary stacks such as '4 stars and above') with prices in USD, rating, seller, availability and the product URL. Prices, pickup and delivery availability are for the store nearest the proxy exit (reported in `location`).
- [Store](https://firecrawl.dev/alexandria/agents/providers/walmart-com/products/store): One Walmart store by numeric store id: name, address, phone, coordinates, weekly hours, in-store services with their hours (optional), fuel prices when the store has a fuel station, and the nearest Walmart stores with distances in miles.
- [Suggest](https://firecrawl.dev/alexandria/agents/providers/walmart-com/products/suggest): Search suggestions (typeahead) for a partial term, as Walmart's search box shows them.

## 1. Choose this provider when

Walmart US storefront: product search, category browsing, product detail with variants, prices and fulfillment options, customer reviews, search suggestions and store pages, read from the server-rendered __NEXT_DATA__ of www.walmart.com and its public typeahead JSON.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "walmart-com",
  "capability": "products/browse",
  "options": {
    "cat_id": "4044_90548_90546_1115306_5438660",
    "limit": 10,
    "page": 2
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `cat_id` (string, required): Category id, digits joined by underscores, e.g. `4044_90548_90546_1115306_5438660`. Pattern: ^[0-9]+(_[0-9]+)*$. Example: `4044_90548_90546_1115306_5438660`
- `facet` (string): Walmart facet filter, e.g. `brand:Keurig`. Example: `brand:Keurig`
- `limit` (number): limit Example: `40`
- `max_price` (number): max_price Example: `10`
- `min_price` (number): min_price Example: `10`
- `page` (number): page Example: `1`
- `sort` (string): sort Example: `best_match`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "walmart-com",
    capability: "products/browse",
    options: {
      cat_id: "4044_90548_90546_1115306_5438660",
      limit: 10,
      page: 2,
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "walmart-com",
  "capability": "products/browse",
  "options": {
    "cat_id": "4044_90548_90546_1115306_5438660",
    "limit": 10,
    "page": 2
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "walmart-com",
    "capability": "products/browse",
    "options": {
      "cat_id": "4044_90548_90546_1115306_5438660",
      "limit": 10,
      "page": 2
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'walmart-com/products/browse' \
  --options '{"cat_id":"4044_90548_90546_1115306_5438660","limit":10,"page":2}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "walmart-com",
  "capability": "products/browse",
  "options": {
    "cat_id": "4044_90548_90546_1115306_5438660",
    "limit": 10,
    "page": 2
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "walmart-com",
  "capability": "products/browse",
  "options": {
    "cat_id": "4044_90548_90546_1115306_5438660",
    "limit": 10,
    "page": 2
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "breadcrumbs": [
    {
      "id": "4044",
      "name": "Home",
      "url": "https://www.walmart.com/cp/4044"
    },
    {
      "id": "4044_90548",
      "name": "Appliances",
      "url": "https://www.walmart.com/browse/home/appliances/4044_90548"
    },
    {
      "id": "4044_90548_90546",
      "name": "Kitchen Appliances",
      "url": "https://www.walmart.com/browse/appliances/kitchen-appliances/4044_90548_90546"
    },
    {
      "id": "4044_90548_90546_1115306",
      "name": "Coffee Shop",
      "url": "https://www.walmart.com/browse/kitchen-appliances/coffee-shop/4044_90548_90546_1115306"
    },
    {
      "id": "4044_90548_90546_1115306_5438660",
      "name": "Coffee Makers",
      "url": "https://www.walmart.com/browse/coffee-shop/coffee-makers/4044_90548_90546_1115306_5438660"
    }
  ],
  "category": {
    "id": "4044_90548_90546_1115306_5438660",
    "name": "Coffee Makers"
  },
  "items": [
    {
      "availability": "IN_STOCK",
      "badge": null,
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Ninja-Mini-Luxe-Caf-Espresso-Machine-Black-ES301_63157930-16b0-49e5-99d4-9572cb470e4d.6beb3ff73160b95413d33d36e485de2e.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "Ninja Luxe Café Mini Espresso Machine & Drip Coffee Maker with Built-in Grinder, Precision Scale & Manual Steam Wand for Lattes, Cappuccinos & More, ES301 Black",
      "price": {
        "currency": "USD",
        "current": 449.99,
        "high": null,
        "low": null,
        "was": null
      },
      "product_id": "63DH1BR8BTQD",
      "rating": 4.8,
      "review_count": 105,
      "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
      "seller_name": "Walmart.com",
      "sponsored": true,
      "stack": "Results for \"coffee makers\"",
      "url": "https://www.walmart.com/ip/Ninja-Mini-Luxe-Caf-Espresso-Machine-Black-ES301/19258703085",
      "us_item_id": "19258703085",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": null,
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Nespresso-VertuoPOP-Dark-Gray-Coffee-and-Espresso-Maker-by-Breville_3db8ca4f-b084-450b-88ff-6260402e7dfc.bba6dd379d23b0409110255f7d68a169.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "Nespresso VertuoPOP Dark Gray Coffee and Espresso Maker by Breville",
      "price": {
        "currency": "USD",
        "current": 94.97,
        "high": null,
        "low": null,
        "was": 119
      },
      "product_id": "465TL9N3AE54",
      "rating": 4.4,
      "review_count": 4253,
      "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
      "seller_name": "Walmart.com",
      "sponsored": true,
      "stack": "Results for \"coffee makers\"",
      "url": "https://www.walmart.com/ip/Nespresso-VertuoPOP-Dark-Gray-Coffee-and-Espresso-Maker-by-Breville/2188239090",
      "us_item_id": "2188239090",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": "Best seller",
      "brand": null,
      "fulfillment_types": [
        "DELIVERY",
        "PICKUP"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Cuisinart-12-Cup-Coffeemaker-Stainless-Steel-Black_b8985ea2-62a7-4c87-9867-e2c538980d2e.c6fa724a88d12d44d3cbc2aeda10962f.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "Cuisinart Stainless Steel 12-Cup Coffee Maker, Black",
      "price": {
        "currency": "USD",
        "current": 59,
        "high": null,
        "low": null,
        "was": 69.95
      },
      "product_id": "4NN9ZW0AZYDK",
      "rating": 4.5,
      "review_count": 4984,
      "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
      "seller_name": "Walmart.com",
      "sponsored": true,
      "stack": "Results for \"coffee makers\"",
      "url": "https://www.walmart.com/ip/Cuisinart-12-Cup-Coffeemaker-Stainless-Steel-Black/808715278",
      "us_item_id": "808715278",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": null,
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Thyme-Table-Barista-Grade-Espresso-Machine-Atlantic-Blue_2b835f70-830d-4161-a041-835f0f0fae6d.f847c84444e3e8a2adae0ce0a15950d9.png?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "Thyme & Table 15-Bar Espresso Machine with Conical Burr Grinder, Atlantic Blue",
      "price": {
        "currency": "USD",
        "current": 368,
        "high": null,
        "low": null,
        "was": null
      },
      "product_id": "7242JT9O2AEG",
      "rating": 4.2,
      "review_count": 267,
      "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
      "seller_name": "Walmart.com",
      "sponsored": true,
      "stack": "Results for \"coffee makers\"",
      "url": "https://www.walmart.com/ip/Thyme-Table-Barista-Grade-Espresso-Machine-Atlantic-Blue/13645253397",
      "us_item_id": "13645253397",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": null,
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Friwest-Espresso-Machine-20-Bar-Super-Compact-Espresso-Maker-with-Touch-Screen-Professional-Coffee-Machine-Automatic-Milk-Frother-for-Cappuccino_cceb69d2-7b01-4f1b-ae6c-df4687fe3bf7.5d497f776e48e92ca5024b7281ad3391.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "Friwest Espresso Machine 20 Bar, Super Compact Espresso Maker with Touch Screen, Professional Coffee Machine, Automatic Milk Frother for Cappuccino",
      "price": {
        "currency": "USD",
        "current": 109.99,
        "high": 139.99,
        "low": 109.99,
        "was": 179.99
      },
      "product_id": "270VV52ON7T5",
      "rating": 4.4,
      "review_count": 11,
      "seller_id": "BC3959A020694E60A9E03907DD0409B7",
      "seller_name": "Friwest",
      "sponsored": false,
      "stack": "Results for \"coffee makers\"",
      "url": "https://www.walmart.com/ip/Friwest-Espresso-Machine-20-Bar-Super-Compact-Espresso-Maker-with-Touch-Screen-Professional-Coffee-Machine-Automatic-Milk-Frother-for-Cappuccino/20647709765",
      "us_item_id": "20647709765",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": "Best seller",
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Nespresso-Vertuo-Pop-by-De-Longhi-Coffee-and-Espresso-Maker-with-Coffee-Tasting-Set-Black_2fbcceba-acfd-495e-99a8-959dd6776d81.bac0cabc2489f8b12edc8a5607ee5103.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "Nespresso Vertuo Pop Coffee and Espresso Maker by De'Longhi, Liquorice Black",
      "price": {
        "currency": "USD",
        "current": 94.97,
        "high": null,
        "low": null,
        "was": 119
      },
      "product_id": "5Q286GJYV41V",
      "rating": 4.4,
      "review_count": 4253,
      "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
      "seller_name": "Walmart.com",
      "sponsored": false,
      "stack": "Results for \"coffee makers\"",
      "url": "https://www.walmart.com/ip/Nespresso-Vertuo-Pop-by-De-Longhi-Coffee-and-Espresso-Maker-with-Coffee-Tasting-Set-Black/2258193826",
      "us_item_id": "2258193826",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": null,
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/KRUPS-Simply-Brew-Filter-Coffee-Maker-14-Cups-with-Thermal-Carafe_4e35f881-c353-42fd-8503-fb841d351d1a.a27474c2839ec2e4792f54811c4a8b11.jpeg",
      "name": "KRUPS Simply Brew Filter Coffee Maker, 14 Cups with Thermal Carafe",
      "price": {
        "currency": "USD",
        "current": 139.95,
        "high": null,
        "low": null,
        "was": null
      },
      "product_id": "3UUGB90G9YTZ",
      "rating": 4,
      "review_count": 21,
      "seller_id": "A3B96F81A0B94ADCA1528A1167A2D129",
      "seller_name": "Krups",
      "sponsored": false,
      "stack": "Results for \"coffee makers\"",
      "url": "https://www.walmart.com/ip/KRUPS-Simply-Brew-Filter-Coffee-Maker-14-Cups-with-Thermal-Carafe/3414824077",
      "us_item_id": "3414824077",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": null,
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/De-Longhi-All-in-One-Combination-Coffee-Maker-Espresso-Machine-Advanced-Adjustable-Milk-Frother-Cappuccino-Latte-Glass-Coffee-Pot-10-Cup-COM532M-Rene_f13373a0-093b-4b5d-a0db-79336f1e7101.3524387e0d3a8f5d10997a30b72335b7.jpeg",
      "name": "De'Longhi All-in-One Combination Coffee Maker & Espresso Machine + Advanced Adjustable Milk Frother for Cappuccino & Latte + Glass Coffee Pot 10-Cup, COM532M",
      "price": {
        "currency": "USD",
        "current": 299.98,
        "high": null,
        "low": null,
        "was": null
      },
      "product_id": "11Y0N9F1JQDT",
      "rating": null,
      "review_count": null,
      "seller_id": "B88D64B624CE4CE0950EFC2D59C2CD7F",
      "seller_name": "FairDeal Store",
      "sponsored": false,
      "stack": "Results for \"coffee makers\"",
      "url": "https://www.walmart.com/ip/De-Longhi-All-in-One-Combination-Coffee-Maker-Espresso-Machine-Advanced-Adjustable-Milk-Frother-Cappuccino-Latte-Glass-Coffee-Pot-10-Cup-COM532M-Rene/1438829384",
      "us_item_id": "1438829384",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": null,
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Programmable-Coffee-Maker-Thermal-Carafe-Drip-Coffee-Machine-Timer-8-Cup-Coffee-Pot-Pause-Serve-Regular-Strong-Brew-Auto-Shut-Off-Touch-Screen-Black_42b5bd87-6f77-4e14-94af-f74270966a23.fae6116e7c5e9bd17a98689f6ed09dd1.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "8-Cup Programmable Coffee Maker with Thermal Carafe, Touch Screen Timer, Auto Shut off & Pause-Serve Feature, Strong Brew Option, Stainless Steel & Black",
      "price": {
        "currency": "USD",
        "current": 59.99,
        "high": null,
        "low": 49.99,
        "was": 89.99
      },
      "product_id": "10K22J7RCPO2",
      "rating": 4.1,
      "review_count": 645,
      "seller_id": "44CADFFC37A6425BBC63638389292AAB",
      "seller_name": "DILUELC",
      "sponsored": false,
      "stack": "Results for \"coffee makers\"",
      "url": "https://www.walmart.com/ip/Programmable-Coffee-Maker-Thermal-Carafe-Drip-Coffee-Machine-Timer-8-Cup-Coffee-Pot-Pause-Serve-Regular-Strong-Brew-Auto-Shut-Off-Touch-Screen-Black/15323218340",
      "us_item_id": "15323218340",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": "Deal ",
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/FREE-VILLAGE-Single-Serve-Coffee-Maker-2-1-Pod-Coffee-Maker-Machine-K-Cup-Ground-6-14oz-Brew-Sizes-40oz-Removable-Water-Reservoir-LCD-Screen-Self-cle_9aaca5a3-8f95-4e29-92fe-3282426146d4.54ffdaaf32625c661fb39ef480d3513f.jpeg",
      "name": "FREE VILLAGE Single Serve Coffee Maker,2 in 1 Pod Coffee Maker Machine for K-Cup & Ground,6 to 14oz Brew Sizes,40oz Removable Water Reservoir,LCD Screen,Self-cleaning,Black",
      "price": {
        "currency": "USD",
        "current": 23.98,
        "high": null,
        "low": null,
        "was": 44.99
      },
      "product_id": "6JCB3GEZBLPJ",
      "rating": 4.3,
      "review_count": 60,
      "seller_id": "4220C5AFA9B64452BADCE14657FA9254",
      "seller_name": "free village",
      "sponsored": false,
      "stack": "Results for \"coffee makers\"",
      "url": "https://www.walmart.com/ip/FREE-VILLAGE-Single-Serve-Coffee-Maker-2-1-Pod-Coffee-Maker-Machine-K-Cup-Ground-6-14oz-Brew-Sizes-40oz-Removable-Water-Reservoir-LCD-Screen-Self-cle/18141169895",
      "us_item_id": "18141169895",
      "variant_count": null
    }
  ],
  "location": {
    "store_id": "3081"
  },
  "max_page": 25,
  "observed_at_ms": 1790285219353,
  "page": 2,
  "query": null,
  "related_searches": [],
  "sort": "best_match",
  "source_url": "https://www.walmart.com/browse/4044_90548_90546_1115306_5438660?page=2&affinityOverride=default",
  "spelling_correction": null,
  "title": "Results for \"Coffee Makers\"",
  "total_count": 5130
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Browse

- Capability: `products/browse`
- Description: List products in a Walmart category by its `cat_id` (underscore-joined department path such as `4044_90548_90546_1115306_5438660`, as found in `/browse/` URLs, search breadcrumbs and `product.category_path`). Same result shape and location behaviour as `search`.
- Instructions: Enumerate a category page by page, or follow a breadcrumb id returned by an earlier call.
- Cost: 5 credits per call
- Capability file: [Browse](https://firecrawl.dev/alexandria/agents/providers/walmart-com/products/browse)

Accepted options:
- `cat_id` (string, required): Category id, digits joined by underscores, e.g. `4044_90548_90546_1115306_5438660`. Pattern: ^[0-9]+(_[0-9]+)*$. Example: `4044_90548_90546_1115306_5438660`
- `facet` (string): Walmart facet filter, e.g. `brand:Keurig`. Example: `brand:Keurig`
- `limit` (number): limit Example: `40`
- `max_price` (number): max_price Example: `10`
- `min_price` (number): min_price Example: `10`
- `page` (number): page Example: `1`
- `sort` (string): sort Example: `best_match`

Response schema example:
```json
{
  "breadcrumbs": [
    {
      "id": "4044",
      "name": "Home",
      "url": "https://www.walmart.com/cp/4044"
    },
    {
      "id": "4044_90548",
      "name": "Appliances",
      "url": "https://www.walmart.com/browse/home/appliances/4044_90548"
    },
    {
      "id": "4044_90548_90546",
      "name": "Kitchen Appliances",
      "url": "https://www.walmart.com/browse/appliances/kitchen-appliances/4044_90548_90546"
    },
    {
      "id": "4044_90548_90546_1115306",
      "name": "Coffee Shop",
      "url": "https://www.walmart.com/browse/kitchen-appliances/coffee-shop/4044_90548_90546_1115306"
    },
    {
      "id": "4044_90548_90546_1115306_5438660",
      "name": "Coffee Makers",
      "url": "https://www.walmart.com/browse/coffee-shop/coffee-makers/4044_90548_90546_1115306_5438660"
    }
  ],
  "category": {
    "id": "4044_90548_90546_1115306_5438660",
    "name": "Coffee Makers"
  },
  "items": [
    {
      "availability": "IN_STOCK",
      "badge": null,
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Ninja-Mini-Luxe-Caf-Espresso-Machine-Black-ES301_63157930-16b0-49e5-99d4-9572cb470e4d.6beb3ff73160b95413d33d36e485de2e.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "Ninja Luxe Café Mini Espresso Machine & Drip Coffee Maker with Built-in Grinder, Precision Scale & Manual Steam Wand for Lattes, Cappuccinos & More, ES301 Black",
      "price": {
        "currency": "USD",
        "current": 449.99,
        "high": null,
        "low": null,
        "was": null
      },
      "product_id": "63DH1BR8BTQD",
      "rating": 4.8,
      "review_count": 105,
      "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
      "seller_name": "Walmart.com",
      "sponsored": true,
      "stack": "Results for \"coffee makers\"",
      "url": "https://www.walmart.com/ip/Ninja-Mini-Luxe-Caf-Espresso-Machine-Black-ES301/19258703085",
      "us_item_id": "19258703085",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": null,
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Nespresso-VertuoPOP-Dark-Gray-Coffee-and-Espresso-Maker-by-Breville_3db8ca4f-b084-450b-88ff-6260402e7dfc.bba6dd379d23b0409110255f7d68a169.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "Nespresso VertuoPOP Dark Gray Coffee and Espresso Maker by Breville",
      "price": {
        "currency": "USD",
        "current": 94.97,
        "high": null,
        "low": null,
        "was": 119
      },
      "product_id": "465TL9N3AE54",
      "rating": 4.4,
      "review_count": 4253,
      "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
      "seller_name": "Walmart.com",
      "sponsored": true,
      "stack": "Results for \"coffee makers\"",
      "url": "https://www.walmart.com/ip/Nespresso-VertuoPOP-Dark-Gray-Coffee-and-Espresso-Maker-by-Breville/2188239090",
      "us_item_id": "2188239090",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": "Best seller",
      "brand": null,
      "fulfillment_types": [
        "DELIVERY",
        "PICKUP"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Cuisinart-12-Cup-Coffeemaker-Stainless-Steel-Black_b8985ea2-62a7-4c87-9867-e2c538980d2e.c6fa724a88d12d44d3cbc2aeda10962f.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "Cuisinart Stainless Steel 12-Cup Coffee Maker, Black",
      "price": {
        "currency": "USD",
        "current": 59,
        "high": null,
        "low": null,
        "was": 69.95
      },
      "product_id": "4NN9ZW0AZYDK",
      "rating": 4.5,
      "review_count": 4984,
      "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
      "seller_name": "Walmart.com",
      "sponsored": true,
      "stack": "Results for \"coffee makers\"",
      "url": "https://www.walmart.com/ip/Cuisinart-12-Cup-Coffeemaker-Stainless-Steel-Black/808715278",
      "us_item_id": "808715278",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": null,
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Thyme-Table-Barista-Grade-Espresso-Machine-Atlantic-Blue_2b835f70-830d-4161-a041-835f0f0fae6d.f847c84444e3e8a2adae0ce0a15950d9.png?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "Thyme & Table 15-Bar Espresso Machine with Conical Burr Grinder, Atlantic Blue",
      "price": {
        "currency": "USD",
        "current": 368,
        "high": null,
        "low": null,
        "was": null
      },
      "product_id": "7242JT9O2AEG",
      "rating": 4.2,
      "review_count": 267,
      "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
      "seller_name": "Walmart.com",
      "sponsored": true,
      "stack": "Results for \"coffee makers\"",
      "url": "https://www.walmart.com/ip/Thyme-Table-Barista-Grade-Espresso-Machine-Atlantic-Blue/13645253397",
      "us_item_id": "13645253397",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": null,
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Friwest-Espresso-Machine-20-Bar-Super-Compact-Espresso-Maker-with-Touch-Screen-Professional-Coffee-Machine-Automatic-Milk-Frother-for-Cappuccino_cceb69d2-7b01-4f1b-ae6c-df4687fe3bf7.5d497f776e48e92ca5024b7281ad3391.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "Friwest Espresso Machine 20 Bar, Super Compact Espresso Maker with Touch Screen, Professional Coffee Machine, Automatic Milk Frother for Cappuccino",
      "price": {
        "currency": "USD",
        "current": 109.99,
        "high": 139.99,
        "low": 109.99,
        "was": 179.99
      },
      "product_id": "270VV52ON7T5",
      "rating": 4.4,
      "review_count": 11,
      "seller_id": "BC3959A020694E60A9E03907DD0409B7",
      "seller_name": "Friwest",
      "sponsored": false,
      "stack": "Results for \"coffee makers\"",
      "url": "https://www.walmart.com/ip/Friwest-Espresso-Machine-20-Bar-Super-Compact-Espresso-Maker-with-Touch-Screen-Professional-Coffee-Machine-Automatic-Milk-Frother-for-Cappuccino/20647709765",
      "us_item_id": "20647709765",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": "Best seller",
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Nespresso-Vertuo-Pop-by-De-Longhi-Coffee-and-Espresso-Maker-with-Coffee-Tasting-Set-Black_2fbcceba-acfd-495e-99a8-959dd6776d81.bac0cabc2489f8b12edc8a5607ee5103.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "Nespresso Vertuo Pop Coffee and Espresso Maker by De'Longhi, Liquorice Black",
      "price": {
        "currency": "USD",
        "current": 94.97,
        "high": null,
        "low": null,
        "was": 119
      },
      "product_id": "5Q286GJYV41V",
      "rating": 4.4,
      "review_count": 4253,
      "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
      "seller_name": "Walmart.com",
      "sponsored": false,
      "stack": "Results for \"coffee makers\"",
      "url": "https://www.walmart.com/ip/Nespresso-Vertuo-Pop-by-De-Longhi-Coffee-and-Espresso-Maker-with-Coffee-Tasting-Set-Black/2258193826",
      "us_item_id": "2258193826",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": null,
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/KRUPS-Simply-Brew-Filter-Coffee-Maker-14-Cups-with-Thermal-Carafe_4e35f881-c353-42fd-8503-fb841d351d1a.a27474c2839ec2e4792f54811c4a8b11.jpeg",
      "name": "KRUPS Simply Brew Filter Coffee Maker, 14 Cups with Thermal Carafe",
      "price": {
        "currency": "USD",
        "current": 139.95,
        "high": null,
        "low": null,
        "was": null
      },
      "product_id": "3UUGB90G9YTZ",
      "rating": 4,
      "review_count": 21,
      "seller_id": "A3B96F81A0B94ADCA1528A1167A2D129",
      "seller_name": "Krups",
      "sponsored": false,
      "stack": "Results for \"coffee makers\"",
      "url": "https://www.walmart.com/ip/KRUPS-Simply-Brew-Filter-Coffee-Maker-14-Cups-with-Thermal-Carafe/3414824077",
      "us_item_id": "3414824077",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": null,
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/De-Longhi-All-in-One-Combination-Coffee-Maker-Espresso-Machine-Advanced-Adjustable-Milk-Frother-Cappuccino-Latte-Glass-Coffee-Pot-10-Cup-COM532M-Rene_f13373a0-093b-4b5d-a0db-79336f1e7101.3524387e0d3a8f5d10997a30b72335b7.jpeg",
      "name": "De'Longhi All-in-One Combination Coffee Maker & Espresso Machine + Advanced Adjustable Milk Frother for Cappuccino & Latte + Glass Coffee Pot 10-Cup, COM532M",
      "price": {
        "currency": "USD",
        "current": 299.98,
        "high": null,
        "low": null,
        "was": null
      },
      "product_id": "11Y0N9F1JQDT",
      "rating": null,
      "review_count": null,
      "seller_id": "B88D64B624CE4CE0950EFC2D59C2CD7F",
      "seller_name": "FairDeal Store",
      "sponsored": false,
      "stack": "Results for \"coffee makers\"",
      "url": "https://www.walmart.com/ip/De-Longhi-All-in-One-Combination-Coffee-Maker-Espresso-Machine-Advanced-Adjustable-Milk-Frother-Cappuccino-Latte-Glass-Coffee-Pot-10-Cup-COM532M-Rene/1438829384",
      "us_item_id": "1438829384",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": null,
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Programmable-Coffee-Maker-Thermal-Carafe-Drip-Coffee-Machine-Timer-8-Cup-Coffee-Pot-Pause-Serve-Regular-Strong-Brew-Auto-Shut-Off-Touch-Screen-Black_42b5bd87-6f77-4e14-94af-f74270966a23.fae6116e7c5e9bd17a98689f6ed09dd1.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "8-Cup Programmable Coffee Maker with Thermal Carafe, Touch Screen Timer, Auto Shut off & Pause-Serve Feature, Strong Brew Option, Stainless Steel & Black",
      "price": {
        "currency": "USD",
        "current": 59.99,
        "high": null,
        "low": 49.99,
        "was": 89.99
      },
      "product_id": "10K22J7RCPO2",
      "rating": 4.1,
      "review_count": 645,
      "seller_id": "44CADFFC37A6425BBC63638389292AAB",
      "seller_name": "DILUELC",
      "sponsored": false,
      "stack": "Results for \"coffee makers\"",
      "url": "https://www.walmart.com/ip/Programmable-Coffee-Maker-Thermal-Carafe-Drip-Coffee-Machine-Timer-8-Cup-Coffee-Pot-Pause-Serve-Regular-Strong-Brew-Auto-Shut-Off-Touch-Screen-Black/15323218340",
      "us_item_id": "15323218340",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": "Deal ",
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/FREE-VILLAGE-Single-Serve-Coffee-Maker-2-1-Pod-Coffee-Maker-Machine-K-Cup-Ground-6-14oz-Brew-Sizes-40oz-Removable-Water-Reservoir-LCD-Screen-Self-cle_9aaca5a3-8f95-4e29-92fe-3282426146d4.54ffdaaf32625c661fb39ef480d3513f.jpeg",
      "name": "FREE VILLAGE Single Serve Coffee Maker,2 in 1 Pod Coffee Maker Machine for K-Cup & Ground,6 to 14oz Brew Sizes,40oz Removable Water Reservoir,LCD Screen,Self-cleaning,Black",
      "price": {
        "currency": "USD",
        "current": 23.98,
        "high": null,
        "low": null,
        "was": 44.99
      },
      "product_id": "6JCB3GEZBLPJ",
      "rating": 4.3,
      "review_count": 60,
      "seller_id": "4220C5AFA9B64452BADCE14657FA9254",
      "seller_name": "free village",
      "sponsored": false,
      "stack": "Results for \"coffee makers\"",
      "url": "https://www.walmart.com/ip/FREE-VILLAGE-Single-Serve-Coffee-Maker-2-1-Pod-Coffee-Maker-Machine-K-Cup-Ground-6-14oz-Brew-Sizes-40oz-Removable-Water-Reservoir-LCD-Screen-Self-cle/18141169895",
      "us_item_id": "18141169895",
      "variant_count": null
    }
  ],
  "location": {
    "store_id": "3081"
  },
  "max_page": 25,
  "observed_at_ms": 1790285219353,
  "page": 2,
  "query": null,
  "related_searches": [],
  "sort": "best_match",
  "source_url": "https://www.walmart.com/browse/4044_90548_90546_1115306_5438660?page=2&affinityOverride=default",
  "spelling_correction": null,
  "title": "Results for \"Coffee Makers\"",
  "total_count": 5130
}
```

### Product

- Capability: `products/product`
- Description: Product detail for one Walmart item (`us_item_id`, the numeric id in `/ip/<slug>/<id>` URLs): name, brand, UPC, model, price in USD, availability, seller, images, category path, specifications, variant options with the sibling items' ids and prices, and shipping / pickup / delivery options for the store nearest the proxy exit (see `location`). Store selection by ZIP is not supported.
- Instructions: Get the full record for an item found by `search`, `browse` or pasted as a walmart.com/ip/ URL.
- Cost: 5 credits per call
- Capability file: [Product](https://firecrawl.dev/alexandria/agents/providers/walmart-com/products/product)

Accepted options:
- `url` (string): A walmart.com `/ip/...` product URL; the item id is taken from its path. Example: `/ip/...`
- `us_item_id` (string): Walmart item id, e.g. `5254334127`. Give either this or `url`. Pattern: ^[0-9]{1,20}$. Example: `5254334127`

Response schema example:
```json
{
  "availability": "IN_STOCK",
  "brand": "Keurig",
  "category_path": [
    {
      "name": "Home",
      "url": "https://www.walmart.com/cp/home/4044"
    },
    {
      "name": "Appliances",
      "url": "https://www.walmart.com/cp/appliances/90548"
    },
    {
      "name": "Kitchen Appliances",
      "url": "https://www.walmart.com/cp/kitchen-appliances/90546"
    },
    {
      "name": "Coffee Shop",
      "url": "https://www.walmart.com/cp/coffee-shop/1115306"
    },
    {
      "name": "Keurig Coffee Makers",
      "url": "https://www.walmart.com/cp/keurig-coffee-makers/3298657"
    }
  ],
  "description_html": "<ul>  <li>BREW OVER ICE WITH THE KEURIG K-EXPRESS ESSENTIALS PLUS COFFEE MAKER: Automatically adjusts brew temperature — starting hotter to help extract full flavor, then cooling down for less ice melt.</li>  <li>BREWS MULTIPLE CUP SIZES: Brew a 12oz cup of refreshing iced coffee with the Keurig K-Express Essentials Plus coffee maker and choose from 6, 8, and 10oz sizes for hot coffee.</li>  <li>CONVENIENT 36oz REMOVABLE WATER RESERVOIR: Allows you to brew up to 3 cups between refills.</li>  <li>FAST &amp; FRESH-BREWED: Delicious iced coffee and hot coffee made in minutes.</li>  <li>ICED TUMBLER FRIENDLY: Removable drip tray accommodates tumblers and travel mugs up to 7” tall and holds a full accidental brew for easy cleanup.</li>  <li>ENERGY EFFICIENT WITH AUTO-OFF FEATURE: Auto off feature turns off your Keurig K-Express Essentials Plus coffee maker 5 minutes after the last brew, helping to save energy.</li>  <li>COMPATIBLE WITH THE KEURIG MY K-CUP REUSABLE COFFEE FILTER: Brew using your own ground coffee (sold separately).&nbsp;</li> </ul>",
  "fulfillment": [
    {
      "availability": "IN_STOCK",
      "badge": "Today",
      "delivery_date": "2026-09-24T21:59:00.000Z",
      "free": true,
      "location_text": "Sacramento, 95829",
      "max_order_quantity": 99,
      "price": null,
      "type": "SHIPPING"
    },
    {
      "availability": "IN_STOCK",
      "badge": "Today",
      "delivery_date": null,
      "free": true,
      "location_text": "Sacramento Supercenter",
      "max_order_quantity": 12,
      "price": null,
      "type": "PICKUP"
    },
    {
      "availability": "IN_STOCK",
      "badge": "Today",
      "delivery_date": "2026-09-24T18:00:00.000-07:00",
      "free": false,
      "location_text": "Sacramento, 95829",
      "max_order_quantity": 12,
      "price": 7.95,
      "type": "DELIVERY"
    }
  ],
  "highlights": [
    {
      "name": "Compatible form",
      "value": "Pods"
    },
    {
      "name": "Number of preset cup sizes",
      "value": "3"
    },
    {
      "name": "Preset cup sizes",
      "value": "6 oz, 8 oz, 10 oz"
    },
    {
      "name": "Water reservoir capacity",
      "value": "36 oz"
    },
    {
      "name": "Weight",
      "value": "4.5 lb"
    }
  ],
  "images": [
    "https://i5.walmartimages.com/seo/Keurig-K-Iced-Essentials-Iced-and-Hot-Single-Serve-K-Cup-Pod-Coffee-Maker-Black_795df493-be28-4822-913d-cb72e1e5d84e.f0bf142dbccf98fd5e7e35d16c8aec3f.jpeg",
    "https://i5.walmartimages.com/asr/50255848-146b-4250-a55d-1d4f34be50f7.602ea1202accbf3ef4af812a751483eb.jpeg",
    "https://i5.walmartimages.com/asr/32e2e328-b46b-4a4e-85b8-4a9133eb627a.4b3b698ceb53f6380a870e2367eb6fae.jpeg",
    "https://i5.walmartimages.com/asr/f5cbf210-3609-41cd-ad0d-db4a1b83e20f.3ce805415e9cddcf2a4acb1995fa2ab3.jpeg",
    "https://i5.walmartimages.com/asr/052cb1b6-ee79-4e03-8bc6-07ba659035fb.e40bee915aece4ea0fcf4dce715d420a.jpeg",
    "https://i5.walmartimages.com/asr/e2a52c1d-2d24-4999-b608-9c4ca610f70b.a8389e57d3f518dfb6073bafae27eb5e.jpeg",
    "https://i5.walmartimages.com/asr/e37dbddd-fd03-4292-8d58-939f11b505f2.8be506baecc9903f7e344608bbc36d0a.jpeg",
    "https://i5.walmartimages.com/asr/7aa339ea-bcab-4ba5-a07a-7cb3ec6e194a.4dfd62d479e5110de9606f09ac9c3a37.jpeg",
    "https://i5.walmartimages.com/asr/1c338056-1f17-4fb0-bafa-ce8b7a76d059.02a5bb1e2eb946b0cb7c9fcd543c19b5.jpeg",
    "https://i5.walmartimages.com/asr/e70afaf6-791b-4e3d-ab16-4bee0072495a.06cc290ee7f58c3951196caa624de8ce.jpeg",
    "https://i5.walmartimages.com/asr/57ecf104-b9ed-43e5-a3fd-eff38bc027ec.e6bc845295e26032531d1b5450ce4d9d.jpeg",
    "https://i5.walmartimages.com/asr/ad100b0e-9fd3-4f9c-b839-1128553992ba.0ddb59d1a5eb231c3c59af99c3239409.jpeg",
    "https://i5.walmartimages.com/asr/5129aeb9-c467-4b4d-b54b-b9b46840288c.9353f65f234f62391daba9b0c4700354.jpeg"
  ],
  "location": {
    "city": "Sacramento",
    "postal_code": "95829",
    "state": "CA",
    "store_id": "3081"
  },
  "model": "5000391272",
  "name": "Keurig K-Express Essentials Plus, Iced and Hot Single-Serve K-Cup Pod Coffee Maker, Black",
  "observed_at_ms": 1790285230899,
  "price": {
    "currency": "USD",
    "current": 74,
    "current_display": "$74.00",
    "list": null,
    "max": null,
    "min": null,
    "savings": null,
    "unit_price": null,
    "was": null
  },
  "product_id": "4JWKYM3HL0LE",
  "product_type": "Single-Serve Brewers",
  "rating": 4.3,
  "return_policy": {
    "free_returns": true,
    "returnable": true,
    "text": "Free 90-day returns",
    "window_days": 90
  },
  "review_count": 27273,
  "seller": {
    "id": "F55CDC31AB754BB68FE0B39041159D63",
    "name": "Walmart.com",
    "type": "INTERNAL"
  },
  "short_description": "Introducing the Keurig K-Express Essentials Plus Single Serve Coffee Maker: Enjoy refreshingly delicious iced coffee and full-flavored hot coffee from one multitalented coffee maker. Brew the perfect coffee for any craving, mood, or mouthwatering moment. Always easy, always right. It’s all in the blue Brew Over Ice button. One push, and the Keurig K-Express Essentials Plus coffee maker automatically adjusts the brew temperature, starting hotter to extract full flavor, then cooling down to minimize ice melt. All for a vibrant, balanced iced coffee that never tastes watered down. Brew a 12oz cup for your favorite iced coffee or choose from 3 cup sizes for hot coffee — 6, 8, or 10oz. Whether brewing hot or iced, the 36oz removable reservoir lets you enjoy multiple deliciously refreshing cups between refills. Exclusively at Walmart. *Cup not included*",
  "source_url": "https://www.walmart.com/ip/5254334127",
  "specifications": [
    {
      "name": "Compatible form",
      "value": "Pods"
    },
    {
      "name": "Items included",
      "value": "Keurig K Express Essentials Plus, Iced and Hot Single Serve K Cup Pod Coffee Maker"
    },
    {
      "name": "Number of preset cup sizes",
      "value": "3"
    },
    {
      "name": "Preset cup sizes",
      "value": "6 oz, 8 oz, 10 oz"
    },
    {
      "name": "Water reservoir capacity",
      "value": "36 oz"
    },
    {
      "name": "Weight",
      "value": "4.5 lb"
    },
    {
      "name": "Brand",
      "value": "Keurig"
    },
    {
      "name": "Features",
      "value": "Automatic Shut Off, Removable Drip Tray"
    },
    {
      "name": "Color",
      "value": "Black"
    },
    {
      "name": "Dimensions",
      "value": "11.30 x 6.50 x 12.20 Inches"
    },
    {
      "name": "Material",
      "value": "Plastic"
    }
  ],
  "upc": "611247403990",
  "url": "https://www.walmart.com/ip/Keurig-K-Iced-Essentials-Iced-and-Hot-Single-Serve-K-Cup-Pod-Coffee-Maker-Black/5254334127",
  "us_item_id": "5254334127",
  "variants": {
    "criteria": [
      {
        "id": "actual_color",
        "name": "Actual Color",
        "options": [
          {
            "availability": "AVAILABLE",
            "id": "actual_color-arcticgray",
            "name": "Arctic Gray",
            "product_ids": [
              "1OOIN5X3VK1G"
            ],
            "selected": false
          },
          {
            "availability": "AVAILABLE",
            "id": "actual_color-black",
            "name": "Black",
            "product_ids": [
              "4JWKYM3HL0LE"
            ],
            "selected": true
          },
          {
            "availability": "AVAILABLE",
            "id": "actual_color-white",
            "name": "White",
            "product_ids": [
              "3E42OMBU3GVL"
            ],
            "selected": false
          }
        ],
        "type": "SWATCH"
      }
    ],
    "products": [
      {
        "availability": "IN_STOCK",
        "price": 67.95,
        "product_id": "1OOIN5X3VK1G",
        "url": "https://www.walmart.com/ip/Keurig-K-Iced-Essentials-Gray-Iced-and-Hot-Single-Serve-K-Cup-Pod-Coffee-Maker-reusable-tumbler-included/2937340344",
        "us_item_id": "2937340344",
        "variant_ids": [
          "actual_color-arcticgray"
        ]
      },
      {
        "availability": "IN_STOCK",
        "price": 74,
        "product_id": "3E42OMBU3GVL",
        "url": "https://www.walmart.com/ip/Keurig-K-Iced-Essentials-Iced-and-Hot-Single-Serve-K-Cup-Pod-Coffee-Maker-White/2743069442",
        "us_item_id": "2743069442",
        "variant_ids": [
          "actual_color-white"
        ]
      },
      {
        "availability": "IN_STOCK",
        "price": 74,
        "product_id": "4JWKYM3HL0LE",
        "url": "https://www.walmart.com/ip/Keurig-K-Iced-Essentials-Iced-and-Hot-Single-Serve-K-Cup-Pod-Coffee-Maker-Black/5254334127",
        "us_item_id": "5254334127",
        "variant_ids": [
          "actual_color-black"
        ]
      }
    ],
    "selected": [
      "actual_color-black"
    ]
  }
}
```

### Reviews

- Capability: `products/reviews`
- Description: Customer reviews for one Walmart item, 10 per page, with the rating summary (average, histogram, recommended percentage). Sort by relevancy, submission date, rating or helpfulness.
- Instructions: Read what buyers say about an item found by `search` or `product`.
- Cost: 5 credits per call
- Capability file: [Reviews](https://firecrawl.dev/alexandria/agents/providers/walmart-com/products/reviews)

Accepted options:
- `page` (number): page Example: `1`
- `sort` (string): sort Example: `relevancy`
- `url` (string): A walmart.com `/ip/...` or `/reviews/product/...` URL. Example: `/ip/...`
- `us_item_id` (string): Walmart item id. Give either this or `url`. Pattern: ^[0-9]{1,20}$. Example: `<us_item_id>`

Response schema example:
```json
{
  "next_page": 3,
  "observed_at_ms": 1790285254754,
  "page": 2,
  "product_name": "Keurig K-Express Essentials Plus, Iced and Hot Single-Serve K-Cup Pod Coffee Maker, Black",
  "product_url": "https://www.walmart.com/ip/Keurig-K-Iced-Essentials-Iced-and-Hot-Single-Serve-K-Cup-Pod-Coffee-Maker-Black/5254334127",
  "reviews": [
    {
      "features": [
        {
          "name": "Color",
          "value": "Black"
        }
      ],
      "negative_feedback": 0,
      "nickname": "Evie",
      "photos": [],
      "positive_feedback": 0,
      "rating": 5,
      "recommended": null,
      "review_id": "441021840",
      "seller_responses": [
        {
          "department": "Keurig Care",
          "response": "Thank you for the wonderful feedback. We're thrilled to hear you're enjoying every cup. Happy brewing!"
        }
      ],
      "submitted": "9/18/2026",
      "syndication_source": null,
      "text": "perfect everytime hot or cold",
      "title": null,
      "verified_purchase": true
    },
    {
      "features": [
        {
          "name": "Color",
          "value": "White"
        }
      ],
      "negative_feedback": 0,
      "nickname": "Cathy",
      "photos": [],
      "positive_feedback": 0,
      "rating": 5,
      "recommended": null,
      "review_id": "440953042",
      "seller_responses": [
        {
          "department": "Keurig Care",
          "response": "We're glad you've found the perfect fit for your kitchen!"
        }
      ],
      "submitted": "9/18/2026",
      "syndication_source": null,
      "text": "Works great",
      "title": "Keurig",
      "verified_purchase": true
    },
    {
      "features": [
        {
          "name": "Color",
          "value": "Arctic Gray"
        }
      ],
      "negative_feedback": 0,
      "nickname": "Josh",
      "photos": [],
      "positive_feedback": 0,
      "rating": 1,
      "recommended": null,
      "review_id": "440898922",
      "seller_responses": [],
      "submitted": "9/17/2026",
      "syndication_source": null,
      "text": "It leaks. Taking it back. I had water all over the counter I thought my husband spilled water. Finally caught in that it was from where the water container goes.",
      "title": null,
      "verified_purchase": true
    },
    {
      "features": [
        {
          "name": "Color",
          "value": "White"
        }
      ],
      "negative_feedback": 0,
      "nickname": "kelli",
      "photos": [],
      "positive_feedback": 0,
      "rating": 1,
      "recommended": null,
      "review_id": "440746569",
      "seller_responses": [],
      "submitted": "9/16/2026",
      "syndication_source": null,
      "text": "Broke after 5 uses",
      "title": "Buyer beware",
      "verified_purchase": true
    },
    {
      "features": [
        {
          "name": "Color",
          "value": "Arctic Gray"
        }
      ],
      "negative_feedback": 0,
      "nickname": "Janet",
      "photos": [],
      "positive_feedback": 0,
      "rating": 5,
      "recommended": null,
      "review_id": "440686223",
      "seller_responses": [
        {
          "department": "Keurig Care",
          "response": "We appreciate your positive review and feedback! Thanks for brewing the love!"
        }
      ],
      "submitted": "9/15/2026",
      "syndication_source": null,
      "text": "Bought for my granddaughter and she LOVES it",
      "title": null,
      "verified_purchase": true
    },
    {
      "features": [
        {
          "name": "Color",
          "value": "Black"
        }
      ],
      "negative_feedback": 0,
      "nickname": "Joseph",
      "photos": [],
      "positive_feedback": 0,
      "rating": 5,
      "recommended": null,
      "review_id": "440638560",
      "seller_responses": [],
      "submitted": "9/15/2026",
      "syndication_source": null,
      "text": "nice. Great",
      "title": null,
      "verified_purchase": true
    },
    {
      "features": [
        {
          "name": "Color",
          "value": "White"
        }
      ],
      "negative_feedback": 0,
      "nickname": "Patty",
      "photos": [],
      "positive_feedback": 0,
      "rating": 5,
      "recommended": null,
      "review_id": "440548010",
      "seller_responses": [
        {
          "department": "Keurig Care",
          "response": "Thank you for taking the time to share your feedback. We're glad you're enjoying your coffee maker! Happy brewing!"
        }
      ],
      "submitted": "9/14/2026",
      "syndication_source": null,
      "text": "This Keurig was a gift for my daughter . She loves it as she is an iced coffee drinker as well as a hot coffee drinker so this was the perfect gift . It was a great price too",
      "title": "Great product great price",
      "verified_purchase": true
    },
    {
      "features": [
        {
          "name": "Color",
          "value": "Arctic Gray"
        }
      ],
      "negative_feedback": 0,
      "nickname": "lbshowers",
      "photos": [],
      "positive_feedback": 0,
      "rating": 5,
      "recommended": null,
      "review_id": "440512997",
      "seller_responses": [
        {
          "department": "Keurig Care",
          "response": "Thank you for sharing your review with us. We appreciate the feedback."
        }
      ],
      "submitted": "9/14/2026",
      "syndication_source": null,
      "text": "it's really nice  I'm not waisting the coffee from the pot.",
      "title": "great coffee",
      "verified_purchase": true
    },
    {
      "features": [
        {
          "name": "Color",
          "value": "Arctic Gray"
        }
      ],
      "negative_feedback": 0,
      "nickname": "Zachary",
      "photos": [],
      "positive_feedback": 0,
      "rating": 1,
      "recommended": null,
      "review_id": "440432754",
      "seller_responses": [],
      "submitted": "9/13/2026",
      "syndication_source": null,
      "text": "Piece of garbage. Stopped working right after the 90 day return policy. Tried all the troubleshooting steps and still doesn't make coffee.",
      "title": "Junk, DO NOT BUY!",
      "verified_purchase": true
    },
    {
      "features": [
        {
          "name": "Color",
          "value": "Arctic Gray"
        }
      ],
      "negative_feedback": 0,
      "nickname": "Vicky",
      "photos": [],
      "positive_feedback": 0,
      "rating": 5,
      "recommended": null,
      "review_id": "440421756",
      "seller_responses": [
        {
          "department": "Keurig Care",
          "response": "We're glad you've found the perfect fit for your kitchen!"
        }
      ],
      "submitted": "9/13/2026",
      "syndication_source": null,
      "text": "Lightweight and smaller than my old model.",
      "title": "Kuerig",
      "verified_purchase": true
    }
  ],
  "sort": "submission-desc",
  "source_url": "https://www.walmart.com/reviews/product/5254334127?sort=submission-desc&page=2",
  "summary": {
    "average_rating": 4.3,
    "rating_histogram": {
      "1": 2796,
      "2": 852,
      "3": 1187,
      "4": 2634,
      "5": 19804
    },
    "recommended_percentage": 79,
    "reviews_with_text_count": 6472,
    "total_review_count": 27273
  },
  "us_item_id": "5254334127"
}
```

### Search

- Capability: `products/search`
- Description: Search Walmart.com products by keyword. Returns one page (up to 40 primary results plus secondary stacks such as '4 stars and above') with prices in USD, rating, seller, availability and the product URL. Prices, pickup and delivery availability are for the store nearest the proxy exit (reported in `location`).
- Instructions: Find Walmart products by keyword and pick a `us_item_id` for `product` or `reviews`.
- Cost: 5 credits per call
- Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/walmart-com/products/search)

Accepted options:
- `facet` (string): Walmart facet filter as the site writes it, e.g. `brand:Keurig`; several facets joined with `||`. Example: `brand:Keurig`
- `limit` (number): Maximum number of items returned from this page after de-duplication. Example: `40`
- `max_price` (number): Upper price bound in USD. Example: `10`
- `min_price` (number): Lower price bound in USD. Example: `10`
- `page` (number): Result page (40 primary results per page). Walmart caps search at 25 pages. Example: `1`
- `query` (string, required): Search keywords, e.g. `coffee maker`. Example: `coffee maker`
- `sort` (string): sort Example: `best_match`

Response schema example:
```json
{
  "breadcrumbs": [],
  "category": null,
  "items": [
    {
      "availability": "IN_STOCK",
      "badge": "Rollback",
      "brand": null,
      "fulfillment_types": [
        "DELIVERY",
        "PICKUP"
      ],
      "image_url": "https://i5.walmartimages.com/seo/KEE-BLACK-GEN-2_70d03917-65f9-480f-8391-aade09ee61ca.c44d2b2f723cb1529a4c181faed76958.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "Keurig K-Express Essentials Black Single-Serve K-Cup Pod Coffee Maker",
      "price": {
        "currency": "USD",
        "current": 49.47,
        "high": null,
        "low": null,
        "was": 54.97
      },
      "product_id": "1VBPWK95CE2G",
      "rating": 4.4,
      "review_count": 12418,
      "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
      "seller_name": "Walmart.com",
      "sponsored": true,
      "stack": "Results for \"coffee maker\"",
      "url": "https://www.walmart.com/ip/KEE-BLACK-GEN-2/12516374178",
      "us_item_id": "12516374178",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": null,
      "brand": null,
      "fulfillment_types": [
        "DELIVERY",
        "PICKUP"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Keurig-K-Iced-Essentials-Iced-and-Hot-Single-Serve-K-Cup-Pod-Coffee-Maker-Black_795df493-be28-4822-913d-cb72e1e5d84e.f0bf142dbccf98fd5e7e35d16c8aec3f.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "Keurig K-Express Essentials Plus, Iced and Hot Single-Serve K-Cup Pod Coffee Maker, Black",
      "price": {
        "currency": "USD",
        "current": 74,
        "high": null,
        "low": 67.95,
        "was": null
      },
      "product_id": "4JWKYM3HL0LE",
      "rating": 4.3,
      "review_count": 27273,
      "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
      "seller_name": "Walmart.com",
      "sponsored": true,
      "stack": "Results for \"coffee maker\"",
      "url": "https://www.walmart.com/ip/Keurig-K-Iced-Essentials-Iced-and-Hot-Single-Serve-K-Cup-Pod-Coffee-Maker-Black/5254334127",
      "us_item_id": "5254334127",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": null,
      "brand": null,
      "fulfillment_types": [
        "DELIVERY",
        "PICKUP"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Cuisinart-12-Cup-Coffeemaker-Stainless-Steel-Black_b8985ea2-62a7-4c87-9867-e2c538980d2e.c6fa724a88d12d44d3cbc2aeda10962f.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "Cuisinart Stainless Steel 12-Cup Coffee Maker, Black",
      "price": {
        "currency": "USD",
        "current": 59,
        "high": null,
        "low": null,
        "was": 69.95
      },
      "product_id": "4NN9ZW0AZYDK",
      "rating": 4.5,
      "review_count": 4984,
      "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
      "seller_name": "Walmart.com",
      "sponsored": true,
      "stack": "Results for \"coffee maker\"",
      "url": "https://www.walmart.com/ip/Cuisinart-12-Cup-Coffeemaker-Stainless-Steel-Black/808715278",
      "us_item_id": "808715278",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": "Overall pick",
      "brand": null,
      "fulfillment_types": [
        "DELIVERY",
        "PICKUP"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Mainstays-Black-12-Cup-Drip-Coffee-Maker_58a85a1a-a7c6-4340-b23f-7e3040fe3a82.9bfe652540ee75919b2f687ebcd098c7.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "Mainstays Black 12-Cup Drip Coffee Maker",
      "price": {
        "currency": "USD",
        "current": 14.42,
        "high": 57.68,
        "low": 14.42,
        "was": 16.88
      },
      "product_id": "3LGZ2GE36DTD",
      "rating": 4.5,
      "review_count": 11688,
      "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
      "seller_name": "Walmart.com",
      "sponsored": false,
      "stack": "Results for \"coffee maker\"",
      "url": "https://www.walmart.com/ip/Mainstays-Black-12-Cup-Drip-Coffee-Maker/5162907971",
      "us_item_id": "5162907971",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": "Best seller",
      "brand": null,
      "fulfillment_types": [
        "DELIVERY",
        "PICKUP"
      ],
      "image_url": "https://i5.walmartimages.com/seo/MS-5C-COFFEEMKR-BLK_16f77040-27ab-4008-9852-59c900d7a7d9_1.c524f1d9c465e122596bf65f939c8d26.jpeg",
      "name": "Mainstays 5 Cup Drip Coffee Maker, Black",
      "price": {
        "currency": "USD",
        "current": 8.97,
        "high": null,
        "low": null,
        "was": 13.44
      },
      "product_id": "4O7S52VVUTO5",
      "rating": 4.5,
      "review_count": 3105,
      "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
      "seller_name": "Walmart.com",
      "sponsored": false,
      "stack": "Results for \"coffee maker\"",
      "url": "https://www.walmart.com/ip/MS-5C-COFFEEMKR-BLK/16511261839",
      "us_item_id": "16511261839",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": "Rollback",
      "brand": null,
      "fulfillment_types": [
        "DELIVERY",
        "PICKUP"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Mr-Coffee-12-Cup-Switch-Coffee-Maker_163868ae-a6d3-42d2-b5ca-b748bd3760a5.94b4688c53a6ceb7e73a316237ba9889.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "Mr. Coffee® 12-Cup Switch Coffee Maker",
      "price": {
        "currency": "USD",
        "current": 22.97,
        "high": 22.97,
        "low": 22.97,
        "was": 32.44
      },
      "product_id": "2PYW02WQPL74",
      "rating": 4.4,
      "review_count": 2067,
      "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
      "seller_name": "Walmart.com",
      "sponsored": true,
      "stack": "Results for \"coffee maker\"",
      "url": "https://www.walmart.com/ip/Mr-Coffee-12-Cup-Switch-Coffee-Maker/14058613820",
      "us_item_id": "14058613820",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": null,
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Mr-Coffee-Programmable-3-Way-Brewing-System-12-Cup-Drip-Coffee-Makers_62ec5538-4a1a-4fc6-9525-383ececda64b.1e41819f635682c75c3510675a8cfa37.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "Mr. Coffee 12 Cup Programmable Coffee Maker with 3 Ways to Brew System",
      "price": {
        "currency": "USD",
        "current": 49.97,
        "high": null,
        "low": null,
        "was": null
      },
      "product_id": "3PWG506OMQTJ",
      "rating": 4.4,
      "review_count": 4897,
      "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
      "seller_name": "Walmart.com",
      "sponsored": true,
      "stack": "Results for \"coffee maker\"",
      "url": "https://www.walmart.com/ip/Mr-Coffee-Programmable-3-Way-Brewing-System-12-Cup-Drip-Coffee-Makers/3406383181",
      "us_item_id": "3406383181",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": null,
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Cuisinart-Perfectemp-Silver-Finish-14-Cup-Programmable-Coffeemaker_997ef9b7-6f40-4327-a2f9-ae38ed119602.44589019cede5b85f2f5b4030b9c9046.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "Cuisinart Stainless Steel 14-Cup Coffee Machine, Silver",
      "price": {
        "currency": "USD",
        "current": 105.99,
        "high": null,
        "low": null,
        "was": 119.95
      },
      "product_id": "77J0XWCDNF8P",
      "rating": 4.5,
      "review_count": 740,
      "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
      "seller_name": "Walmart.com",
      "sponsored": true,
      "stack": "Results for \"coffee maker\"",
      "url": "https://www.walmart.com/ip/Cuisinart-Perfectemp-Silver-Finish-14-Cup-Programmable-Coffeemaker/2110250865",
      "us_item_id": "2110250865",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": "Rollback",
      "brand": null,
      "fulfillment_types": [
        "DELIVERY",
        "PICKUP"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Mr-Coffee-5-Cup-Programmable-Coffee-Maker_972164db-9b9b-42e2-9463-80f40fb360e3.2423b7d6d6d77ec31ed140a0cece9662.jpeg",
      "name": "Mr. Coffee 5-Cup Programmable Coffee Maker",
      "price": {
        "currency": "USD",
        "current": 17.97,
        "high": null,
        "low": null,
        "was": 29.47
      },
      "product_id": "12AGWP3W27NG",
      "rating": 4.5,
      "review_count": 3780,
      "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
      "seller_name": "Walmart.com",
      "sponsored": false,
      "stack": "Results for \"coffee maker\"",
      "url": "https://www.walmart.com/ip/Mr-Coffee-5-Cup-Programmable-Coffee-Maker/14017166848",
      "us_item_id": "14017166848",
      "variant_count": null
    },
    {
      "availability": "IN_STOCK",
      "badge": null,
      "brand": null,
      "fulfillment_types": [
        "DELIVERY"
      ],
      "image_url": "https://i5.walmartimages.com/seo/Keurig-K-Express-Essentials-Matte-Gray-Single-Serve-K-Cup-Pod-Coffee-Maker_426a2e38-f7b0-4ccd-b748-e08d58470d8f.9ce1df8936452cfac3a4b844dc7ab0f2.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "name": "K-Express Essentials™ Coffee Maker – Matte Gray - Warranty Replacement",
      "price": {
        "currency": "USD",
        "current": 49.99,
        "high": null,
        "low": null,
        "was": 59
      },
      "product_id": "7JQ6UWQBN23T",
      "rating": 4.4,
      "review_count": 64879,
      "seller_id": "20B797687F7443C983B928B3912082B4",
      "seller_name": "Keurig Direct",
      "sponsored": false,
      "stack": "Results for \"coffee maker\"",
      "url": "https://www.walmart.com/ip/Keurig-K-Express-Essentials-Matte-Gray-Single-Serve-K-Cup-Pod-Coffee-Maker/984914014",
      "us_item_id": "984914014",
      "variant_count": null
    }
  ],
  "location": {
    "store_id": "3081"
  },
  "max_page": 14,
  "observed_at_ms": 1790285171290,
  "page": 1,
  "query": "coffee maker",
  "related_searches": [
    "coffee filters",
    "coffee",
    "keurig coffee maker",
    "coffee maker k cup",
    "coffee filters 8-12 cup",
    "toaster",
    "coffee maker 5 cup",
    "k cups",
    "coffee maker 12 cup",
    "coffee maker ninja"
  ],
  "sort": "best_match",
  "source_url": "https://www.walmart.com/search?q=coffee+maker",
  "spelling_correction": null,
  "title": "Results for \"coffee maker\"",
  "total_count": 4261
}
```

### Store

- Capability: `products/store`
- Description: One Walmart store by numeric store id: name, address, phone, coordinates, weekly hours, in-store services with their hours (optional), fuel prices when the store has a fuel station, and the nearest Walmart stores with distances in miles.
- Instructions: Look up a store seen in `product.location.store_id` or a walmart.com/store/ URL, or hop to nearby stores.
- Cost: 5 credits per call
- Capability file: [Store](https://firecrawl.dev/alexandria/agents/providers/walmart-com/products/store)

Accepted options:
- `include_services` (boolean): Include the in-store services list with their hours. Example: `false`
- `nearby_limit` (number): Maximum number of nearby stores returned (the page lists up to about 35, nearest first). Example: `10`
- `store_id` (string): Walmart store number, e.g. `3081`. Give either this or `url`. Pattern: ^[0-9]{1,8}$. Example: `3081`
- `url` (string): A walmart.com `/store/<id>-<slug>` URL. Example: `/store/<id>-<slug>`

Response schema example:
```json
{
  "address": {
    "city": "Sacramento",
    "country": "US",
    "line1": "8915 Gerber Road",
    "line2": null,
    "postal_code": "95829",
    "state": "CA"
  },
  "capabilities": [
    "FUEL_STATIONS",
    "PICKUP_SPECIAL_EVENT",
    "DELIVERY_ADDRESS",
    "PICKUP_INSTORE",
    "PICKUP_CURBSIDE",
    "DELIVERY_SPECIAL_EVENT",
    "DELIVERY_IN_HOME",
    "PHARMACY_IMMUNIZATION"
  ],
  "display_name": "Sacramento Gerber Rd Supercenter",
  "fuel_prices": [
    {
      "grade": "Unleaded",
      "price": 5.639
    },
    {
      "grade": "Mid-Grade",
      "price": 5.839
    },
    {
      "grade": "Premium",
      "price": 6.139
    },
    {
      "grade": "Diesel",
      "price": 8.079
    }
  ],
  "hours": [
    {
      "close": "23:00",
      "closed": false,
      "day": "Sunday",
      "open": "06:00"
    },
    {
      "close": "23:00",
      "closed": false,
      "day": "Monday",
      "open": "06:00"
    },
    {
      "close": "23:00",
      "closed": false,
      "day": "Tuesday",
      "open": "06:00"
    },
    {
      "close": "23:00",
      "closed": false,
      "day": "Wednesday",
      "open": "06:00"
    },
    {
      "close": "23:00",
      "closed": false,
      "day": "Thursday",
      "open": "06:00"
    },
    {
      "close": "23:00",
      "closed": false,
      "day": "Friday",
      "open": "06:00"
    },
    {
      "close": "23:00",
      "closed": false,
      "day": "Saturday",
      "open": "06:00"
    }
  ],
  "latitude": 38.482677,
  "longitude": -121.369026,
  "name": "Walmart Supercenter",
  "nearby_stores": [
    {
      "address": {
        "city": "Sacramento",
        "country": "US",
        "line1": "6051 Florin Rd",
        "line2": null,
        "postal_code": "95823",
        "state": "CA"
      },
      "display_name": "Sacramento Florin Rd Supercenter",
      "distance_miles": 3.68,
      "name": "Walmart Supercenter",
      "phone": "916-427-9719",
      "store_id": "2735",
      "url": "https://www.walmart.com/store/2735-sacramento-ca"
    },
    {
      "address": {
        "city": "Elk Grove",
        "country": "US",
        "line1": "8465 Elk Grove Blvd",
        "line2": null,
        "postal_code": "95758",
        "state": "CA"
      },
      "display_name": "Elk Grove Blvd Store",
      "distance_miles": 5.05,
      "name": "Walmart",
      "phone": "916-684-7100",
      "store_id": "1697",
      "url": "https://www.walmart.com/store/1697-elk-grove-ca"
    },
    {
      "address": {
        "city": "Elk Grove",
        "country": "US",
        "line1": "8455 Elk Grove Blvd",
        "line2": null,
        "postal_code": "95758",
        "state": "CA"
      },
      "display_name": "Elk Grove Blvd Neighborhood Market",
      "distance_miles": 5.16,
      "name": "Neighborhood Market",
      "phone": "916-509-3170",
      "store_id": "5683",
      "url": "https://www.walmart.com/store/5683-elk-grove-ca"
    },
    {
      "address": {
        "city": "Elk Grove",
        "country": "US",
        "line1": "10075 Bruceville Rd",
        "line2": null,
        "postal_code": "95757",
        "state": "CA"
      },
      "display_name": "Elk Grove Bruceville Rd Store",
      "distance_miles": 6.8,
      "name": "Walmart",
      "phone": "916-585-7344",
      "store_id": "5848",
      "url": "https://www.walmart.com/store/5848-elk-grove-ca"
    },
    {
      "address": {
        "city": "Sacramento",
        "country": "US",
        "line1": "8270 Delta Shores Cir S",
        "line2": null,
        "postal_code": "95832",
        "state": "CA"
      },
      "display_name": "Sacramento Delta Shores Circle S Supercenter",
      "distance_miles": 6.89,
      "name": "Walmart Supercenter",
      "phone": "916-665-1011",
      "store_id": "2464",
      "url": "https://www.walmart.com/store/2464-sacramento-ca"
    },
    {
      "address": {
        "city": "Rancho Cordova",
        "country": "US",
        "line1": "10655 Folsom Blvd",
        "line2": null,
        "postal_code": "95670",
        "state": "CA"
      },
      "display_name": "Rancho Cordova Supercenter",
      "distance_miles": 8.87,
      "name": "Walmart Supercenter",
      "phone": "916-361-0296",
      "store_id": "2457",
      "url": "https://www.walmart.com/store/2457-rancho-cordova-ca"
    },
    {
      "address": {
        "city": "Sacramento",
        "country": "US",
        "line1": "2700 Marconi Ave",
        "line2": null,
        "postal_code": "95821",
        "state": "CA"
      },
      "display_name": "Sacramento Marconi Ave Neighborhood Market",
      "distance_miles": 9.42,
      "name": "Neighborhood Market",
      "phone": "916-576-6657",
      "store_id": "5982",
      "url": "https://www.walmart.com/store/5982-sacramento-ca"
    },
    {
      "address": {
        "city": "North Highlands",
        "country": "US",
        "line1": "4675 Watt Ave",
        "line2": null,
        "postal_code": "95660",
        "state": "CA"
      },
      "display_name": "North Highlands Supercenter",
      "distance_miles": 11.58,
      "name": "Walmart Supercenter",
      "phone": "916-621-1454",
      "store_id": "4393",
      "url": "https://www.walmart.com/store/4393-north-highlands-ca"
    },
    {
      "address": {
        "city": "West Sacramento",
        "country": "US",
        "line1": "755 Riverpoint Ct",
        "line2": null,
        "postal_code": "95605",
        "state": "CA"
      },
      "display_name": "West Sacramento Supercenter",
      "distance_miles": 12.16,
      "name": "Walmart Supercenter",
      "phone": "916-373-2200",
      "store_id": "3652",
      "url": "https://www.walmart.com/store/3652-west-sacramento-ca"
    },
    {
      "address": {
        "city": "Carmichael",
        "country": "US",
        "line1": "6005 Madison Ave",
        "line2": null,
        "postal_code": "95608",
        "state": "CA"
      },
      "display_name": "Carmichael Neighborhood Market",
      "distance_miles": 12.65,
      "name": "Neighborhood Market",
      "phone": "916-534-1157",
      "store_id": "5981",
      "url": "https://www.walmart.com/store/5981-carmichael-ca"
    }
  ],
  "observed_at_ms": 1790285276460,
  "open_24_hours": false,
  "phone": "916-897-5020",
  "services": [
    {
      "display_name": "Deli",
      "hours": [
        {
          "close": "20:00",
          "closed": false,
          "day": "Sunday",
          "open": "08:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Monday",
          "open": "08:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Tuesday",
          "open": "08:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Wednesday",
          "open": "08:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Thursday",
          "open": "08:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Friday",
          "open": "08:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Saturday",
          "open": "08:00"
        }
      ],
      "name": "DELI",
      "phone": null
    },
    {
      "display_name": "Pharmacy",
      "hours": [
        {
          "close": "18:00",
          "closed": false,
          "day": "Sunday",
          "open": "10:00"
        },
        {
          "close": "19:00",
          "closed": false,
          "day": "Monday",
          "open": "09:00"
        },
        {
          "close": "19:00",
          "closed": false,
          "day": "Tuesday",
          "open": "09:00"
        },
        {
          "close": "19:00",
          "closed": false,
          "day": "Wednesday",
          "open": "09:00"
        },
        {
          "close": "19:00",
          "closed": false,
          "day": "Thursday",
          "open": "09:00"
        },
        {
          "close": "19:00",
          "closed": false,
          "day": "Friday",
          "open": "09:00"
        },
        {
          "close": "18:00",
          "closed": false,
          "day": "Saturday",
          "open": "09:00"
        }
      ],
      "name": "PHARMACY",
      "phone": "916-897-5010"
    },
    {
      "display_name": "Photo Center",
      "hours": [
        {
          "close": "20:00",
          "closed": false,
          "day": "Sunday",
          "open": "10:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Monday",
          "open": "09:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Tuesday",
          "open": "09:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Wednesday",
          "open": "09:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Thursday",
          "open": "09:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Friday",
          "open": "09:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Saturday",
          "open": "09:00"
        }
      ],
      "name": "PHOTO_CENTER",
      "phone": "916-897-5013"
    },
    {
      "display_name": "Walmart Fuel Station",
      "hours": [
        {
          "close": "22:00",
          "closed": false,
          "day": "Sunday",
          "open": "05:00"
        },
        {
          "close": "22:00",
          "closed": false,
          "day": "Monday",
          "open": "05:00"
        },
        {
          "close": "22:00",
          "closed": false,
          "day": "Tuesday",
          "open": "05:00"
        },
        {
          "close": "22:00",
          "closed": false,
          "day": "Wednesday",
          "open": "05:00"
        },
        {
          "close": "22:00",
          "closed": false,
          "day": "Thursday",
          "open": "05:00"
        },
        {
          "close": "22:00",
          "closed": false,
          "day": "Friday",
          "open": "05:00"
        },
        {
          "close": "22:00",
          "closed": false,
          "day": "Saturday",
          "open": "05:00"
        }
      ],
      "name": "GAS_STATION",
      "phone": null
    },
    {
      "display_name": "Garden Center",
      "hours": [],
      "name": "GARDEN_CENTER",
      "phone": null
    },
    {
      "display_name": "Grocery",
      "hours": [],
      "name": "GROCERY",
      "phone": null
    },
    {
      "display_name": "1-Hour Photo Center",
      "hours": [],
      "name": "PHOTO_CENTER_ONE_HOUR",
      "phone": "916-897-5013"
    },
    {
      "display_name": "Financial Services",
      "hours": [
        {
          "close": "22:00",
          "closed": false,
          "day": "Sunday",
          "open": "07:00"
        },
        {
          "close": "22:00",
          "closed": false,
          "day": "Monday",
          "open": "07:00"
        },
        {
          "close": "22:00",
          "closed": false,
          "day": "Tuesday",
          "open": "07:00"
        },
        {
          "close": "22:00",
          "closed": false,
          "day": "Wednesday",
          "open": "07:00"
        },
        {
          "close": "22:00",
          "closed": false,
          "day": "Thursday",
          "open": "07:00"
        },
        {
          "close": "22:00",
          "closed": false,
          "day": "Friday",
          "open": "07:00"
        },
        {
          "close": "22:00",
          "closed": false,
          "day": "Saturday",
          "open": "07:00"
        }
      ],
      "name": "FINANCIAL_SERVICES",
      "phone": "916-897-5020"
    },
    {
      "display_name": "Bakery",
      "hours": [
        {
          "close": "23:00",
          "closed": false,
          "day": "Sunday",
          "open": "06:00"
        },
        {
          "close": "23:00",
          "closed": false,
          "day": "Monday",
          "open": "06:00"
        },
        {
          "close": "23:00",
          "closed": false,
          "day": "Tuesday",
          "open": "06:00"
        },
        {
          "close": "23:00",
          "closed": false,
          "day": "Wednesday",
          "open": "06:00"
        },
        {
          "close": "23:00",
          "closed": false,
          "day": "Thursday",
          "open": "06:00"
        },
        {
          "close": "23:00",
          "closed": false,
          "day": "Friday",
          "open": "06:00"
        },
        {
          "close": "23:00",
          "closed": false,
          "day": "Saturday",
          "open": "06:00"
        }
      ],
      "name": "BAKERY",
      "phone": "916-897-5016"
    },
    {
      "display_name": "Wireless Services",
      "hours": [
        {
          "close": "18:00",
          "closed": false,
          "day": "Sunday",
          "open": "12:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Monday",
          "open": "10:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Tuesday",
          "open": "10:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Wednesday",
          "open": "10:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Thursday",
          "open": "10:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Friday",
          "open": "10:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Saturday",
          "open": "10:00"
        }
      ],
      "name": "WIRELESS_MOBILE",
      "phone": "916-897-5012"
    },
    {
      "display_name": "Liquor",
      "hours": [
        {
          "close": "22:00",
          "closed": false,
          "day": "Sunday",
          "open": "07:00"
        },
        {
          "close": "22:00",
          "closed": false,
          "day": "Monday",
          "open": "07:00"
        },
        {
          "close": "22:00",
          "closed": false,
          "day": "Tuesday",
          "open": "07:00"
        },
        {
          "close": "22:00",
          "closed": false,
          "day": "Wednesday",
          "open": "07:00"
        },
        {
          "close": "22:00",
          "closed": false,
          "day": "Thursday",
          "open": "07:00"
        },
        {
          "close": "22:00",
          "closed": false,
          "day": "Friday",
          "open": "07:00"
        },
        {
          "close": "22:00",
          "closed": false,
          "day": "Saturday",
          "open": "07:00"
        }
      ],
      "name": "LIQUOR",
      "phone": null
    },
    {
      "display_name": ".COM_SERVICES",
      "hours": [
        {
          "close": "20:00",
          "closed": false,
          "day": "Sunday",
          "open": "09:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Monday",
          "open": "09:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Tuesday",
          "open": "09:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Wednesday",
          "open": "09:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Thursday",
          "open": "09:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Friday",
          "open": "09:00"
        },
        {
          "close": "20:00",
          "closed": false,
          "day": "Saturday",
          "open": "09:00"
        }
      ],
      "name": ".COM_SERVICES",
      "phone": null
    },
    {
      "display_name": "GM_PICKUP_CURBSIDE",
      "hours": [],
      "name": "GM_PICKUP_CURBSIDE",
      "phone": null
    },
    {
      "display_name": "SCAN_AND_GO",
      "hours": [],
      "name": "SCAN_AND_GO",
      "phone": null
    },
    {
      "display_name": "SENSORY_FRIENDLY_HOURS_MORNING",
      "hours": [
        {
          "close": "10:00",
          "closed": false,
          "day": "Sunday",
          "open": "08:00"
        },
        {
          "close": "10:00",
          "closed": false,
          "day": "Monday",
          "open": "08:00"
        },
        {
          "close": "10:00",
          "closed": false,
          "day": "Tuesday",
          "open": "08:00"
        },
        {
          "close": "10:00",
          "closed": false,
          "day": "Wednesday",
          "open": "08:00"
        },
        {
          "close": "10:00",
          "closed": false,
          "day": "Thursday",
          "open": "08:00"
        },
        {
          "close": "10:00",
          "closed": false,
          "day": "Friday",
          "open": "08:00"
        },
        {
          "close": "10:00",
          "closed": false,
          "day": "Saturday",
          "open": "08:00"
        }
      ],
      "name": "SENSORY_FRIENDLY_HOURS_MORNING",
      "phone": null
    },
    {
      "display_name": "SERVICE DESK",
      "hours": [
        {
          "close": "20:30",
          "closed": false,
          "day": "Sunday",
          "open": "07:00"
        },
        {
          "close": "20:30",
          "closed": false,
          "day": "Monday",
          "open": "07:00"
        },
        {
          "close": "20:30",
          "closed": false,
          "day": "Tuesday",
          "open": "07:00"
        },
        {
          "close": "20:30",
          "closed": false,
          "day": "Wednesday",
          "open": "07:00"
        },
        {
          "close": "20:30",
          "closed": false,
          "day": "Thursday",
          "open": "07:00"
        },
        {
          "close": "20:30",
          "closed": false,
          "day": "Friday",
          "open": "07:00"
        },
        {
          "close": "20:30",
          "closed": false,
          "day": "Saturday",
          "open": "07:00"
        }
      ],
      "name": "SERVICE_DESK",
      "phone": null
    },
    {
      "display_name": "Subway",
      "hours": [
        {
          "close": "21:00",
          "closed": false,
          "day": "Sunday",
          "open": "08:00"
        },
        {
          "close": "21:00",
          "closed": false,
          "day": "Monday",
          "open": "08:00"
        },
        {
          "close": "21:00",
          "closed": false,
          "day": "Tuesday",
          "open": "08:00"
        },
        {
          "close": "21:00",
          "closed": false,
          "day": "Wednesday",
          "open": "08:00"
        },
        {
          "close": "21:00",
          "closed": false,
          "day": "Thursday",
          "open": "08:00"
        },
        {
          "close": "21:00",
          "closed": false,
          "day": "Friday",
          "open": "08:00"
        },
        {
          "close": "21:00",
          "closed": false,
          "day": "Saturday",
          "open": "08:00"
        }
      ],
      "name": "SUBWAY",
      "phone": null
    },
    {
      "display_name": "Coinstar",
      "hours": [],
      "name": "COINSTAR",
      "phone": null
    },
    {
      "display_name": "ecoATM-Kiosk",
      "hours": [],
      "name": "ECOATM",
      "phone": null
    },
    {
      "display_name": "Minute Key-Kiosk",
      "hours": [],
      "name": "MINUTE_KEY",
      "phone": null
    },
    {
      "display_name": "Redbox-Kiosk",
      "hours": [],
      "name": "REDBOX",
      "phone": "866-733-2693"
    },
    {
      "display_name": "Rug Doctor-Kiosk",
      "hours": [],
      "name": "RUG_DOCTOR",
      "phone": "800-784-3628"
    },
    {
      "display_name": "Flu Shots and Immunizations",
      "hours": [],
      "name": "IMMUNIZATIONS",
      "phone": "916-897-5010"
    },
    {
      "display_name": "Hormonal Contraceptive Prescribing",
      "hours": [],
      "name": "HORMONAL_CONTRACEPTIVE_PRESCRIBING",
      "phone": "425-245-1713"
    },
    {
      "display_name": "Hormonal Contraception Test and Treat",
      "hours": [],
      "name": "HC_TEST_AND_TREAT",
      "phone": "916-897-5010"
    },
    {
      "display_name": "COVID Immunizations",
      "hours": [],
      "name": "COVID_IMMUNIZATIONS",
      "phone": "916-897-5010"
    },
    {
      "display_name": "Grocery Pickup and Delivery",
      "hours": [],
      "name": "GROCERY_PICKUP_DELIVERY",
      "phone": null
    }
  ],
  "source_url": "https://www.walmart.com/store/3081",
  "store_id": "3081",
  "type": "STORE"
}
```

### Suggest

- Capability: `products/suggest`
- Description: Search suggestions (typeahead) for a partial term, as Walmart's search box shows them.
- Instructions: Expand a vague shopping term into the queries Walmart itself proposes, then call `search`.
- Cost: 5 credits per call
- Capability file: [Suggest](https://firecrawl.dev/alexandria/agents/providers/walmart-com/products/suggest)

Accepted options:
- `num` (number): Maximum number of suggestions requested. Example: `8`
- `term` (string, required): term Example: `<term>`

Response schema example:
```json
{
  "observed_at_ms": 1790285264342,
  "source_url": "https://www.walmart.com/typeahead/v3/complete?term=coffee&cat=0&num=8",
  "suggestions": [
    {
      "image_url": "https://i5.walmartimages.com/asr/6bfd2db3-26cf-4fba-953a-cb44afe25503.b7ef549a72ab0dcd3ad41615c823f651.jpeg",
      "query": "coffee",
      "search_url": "https://www.walmart.com/search?q=coffee",
      "type": "QUERY"
    },
    {
      "image_url": "https://i5.walmartimages.com/asr/60fb541a-0240-467c-9859-0dc7fb000c4d.efd618166d0ecae88ad53d278cce7ab0.jpeg",
      "query": "coffee creamer",
      "search_url": "https://www.walmart.com/search?q=coffee%20creamer",
      "type": "QUERY"
    },
    {
      "image_url": "https://i5.walmartimages.com/asr/58a85a1a-a7c6-4340-b23f-7e3040fe3a82.9bfe652540ee75919b2f687ebcd098c7.jpeg",
      "query": "coffee maker",
      "search_url": "https://www.walmart.com/search?q=coffee%20maker",
      "type": "QUERY"
    },
    {
      "image_url": "https://i5.walmartimages.com/asr/6a77c2cd-65be-4a00-ab17-0f2300c0f0fc.cc47256b448fa03713f04b6302eb212d.jpeg",
      "query": "coffee pods",
      "search_url": "https://www.walmart.com/search?q=coffee%20pods",
      "type": "QUERY"
    },
    {
      "image_url": "https://i5.walmartimages.com/dfw/63fd9f59-d78b/4f046dd9-84a8-4813-b1f7-27e5d5f71f8b/v1/glass_icon.png",
      "query": "coffee mugs",
      "search_url": "https://www.walmart.com/search?q=coffee%20mugs",
      "type": "QUERY"
    },
    {
      "image_url": "https://i5.walmartimages.com/asr/e25525ee-ce92-4ddc-b39e-96c8a012138e_1.e3622915ff725f21c3555c5be96188ab.jpeg",
      "query": "coffee table",
      "search_url": "https://www.walmart.com/search?q=coffee%20table",
      "type": "QUERY"
    },
    {
      "image_url": "https://i5.walmartimages.com/asr/bb7746ac-9770-4cc2-a771-3cca32789a48.adff27869b1ad583015e473609563b32.jpeg",
      "query": "coffee cups",
      "search_url": "https://www.walmart.com/search?q=coffee%20cups",
      "type": "QUERY"
    },
    {
      "image_url": "https://i5.walmartimages.com/asr/95ef678d-ac2a-4baf-84c9-0c18d1c2e8ea.16b1e0a0ec4c66b128db9f14522095be.jpeg",
      "query": "coffee pot",
      "search_url": "https://www.walmart.com/search?q=coffee%20pot",
      "type": "QUERY"
    }
  ],
  "term": "coffee"
}
```
