# Walmart Scraper: Products, Prices, Reviews & Price Tracker (`panix/walmart-scraper`) Actor

Scrape Walmart products and reviews without login: price, was-price, seller, stock, UPC, specs, every variant with its price, rating breakdown, store aisle, pickup and delivery. From searches, categories, deals, item IDs or links. Price tracking for sellers, brands and price monitoring.

- **URL**: https://apify.com/panix/walmart-scraper.md
- **Developed by:** [PANIX AI LAB](https://apify.com/panix) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Walmart Scraper: products, prices, reviews and price tracking

Track Walmart prices, rollbacks and stock, or research products to sell. Give it a search, a category, a deals page or item IDs and get price, was-price, ratings and every variant as clean rows.

- **Every variant with its own price and stock**, plus rollback and clearance flags, UPC, specifications and "bought since yesterday" counts.
- **Price tracking on a schedule**: unchanged products in price-tracking mode are free, so you pay for the changes.
- **Customer reviews as separate rows** when you need them. No Walmart account, cookies or API key.

**Try it now:** the input is already filled in (a search for "air fryer", 10 products). Click **Start** and the results appear in a table you can export to Excel, CSV or JSON. That example run costs a few cents, which the $5 of free monthly credit on Apify's free plan covers.

**Price:** from **$2.00 per 1,000 products**, and you pay only for results you get. The full price table is in the Pricing section below.

### Example result

One result, shortened. Every field is described in the Output section below.

```json
{
  "usItemId": "17284765594",
  "title": "Chefman TurboFry 2-Quart Digital Air Fryer, Compact Design for Quick Meals, Dishwasher-Safe – Black",
  "brand": "Chefman",
  "price": 39.99,
  "currency": "USD",
  "wasPrice": 49.99,
  "discountPercent": 20.0,
  "isRollback": false,
  "isClearance": false,
  "rating": 4.5,
  "reviewsCount": 3900,
  "ratingBreakdown": {
    "5": 2926,
    "4": 480,
    "3": 213,
    "2": 73,
    "1": 208
  },
  "recommendedPercent": 90
}
```

### What you get

Scrape Walmart.com products from search results, category pages, deals pages, item ID lists and product links into clean rows: price, was-price, unit price, rollback and clearance flags, seller, stock, UPC, specifications, description, **every variant with its own price and stock**, star breakdown, Walmart's review highlights, "bought since yesterday" counts, pickup and delivery options, store aisle and return policy. Add **customer reviews** (one row per review) and **price-change tracking** in the same run. It reads Walmart's public pages, so you need **no Walmart account, no cookies and no API key**.

You pay only for what you get. Products left out by your filters, duplicates, item IDs Walmart no longer has and unchanged products in price-tracking mode are free.

### What it does

1. Searches Walmart for your search terms (or opens the search, category, deals, seller and review links you paste), page by page.
2. Opens each product page (unless you turn that off) and reads the price, seller, stock, variants, details and review summary.
3. Applies your price, rating, review-count, seller and stock filters.
4. Optionally reads each product's customer reviews: newest, most helpful, lowest-rated first, only 1-2 star complaints, only verified purchases.
5. Delivers one row per product (and per review) to the dataset (JSON, CSV, Excel, Google Sheets, API), with a status line per input and a run summary.
6. With price tracking on, compares every product with the last run and adds what changed.

### Who uses it

- **Brands and marketplace sellers**: watch competitors' prices, rollbacks, stock and sellers on Walmart every day, and see who holds the offer (Walmart.com or a marketplace seller).
- **Price monitoring and repricing tools**: a fixed item ID list on a schedule, with only changed prices delivered.
- **Amazon and Walmart arbitrage, dropshipping and product research**: prices, UPCs, ratings and "bought since yesterday" counts to match products across stores.
- **Retail and CPG analysts**: category and deals pages, unit prices, private labels, assortment and variants.
- **Review and sentiment analysis**: thousands of reviews per product with stars, dates, verified-purchase flags and the reviewed variant, plus Walmart's own review highlights.
- **Catalog and comparison sites**: titles, descriptions, specifications, images, UPCs and variants.
- **AI agents and RAG pipelines**: review highlights and review text, callable from the Apify API or MCP server.

### Why this Walmart scraper

- **Products, details, variants and reviews in one Actor.** No separate search, detail and review scrapers. Each product row carries all its variants (size, color, pack) with their item IDs, prices and stock, read from the same page at no extra cost.
- **Price and stock tracking built in.** Turn on *Track price and stock changes* and every row gets a `changes` field with the price before, the change in %, stock, rating, review count and seller before. *Only changed products* delivers just the changes, and unchanged products are free.
- **Filters that save money.** Price range, minimum stars, minimum reviews, *only sold by Walmart*, *only in stock* and *no sponsored results*. Filtered products are never charged; price and seller filters are also sent to Walmart, so fewer pages are read.
- **Review filters.** Newest, oldest, most helpful, highest or lowest rating first, only chosen star ratings (for example 1 and 2 stars), only verified purchases. Each review row says which variant was reviewed.
- **Sales signals as numbers.** `boughtRecently` (5K+ = 5000), rollback, clearance and best-seller flags, star breakdown as counts, other sellers count.
- **Store data.** Store aisle, pickup and delivery-from-store availability, shipping date and fulfillment type, with the location the prices are for on every row.
- **Reliable on a hard site.** Walmart blocks many scrapers. Blocked requests move to a new IP right away, and pages blocked several times are retried on US residential IPs at no extra cost to you. Unreadable products from a search are still delivered from the search data at the lower basic price, never dropped silently.
- **Fast and light.** Plain HTTP, no browser, 512 MB. In our runs 50 products with full pages took about 26 seconds, 300 about 2.5 minutes, 500 search results without product pages 30 seconds and 300 reviews 48 seconds.

### Coming from another Walmart scraper?

| Common problem in this category | How this Actor handles it |
|---|---|
| Search, details and reviews need three different scrapers | All three in one run, one dataset (`dataType` tells rows apart) |
| Variants cost one paid request each | All variants with prices and stock are in the product row for free |
| Blocked runs fail or return empty rows | New IP per blocked request, residential retry included, card data as fallback |
| Paying again for unchanged prices on every monitoring run | *Only changed products*: unchanged products are free |
| Sponsored placements mixed into results | Marked `isSponsored`; one switch leaves them out |
| Only the star average, no breakdown | Star counts, written-review count, Walmart's review highlights and aspect scores |
| Charged for items that no longer exist | Missing item IDs come back as free error rows |
| Reviews without filters | Sort order, star filter and verified-only filter |

### How to use it

1. Type **Search terms** (for example `air fryer`), paste **Walmart URLs** (product links, search links with your own filters, `/browse/` or `/cp/` category pages, `/shop/deals`, seller pages, `/reviews/product/` links) or paste **Walmart item IDs**.
2. Set **Max products per search** and, if you want, filters.
3. For reviews, set **Reviews per product** (for example 100) and the review order and filters.
4. Click **Start**, then download the dataset or connect it to Google Sheets, Make, n8n, Zapier or your code.

For daily price monitoring: paste your item IDs, turn on **Track price and stock changes** and **Only changed products**, give the list a **Tracker name**, and create a schedule (Schedules -> Create new).

### Input examples

Search, 100 products with full pages:

```json
{ "searchTerms": ["air fryer", "coffee maker"], "maxResultsPerSearch": 100 }
```

Category and deals pages:

```json
{
  "startUrls": [
    "https://www.walmart.com/browse/pets/adult-dog-food/5440_202072_5056877_8328112",
    "https://www.walmart.com/shop/deals"
  ],
  "maxResultsPerSearch": 200
}
```

Best sellers sold by Walmart itself, $20-$80, at least 4.3 stars and 100 reviews, in stock, no ads:

```json
{
  "searchTerms": ["bluetooth speaker"],
  "sortBy": "best_seller", "minPrice": 20, "maxPrice": 80, "minRating": 4.3, "minReviews": 100,
  "onlySoldByWalmart": true, "onlyInStock": true, "includeSponsored": false, "maxResultsPerSearch": 50
}
```

Products with their newest 1- and 2-star reviews (complaint mining):

```json
{
  "itemIds": ["20877373221", "10713560175"],
  "maxReviewsPerProduct": 200,
  "reviewsSort": "newest",
  "reviewsRatings": ["1", "2"]
}
```

Reviews only, from a review page link, verified purchases:

```json
{ "startUrls": ["https://www.walmart.com/reviews/product/18200554428"], "maxReviewsPerProduct": 500, "reviewsVerifiedOnly": true }
```

Daily price tracker that delivers only changes:

```json
{
  "itemIds": ["20877373221", "6769862672", "18200554428"],
  "trackChanges": true,
  "onlyChangedProducts": true,
  "monitorName": "my-competitors"
}
```

Cheap list of search results only (no product pages):

```json
{ "searchTerms": ["yoga mat"], "scrapeProductDetails": false, "maxResultsPerSearch": 500 }
```

### Output

One row per product. A real row from a run (lists shortened):

```json
{
  "usItemId": "17284765594",
  "title": "Chefman TurboFry 2-Quart Digital Air Fryer, Compact Design for Quick Meals, Dishwasher-Safe – Black",
  "brand": "Chefman",
  "price": 39.99,
  "currency": "USD",
  "wasPrice": 49.99,
  "discountPercent": 20.0,
  "savingsAmount": 10.0,
  "priceDisplay": "Now $39.99",
  "minPrice": 39.99,
  "maxPrice": 39.99,
  "isRollback": false,
  "isClearance": false,
  "isReducedPrice": true,
  "rating": 4.5,
  "reviewsCount": 3900,
  "reviewsWithTextCount": 873,
  "ratingBreakdown": {
    "5": 2926,
    "4": 480,
    "3": 213,
    "2": 73,
    "1": 208
  },
  "recommendedPercent": 90,
  "reviewSummary": {
    "highlights": [
      {
        "topic": "instructions",
        "label": "Cooking guide",
        "summary": "Offers clear, simple directions but lacks detailed cook times.",
        "polarity": "Neutral"
      },
      {
        "topic": "chicken cooking",
        "label": "Crispy chicken cooking",
        "summary": "The fryer delivers fast, even results and keeps meat moist.",
        "polarity": "Positive"
      }
    ],
    "aspects": [
      {
        "name": "Size",
        "mentions": 119
      },
      {
        "name": "Ease Of Use",
        "mentions": 100
      }
    ],
    "featureScores": [
      {
        "name": "Crispiness",
        "score": 4.4,
        "polarity": "Positive"
      },
      {
        "name": "Build quality",
        "score": 5.0,
        "polarity": "Positive"
      }
    ]
  },
  "badges": [
    "100+ bought since yesterday",
    "Overall pick"
  ],
  "boughtRecently": 100,
  "boughtRecentlyText": "100+ bought since yesterday",
  "availability": "IN_STOCK",
  "inStock": true,
  "orderLimit": 6145,
  "sellerName": "Chefman Direct",
  "sellerId": "AFD9EBBFBAAC426382D4937182B3B72E",
  "sellerType": "EXTERNAL",
  "isSoldByWalmart": false,
  "sellerRating": 4.6286836935167,
  "sellerReviewsCount": 3595,
  "sellerUrl": "https://www.walmart.com/global/seller/101020449",
  "fulfillmentType": "FC",
  "isWalmartFulfilled": true,
  "offerType": "ONLINE_AND_STORE",
  "shippingDate": "2026-11-08T22:59:00.000Z",
  "pickupAvailable": false,
  "deliveryFromStoreAvailable": false,
  "fulfillmentText": [
    "Free shipping, arrives by tomorrow to Sacramento, 95829",
    "Pickup not available at Sacramento Supercenter"
  ],
  "fulfillmentOptions": [
    {
      "type": "SHIPPING",
      "availability": "IN_STOCK",
      "badge": "Tomorrow",
      "date": "2026-11-08T22:59:00.000Z",
      "location": "Sacramento, 95829",
      "lowStock": null,
      "price": null
    },
    {
      "type": "PICKUP",
      "availability": "OUT_OF_STOCK",
      "badge": null,
      "date": null,
      "location": "Sacramento Supercenter",
      "lowStock": null,
      "price": null
    },
    "..."
  ],
  "location": {
    "postalCode": "95829",
    "city": "Sacramento",
    "state": "CA",
    "storeId": "3081"
  },
  "returnPolicy": "Free 90-day returns",
  "returnWindowDays": 90,
  "freeReturns": true,
  "condition": "New",
  "upc": "810170924460",
  "modelNumber": "RJ38-2D-BLACK",
  "manufacturerProductId": "RJ38-2D-BLACK",
  "productType": "Air Fryers",
  "categoryPath": [
    "Services",
    "Immersive Shopping Suite",
    "..."
  ],
  "categoryPathIds": "0:6163033:2795380:4874644",
  "shortDescription": "The Chefman TurboFry® Touch 2 Qt. Air Fryer is your one-stop appliance for extra-crispy snacks without added fat. Air fry quickly using almost no oil; with c...",
  "description": "- FAST AND EASY: This small air fryer is perfect for a batch of fried chicken, French fries, onion rings, and more! The touch screen display can customize yo...",
  "highlights": {
    "Volume capacity": "2 qt",
    "Brand": "Chefman",
    "Watts": "1000 W",
    "Number of baskets": "1",
    "Cooking appliance functions": "Air Fry"
  },
  "specifications": {
    "Volume capacity": "2 qt",
    "Brand": "Chefman",
    "Watts": "1000 W",
    "Number of baskets": "1",
    "Cooking appliance functions": "Air Fry"
  },
  "warnings": {
    "WARNING - California Proposition 65": "Cancer and Reproductive Harm – www.P65Warnings.ca.gov",
    "State Chemical Disclosure": "None"
  },
  "mainImage": "https://i5.walmartimages.com/seo/Chefman-TurboFry-2-Quart-Digital-Air-Fryer-Compact-Design-for-Quick-Meals-Dishwasher-Safe-Black_bd65913f-db6c-446e-84bf-dc9d...",
  "images": [
    "https://i5.walmartimages.com/seo/Chefman-TurboFry-2-Quart-Digital-Air-Fryer-Compact-Design-for-Quick-Meals-Dishwasher-Safe-Black_bd65913f-db6c-446e-84bf-dc9d573ee930.155f1ee4d3b140dba15f96ce403d9cc0.jpeg",
    "https://i5.walmartimages.com/asr/343368fa-053e-4457-84e8-c649e0d373d7.d3b340f4e33a2571f37cc88c6d98bb83.jpeg",
    "..."
  ],
  "variantDimensions": [
    "Actual Color"
  ],
  "variantsCount": 4,
  "variants": [
    {
      "usItemId": "17284765594",
      "productId": "6RLXP19SNM07",
      "attributes": {
        "Actual Color": "Black"
      },
      "price": 39.99,
      "wasPrice": 49.99,
      "availability": "IN_STOCK",
      "inStock": true,
      "url": "https://www.walmart.com/ip/Chefman-TurboFry-2-Quart-Digital-Air-Fryer-Compact-Design-for-Quick-Meals-Dishwasher-Safe-Black/17284765594"
    },
    {
      "usItemId": "16975920570",
      "productId": "415BY75KTJDC",
      "attributes": {
        "Actual Color": "Grey"
      },
      "price": 39.99,
      "wasPrice": 49.99,
      "availability": "IN_STOCK",
      "inStock": true,
      "url": "https://www.walmart.com/ip/Chefman-TurboFry-2-Quart-Digital-Air-Fryer-Compact-Design-for-Quick-Meals-Dishwasher-Safe-Grey/16975920570"
    },
    "..."
  ],
  "productId": "6RLXP19SNM07",
  "parentProductId": "4GEQV5M7YV4K",
  "brandUrl": "https://www.walmart.com/search?q=Chefman&facet=brand:Chefman",
  "url": "https://www.walmart.com/ip/Chefman-TurboFry-2-Quart-Digital-Air-Fryer-Compact-Design-for-Quick-Meals-Dishwasher-Safe-Black/17284765594",
  "searchTerm": "air fryer",
  "searchPosition": 7,
  "isSponsored": false,
  "source": "search",
  "input": "search 'air fryer'",
  "changes": null,
  "dataType": "product",
  "scrapedAt": "2026-11-07T16:49:18Z"
}
```

A review row:

```json
{
  "reviewId": "447260793",
  "usItemId": "20877373221",
  "productTitle": "Pedigree Complete Nutrition Adult Steak & Vegetable Flavor Dry Dog Food, 40 lb Bag",
  "rating": 2,
  "text": "After order advised that unavailable, but no option to  update selection",
  "date": "2026-11-04",
  "dateText": "11/4/2026",
  "reviewerName": "WalmartCustomer",
  "isVerifiedPurchase": true,
  "isIncentivized": true,
  "badges": [
    "Verified Purchase",
    "Incentivized Review"
  ],
  "helpfulVotes": 0,
  "notHelpfulVotes": 0,
  "reviewedItemId": "19045601703",
  "reviewedVariant": {
    "Size": "40 lbs"
  },
  "sellerName": "Walmart.com",
  "language": "English",
  "reviewsSort": "newest",
  "productUrl": "https://www.walmart.com/ip/20877373221",
  "input": "reviews 20877373221",
  "dataType": "review",
  "scrapedAt": "2026-11-07T16:50:03Z"
}
```

With price tracking on, `changes` looks like this:

```json
"changes": {
  "isNew": false, "changed": true, "previousCheckAt": "2026-11-06T07:00:12Z",
  "priceBefore": 29.97, "priceChange": -4.0, "priceChangePercent": -13.35,
  "inStockBefore": true, "ratingBefore": 4.7, "reviewsCountBefore": 29102, "sellerBefore": "Walmart.com",
  "changedFields": ["price", "reviewsCount"]
}
```

#### Main fields

| Field | What it is |
|---|---|
| `usItemId`, `productId`, `parentProductId`, `url` | Walmart item ID (the number in the product link), Walmart's product IDs, link |
| `title`, `brand`, `upc`, `modelNumber`, `manufacturerProductId` | Product name, brand and codes for matching with other stores |
| `price`, `wasPrice`, `discountPercent`, `savingsAmount`, `priceDisplay` | Current price in USD, the struck-through price, discount |
| `unitPrice`, `unitPriceText`, `minPrice`, `maxPrice` | Price per unit (e.g. "3.7 ¢/oz") and the variant price range |
| `isRollback`, `isClearance`, `isReducedPrice`, `badges` | Walmart's deal flags and badges ("Rollback", "Best seller", "Overall pick") |
| `rating`, `reviewsCount`, `reviewsWithTextCount`, `ratingBreakdown` | Stars, number of ratings, written reviews, count per star |
| `reviewSummary` | Walmart's review highlights, most-mentioned aspects and aspect scores |
| `boughtRecently`, `boughtRecentlyText` | "5K+ bought since yesterday" as a number and as shown |
| `availability`, `inStock`, `orderLimit` | Stock status, in stock yes/no, max per order |
| `sellerName`, `sellerId`, `sellerType`, `isSoldByWalmart`, `sellerRating`, `otherOffersCount` | Who sells it, marketplace seller rating, number of other sellers |
| `fulfillmentType`, `isWalmartFulfilled`, `shippingDate`, `pickupAvailable`, `deliveryFromStoreAvailable`, `fulfillmentOptions`, `fulfillmentText` | Shipping, pickup and delivery options |
| `storeAisle`, `location` | Aisle in the store and the location (ZIP, city, store) the prices are for |
| `returnPolicy`, `returnWindowDays`, `freeReturns`, `condition`, `warranty` | Returns, condition and warranty |
| `categoryPath`, `productType`, `shortDescription`, `description`, `highlights`, `specifications` | Category and product details |
| `ingredients`, `nutritionFacts`, `directions`, `warnings` | Grocery, pet and health details when Walmart shows them |
| `mainImage`, `images` | Image links |
| `variants`, `variantsCount`, `variantDimensions` | Every variant with item ID, attributes, price, was-price and stock |
| `searchTerm`, `searchPosition`, `isSponsored`, `source`, `input` | Where the product came from |
| `changes` | Price tracking result (see above) |
| `dataType` | `product`, `search-result` (product pages off, or a product page could not be read), `review` or `error` (free row for an item Walmart does not have) |

Review rows have `reviewId`, `usItemId`, `productTitle`, `rating`, `title`, `text`, `date`, `reviewerName` (the public nickname), `isVerifiedPurchase`, `isIncentivized` (reviewer got the product free), `helpfulVotes`, `notHelpfulVotes`, `photos`, `reviewedItemId`, `reviewedVariant`, `sellerName`, `responses` and `syndicationSource`.

The Output tab has views for **Products**, **Price, seller and delivery**, **Catalog**, **Reviews** and **Price tracking**. The key-value store has `INPUTS` (one status line per input) and `SUMMARY` (totals, products left out per filter, request statistics).

### Pricing

Pay per event, no monthly fee:

| Event | Free plan | Starter (Bronze) | Scale (Silver) | Business (Gold) and up |
|---|---|---|---|---|
| Product with its product page read (per 1,000) | $3.00 | $2.50 | $2.20 | $2.00 |
| Product, search data only (*Read product pages* off, per 1,000) | $0.60 | $0.50 | $0.45 | $0.40 |
| Review (per 1,000) | $0.50 | $0.40 | $0.35 | $0.30 |
| Actor start (per run, per GB of memory) | $0.001 | $0.001 | $0.001 | $0.001 |

Free: products left out by filters, duplicates, sponsored results you turned off, item IDs Walmart no longer has (error rows), unchanged products in *Only changed products* mode, and failed inputs. Variants, review highlights, residential retries and price tracking cost nothing extra. With the default 512 MB a run pays one start event. Set a spending limit on the run and the Actor stops before it.

Examples on the Starter plan: 1,000 products with full pages cost $2.50 plus $0.001; 50 products with 100 reviews each cost $0.125 + $2.00; a daily tracker of 200 items where 15 prices changed costs $0.039.

### Use it from code, n8n, Make, Zapier and AI agents

Python ([apify-client](https://pypi.org/project/apify-client/) 3.x):

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("panix/walmart-scraper").call(run_input={
    "searchTerms": ["air fryer"],
    "maxResultsPerSearch": 50,
})
for row in client.dataset(run.default_dataset_id).iterate_items():
    print(row["usItemId"], row["price"], row["sellerName"], row["inStock"])
```

JavaScript:

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('panix/walmart-scraper').call({ itemIds: ['20877373221'], maxReviewsPerProduct: 50 });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.filter((r) => r.dataType === 'review').map((r) => [r.rating, r.date, r.text]));
```

One HTTP call that runs the Actor and returns the rows (n8n HTTP Request node, Make HTTP module, any script):

```
POST https://api.apify.com/v2/acts/panix~walmart-scraper/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>
Content-Type: application/json

{"searchTerms": ["air fryer"], "maxResultsPerSearch": 10}
```

n8n, Make and Zapier also have Apify apps: choose **Run Actor**, pick `panix/walmart-scraper`, paste the input JSON, then read the dataset items. AI agents can call it through the Apify MCP server (`https://mcp.apify.com`).

### FAQ

**Do I need a Walmart account or API key?** No. The Actor reads the product, search and review pages Walmart shows to every visitor. No login, cookies or Walmart API key.

**Where do I find a Walmart item ID?** It is the number at the end of a product link: `walmart.com/ip/Pedigree-.../20877373221` has the item ID `20877373221`. You can also paste the whole link.

**Which price is `price`?** The price Walmart.com shows on the product page for its online store. `wasPrice` is the struck-through price next to it. Prices, pickup and aisle are for the location in `location` (Walmart's default for visitors, currently Sacramento, CA, store 3081).

**Can I get prices for my ZIP code or my local store?** Not yet. Walmart's store picker runs in the browser, and the Actor reads pages without one, so every row shows Walmart's default location. Online prices are the same for most items nationwide; grocery and some in-store items can differ by store.

**How does price tracking work?** The Actor stores each product's last price, stock, rating, review count and seller in a named key-value store in your account (`walmart-scraper-monitors`, one record per tracker name). The next run with the same tracker name compares and fills `changes`. With *Only changed products* it delivers only products whose price, stock or seller changed, plus products seen for the first time; the others are free.

**How many products per search?** Walmart shows up to 25 pages per search or category, usually 40-60 products per page (searches often end earlier). Use several search terms, category links or sort orders to get more.

**How many reviews can I get?** As many as Walmart lists for the product (10 per page, thousands for popular products). Reviews without text are not listed by Walmart's review pages.

**Why is a row `search-result` when product pages are on?** Walmart blocked that product page on every retry. The row is delivered from the search card (title, price, rating, seller, stock) and charged at the basic price, and the item ID is listed in `SUMMARY.failedProducts`.

### Limits

- walmart.com (US) only; walmart.ca and walmart.com.mx are not supported yet.
- Public pages only: no seller contact data, no order or account data.
- Brand pages (`/brand/...`) are not lists of products; use a search link with a brand filter instead.
- Walmart's search order and sponsored placements change between visits. For monitoring, track a fixed item ID list.
- Walmart changes its pages and blocks single IPs at times; the Actor moves blocked requests to new IPs and retries. If a field stops filling, open an issue.
- Results come in the order pages finish, not in search order; sort by `searchPosition`.

### Data and legal

The Actor collects product information and customer reviews that Walmart shows to every visitor. Seller names are business names. Review rows include the reviewer's public nickname as shown on Walmart; no contact data is collected. You are responsible for using the data lawfully, including Walmart's terms and data protection laws such as the GDPR where they apply. This Actor is not affiliated with Walmart.

### Support

Open an issue on the Actor's **Issues** tab with the run ID; it is answered quickly. Feature requests are welcome.

# Actor input Schema

## `searchTerms` (type: `array`):

Words you would type in Walmart's search box (e.g. "air fryer"). Each term is its own search. You can also paste walmart.com links here.

## `startUrls` (type: `array`):

Product links (/ip/...), search links with your own filters and sorting (/search?q=...), category pages (/browse/... or /cp/...), deals and shop pages (/shop/deals), seller pages and review pages (/reviews/product/...). Filters already in a link are kept.

## `itemIds` (type: `array`):

Walmart item numbers, the number at the end of a product link (walmart.com/ip/.../20877373221). Good for price tracking of a fixed list.

## `maxResultsPerSearch` (type: `integer`):

Products to deliver for each search term or list link. Walmart shows up to 25 pages of about 40-60 products per search or category.

## `maxResults` (type: `integer`):

Stop the whole run after this many products (0 = no limit). Reviews are not counted. You can also set a spending limit on the run.

## `scrapeProductDetails` (type: `boolean`):

On: every product's page is read for the seller, stock, UPC, specifications, description, all variants with their own prices, rating breakdown, Walmart's review highlights, pickup and delivery options, store aisle and return policy. Off: only the search-card data (title, price, was-price, rating, reviews, badges, seller, stock), at a much lower price.

## `sortBy` (type: `string`):

Order of search and category results (links that already have a sort keep it).

## `minPrice` (type: `number`):

Leave out products below this price.

## `maxPrice` (type: `number`):

Leave out products above this price.

## `minRating` (type: `number`):

Leave out products rated below this (e.g. 4 or 4.5).

## `minReviews` (type: `integer`):

Leave out products with fewer reviews than this.

## `onlySoldByWalmart` (type: `boolean`):

Only products sold by Walmart.com itself, not by marketplace sellers.

## `onlyInStock` (type: `boolean`):

Leave out products Walmart shows as out of stock.

## `includeSponsored` (type: `boolean`):

Also deliver paid placements from search results (marked isSponsored). Walmart mixes them into every page; turn this off for organic results only.

## `maxReviewsPerProduct` (type: `integer`):

Also deliver up to this many customer reviews for every product (one row per review, after its product). 0 = no reviews. Review page links (/reviews/product/...) deliver 100 reviews when this is 0.

## `reviewsSort` (type: `string`):

Which reviews come first.

## `reviewsRatings` (type: `array`):

Only reviews with these stars, e.g. \["1", "2"] for complaints. Empty = all ratings.

## `reviewsVerifiedOnly` (type: `boolean`):

Only reviews from customers Walmart verified as buyers.

## `trackChanges` (type: `boolean`):

Compare every product with the last run that used the same tracker name and add a changes field: price before and after, change in %, stock, rating, review count and seller before.

## `onlyChangedProducts` (type: `boolean`):

With tracking: deliver only products whose price, stock or seller changed since the last run (plus products seen for the first time). Unchanged products are left out and not charged.

## `monitorName` (type: `string`):

Name of the memory used by change tracking. Use a different name for each schedule or product list.

## `maxConcurrency` (type: `integer`):

Walmart pages read at the same time.

## `useResidentialFallback` (type: `boolean`):

When Walmart's bot check blocks a page several times on the main proxy, retry it on US residential IPs (included in the price).

## `proxyConfiguration` (type: `object`):

Apify datacenter proxy works for Walmart's public pages and is the default.

## Actor input object example

```json
{
  "searchTerms": [
    "air fryer"
  ],
  "maxResultsPerSearch": 10,
  "maxResults": 0,
  "scrapeProductDetails": true,
  "sortBy": "best_match",
  "onlySoldByWalmart": false,
  "onlyInStock": false,
  "includeSponsored": true,
  "maxReviewsPerProduct": 0,
  "reviewsSort": "newest",
  "reviewsVerifiedOnly": false,
  "trackChanges": false,
  "onlyChangedProducts": false,
  "monitorName": "default",
  "maxConcurrency": 10,
  "useResidentialFallback": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Delivered products and reviews. Products left out by filters, duplicates and unchanged products (only-changed mode) are not in the dataset and are not charged. Item IDs that Walmart no longer has appear as free error rows.

## `inputs` (type: `string`):

Pages read, products seen and delivered, reviews delivered, and why each search or link stopped.

## `summary` (type: `string`):

Totals, charged events, products left out per filter, request statistics and warnings.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchTerms": [
        "air fryer"
    ],
    "maxResultsPerSearch": 10,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("panix/walmart-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchTerms": ["air fryer"],
    "maxResultsPerSearch": 10,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("panix/walmart-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchTerms": [
    "air fryer"
  ],
  "maxResultsPerSearch": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call panix/walmart-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,panix/walmart-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/M3lpc4o1O12qpfH3F/builds/zXdx9dNEep16W5hHh/openapi.json
