# Walmart Product & Reviews Scraper (`mrdoe/walmart-product-reviews-scraper`) Actor Scrape Walmart products and customer reviews with structured data including product titles, prices, ratings, review counts, availability, product URLs, and review details for e-commerce research, price monitoring, and competitor analysis. - **URL**: https://apify.com/mrdoe/walmart-product-reviews-scraper.md - **Developed by:** [MrDoe](https://apify.com/mrdoe) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.80 / 1,000 results 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? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### What does Walmart Product & Reviews Scraper do? **Walmart Product & Reviews Scraper** extracts data from [Walmart.com](https://www.walmart.com) - product search results, full category listings, deep product details, every third-party seller offer, and paginated customer reviews - **anonymously, no login, no Walmart account, no API key**. Five operations live in one actor: pick one per run, hand it a single item or a batch, and get clean, flat rows back. ### Why use this Actor? - **Price tracking** - schedule `productDetails` or `search` on a cron and diff consecutive runs to catch price drops, rollbacks, and restocks. - **Competitor/catalog mapping** - `productsByCategory` gives you a full category listing (price, rating, seller) for assortment and share-of-shelf analysis. - **Buy-box / marketplace intelligence** - `productOffers` returns every third-party seller's offer for a product as its own row (seller, price, shipping, WFS, return policy) - see exactly who's undercutting you. - **Voice-of-customer research** - `productReviews` returns full review text, rating, verified-purchase status, and helpful-vote counts, paginated. - **Batch, one start fee** - pass a list of product IDs, search queries, or category IDs and one run covers all of them. ### How to use it 1. Pick an **Operation**: Product Search, Products by Category, Product Details, Product Offers, or Product Reviews. 2. Fill the matching field: - **Search** → `query` (e.g. `coffee maker`) or `queries` for a batch. - **Products by Category** → `categoryId` (e.g. `3944` = Electronics, or `3951` = Laptops) or `categoryIds` for a batch. You can paste the bare leaf ID or the full underscore-joined breadcrumb path - see [Category ID format](#category-id-format) below. - **Product Details / Offers / Reviews** → `productId` or `productIds` for a batch. 3. Optionally set `domain` (`us`/`ca`), `sortBy`, price filters, or the review-specific fields. 4. Click **Start**. Batch fields (`queries`/`categoryIds`/`productIds`) win over their singular counterparts when filled; duplicates and blanks are dropped automatically. There is no page cap - `search`, `productsByCategory`, and `productReviews` always paginate through to the site's own last reported page for each item. Batch a lot of items and this can produce a very large run; that's intentional, not a bug. Use `maxItems` (see below) if you want to bound total spend instead. ### Input | Field | Type | Description | | ---------------------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `operation` | string (required) | One of: `search`, `productsByCategory`, `productDetails`, `productOffers`, `productReviews`. | | `query` / `queries` | string / array | Search keyword(s). Used by `search`. | | `categoryId` / `categoryIds` | string / array | Walmart category ID(s). Used by `productsByCategory`. | | `productId` / `productIds` | string / array | Numeric `usItemId` or alphanumeric product ID(s). Used by `productDetails`, `productOffers`, `productReviews`. | | `domain` | string | `us` (walmart.com) or `ca` (walmart.ca). Defaults to `us`. | | `sortBy` | string | `best_match`, `price_low`, `price_high`, `best_seller`, `top_rated`. Applies to `search`/`productsByCategory`. | | `minPrice` / `maxPrice` | integer | Price filters. Applies to `search`/`productsByCategory`. | | `storeId` / `state` | string | Localize availability/shipping. Applies to `search`/`productsByCategory`. | | `reviewSort` | string | `relevancy`, `recent`, `rating_high_low`, `rating_low_high`. Applies to `productReviews`. | | `reviewRating` | integer | Bias results toward this star rating (1-5). Applies to `productReviews` - see the caveat below. | | `reviewLimit` | integer | Reviews per page (default 10, max 50). | | `maxItems` | integer | Caps total result rows across the whole run (all queries/categories/products combined). The first 10 rows in a run are always free - see [Pricing](#pricing). Blank = no cap. | | `proxyConfiguration` | object | A residential proxy is strongly recommended - Walmart's bot defenses flag high-volume traffic from one IP. | ### Category ID format Top-level departments are a single number (`3944` = Electronics, `4044` = Home). Sub-categories are documented via a full underscore-joined breadcrumb path (`3944_1089430_3951` = Electronics › Computers, Laptops and Tablets › Laptops), which you can paste as-is - the Actor extracts just the last (leaf) segment for the actual request, since that's what Walmart's category pages actually key off of. Find a category's ID by opening any product in it via `productDetails` and reading the `categories[]` array in the output - each entry's URL ends in one number; the leaf category's number is what you want. ### Output One flat row per item. Search/category rows carry product fields; offer rows carry seller fields; review rows carry review fields. Every row has `_operation` (which mode produced it) and `status` (`success` or `error`) so you can split/filter a mixed export. Product row example: ```json { "_operation": "productDetails", "productId": "4SZSM8SXAAJT", "usItemId": "609040889", "productTitle": "Restored MacBook Air 13.3\" Laptop - Apple M1 chip - 8GB Memory - 256GB SSD - Space Gray", "brand": "Apple", "model": "MGN63LL/A", "upc": "194252048955", "price": 399, "listPrice": null, "currency": "USD", "rating": 4.2, "reviewCount": 6442, "ratingBreakdown": { "five": 4727, "four": 428, "three": 196, "two": 141, "one": 950 }, "availability": "In stock", "outOfStock": false, "seller": "Nebsys Corp", "sellerType": "EXTERNAL", "returnReturnable": true, "returnFree": true, "returnWindowDays": 30, "categories": [{ "name": "Electronics" }, { "name": "Laptops" }], "specifications": [{ "name": "Processor", "value": "Apple M1" }], "images": ["https://i5.walmartimages.com/..."], "productUrl": "https://www.walmart.com/ip/.../609040889", "status": "success" } ``` Offer row example (one per seller): ```json { "_operation": "productOffers", "productId": "3406383181", "offerId": "A6E0AF9655D24A1098AF19C794FB4BB1", "sellerName": "Walmart.com", "sellerType": "INTERNAL", "price": 49.97, "priceDisplay": "$49.97", "wfsEnabled": false, "freeShipping": true, "returnReturnable": true, "returnWindowDays": 90, "inStock": true, "status": "success" } ``` Review row example: ```json { "_operation": "productReviews", "productId": "609040889", "reviewId": "423325961", "reviewTitle": "Great machine for the price", "reviewRating": 5, "reviewBody": "Very light, fast and easy to setup...", "reviewAuthor": "zae357", "verifiedPurchase": true, "status": "success" } ``` Every row also spreads the raw upstream Walmart fields alongside the curated ones (curated fields always win on any name collision), so nothing is lost if you need something not in the curated set above. ### Pricing This Actor uses pay-per-event pricing - one small run-start charge, then a per-row charge for each operation (search/category/product-detail/offer/review result). See the **Pricing** tab for current rates. **The first 10 result rows in a run are always free**, regardless of how many items you batch in; every row after that is charged normally. Failed lookups land as `status: "error"` rows and are never charged. There's no page cap, so use `maxItems` (and batch size) to bound spend on a given run. ### Limitations - Only the numbers/text Walmart shows to an anonymous, logged-out visitor are available - no seller-account-only data. - `reviewRating` biases results toward that star rating but isn't a strict hard filter in every case - pairing it with an explicit `reviewSort` is more reliable (see code comments for what was live-verified). - Walmart's page schema drifts over time (already observed once during development - a price field moved from a flat string to a nested `priceLines` structure); the extraction code is written defensively with multiple fallback paths, but very large future redesigns may need an update. ### FAQ **Does Walmart have a public API?** Not one that covers open product search, full category listings, per-seller offers, or customer reviews without seller/partner approval. This Actor gets you the same data anonymously, no approval process. **Do I need a Walmart account or API key?** No - it runs entirely against Walmart's public, logged-out web pages. **Which marketplaces are supported?** `walmart.com` (`domain: "us"`) and `walmart.ca` (`domain: "ca"`). **A run returns 0 results with no error - why?** For `productsByCategory`, this is almost always the category ID pointing at a top-level department "hub" page (curated modules, no plain product grid) rather than a real leaf category - try a more specific sub-category ID. For `search`/`productReviews`, an unusually narrow filter combination can also legitimately return nothing. ### Disclaimer This Actor is an independent tool, not affiliated with or endorsed by Walmart Inc. It only accesses data Walmart serves publicly to anonymous visitors. Use it in compliance with Walmart's Terms of Service and applicable law in your jurisdiction. Found a bug or have a feature request? Use the Issues tab on this Actor's page. # Actor input Schema ## `operation` (type: `string`): Which Walmart data to scrape. One operation per run. ## `query` (type: `string`): Keyword to search Walmart, e.g. "coffee maker". Used by the search operation. Defaults to a demo query if left blank. ## `queries` (type: `array`): Many keywords in one run. Wins over "query" when filled. Duplicates and blanks are dropped. ## `categoryId` (type: `string`): A Walmart category ID, e.g. "3944" (Electronics) or "3951" (Laptops). You can paste either the bare leaf ID or the full underscore-joined breadcrumb path (e.g. "3944\_1089430\_3951") copied from a category page - the Actor extracts the leaf ID either way. Used by the productsByCategory operation. ## `categoryIds` (type: `array`): Many category IDs in one run. Wins over "categoryId" when filled. ## `productId` (type: `string`): A Walmart product ID - either the numeric usItemId (e.g. "609040889") or the alphanumeric product ID (e.g. "4SZSM8SXAAJT"). Used by productDetails, productOffers, and productReviews. ## `productIds` (type: `array`): Many product IDs in one run. Wins over "productId" when filled. ## `domain` (type: `string`): Which Walmart marketplace to query. ## `sortBy` (type: `string`): Applies to search and productsByCategory. ## `minPrice` (type: `integer`): Applies to search and productsByCategory. ## `maxPrice` (type: `integer`): Applies to search and productsByCategory. ## `storeId` (type: `string`): Localize availability and shipping to a specific Walmart store. Applies to search and productsByCategory. ## `state` (type: `string`): Localize availability and shipping to a US state, e.g. "TX". Applies to search and productsByCategory. ## `reviewSort` (type: `string`): Applies to productReviews. ## `reviewRating` (type: `integer`): Return only reviews with this star rating (1-5). Leave blank to return all ratings. Applies to productReviews. ## `reviewLimit` (type: `integer`): Applies to productReviews. ## `maxItems` (type: `integer`): Caps the total number of result rows returned across this whole run (all queries/categories/products combined) - useful to bound spend on a large batch. The first 10 rows in a run are always free regardless of this setting; leave blank for no cap. There is no page cap - search, productsByCategory, and productReviews always paginate through to the site's own last reported page for each item. ## `proxyConfiguration` (type: `object`): A residential proxy is strongly recommended - Walmart aggressively rate-limits repeated traffic from one IP. ## Actor input object example ```json { "operation": "search", "query": "coffee maker", "domain": "us", "reviewLimit": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "query": "coffee maker" }; // Run the Actor and wait for it to finish const run = await client.actor("mrdoe/walmart-product-reviews-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "query": "coffee maker" } # Run the Actor and wait for it to finish run = client.actor("mrdoe/walmart-product-reviews-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 '{ "query": "coffee maker" }' | apify call mrdoe/walmart-product-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,mrdoe/walmart-product-reviews-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 ` 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/XY0aMFoBao0fxXcGt/builds/jJQ0mebaCF5h4Htyw/openapi.json