# Walmart Scraper | Live Prices, Reviews, Deals & Product Data (`b2b_leads/walmart-scraper-live-prices-reviews-deals-product-data`) Actor Walmart scraper for real-time data: keyword search, rich PDP specs (variants, fulfillment, 40+ fields), reviews w/ photos, rollbacks, deals, best sellers & categories. US + Canada. Anti-bot + proxy. PerimeterX bypass. JSON for price tracking, repricing & catalog builds. - **URL**: https://apify.com/b2b\_leads/walmart-scraper-live-prices-reviews-deals-product-data.md - **Developed by:** [Chidubem Aneke](https://apify.com/b2b_leads) (community) - **Categories:** E-commerce, Automation, MCP servers - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 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. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 ## Walmart Real-Time Data — Live Walmart Product Scraper (Apify Actor) **The richest, most production-ready public Walmart data scraper on Apify.** Stop fighting PerimeterX, Akamai, and Walmart's anti-bot walls. This Actor returns **live search results, extremely detailed product pages (40-60+ fields), reviews with photos, rollbacks, best sellers, and category data** as clean structured JSON. **Checkbox features** — turn on only what you need. **US + Canada** support. **Residential proxy + 2Captcha built-in**. No code required. Export to Sheets, pipe to webhooks, schedule monitoring, or call via Apify API / MCP. One of the highest-signal public Walmart datasets you can get. --- ### Why teams choose Walmart Real-Time Data - **Insanely rich records** — not just price + title. Full specs map, parsed dimensions, unit pricing, variant matrices, fulfillment ETAs (pickup today / delivery windows), Walmart+ signals, rollback context, seller details, customer photo counts, and 40-60 fields on Product Details. - **7 powerful tools in one** — Search, Details, Reviews, Deals, Best Sellers, Category Browse, flexible URL scraper. - **Real commerce signals** — same-day pickup, delivery estimates, "Walmart Exclusive", Best Seller badges, sponsored flags, 3rd-party seller info. Gold for inventory proxies and dropshipping. - **Built for scale & reliability** — session warm-up (homepage + category browse), cookie reuse for PDP, multi-strategy navigation, stealth browser flags, residential proxies, and optional 2Captcha. - **MCP / API / automation friendly** — exhaustive input schema + example payloads + output shapes documented here. - **Apify native** — webhooks, scheduling, dataset views, CSV/Excel export, integrations with everything. If you need **actionable Walmart data** (not thin scrapes), this is it. --- ### Who is this for? | User | What you get | |-----------------------------|------------------------------------------------------------------------------| | Walmart sellers & vendors | Competitor prices, offer changes, review velocity, rollback detection | | Price intelligence / repricers | Live + historical baseline pricing with wasPrice, unit price, discount % | | Dropshippers & arbitrage | High-signal products with fast fulfillment (pickup today = real local stock) | | CPG brands & researchers | Assortment, best-seller movement, deal velocity, rich specs for matching | | Deal / affiliate sites | Fresh rollback & clearance feeds with deep discount data + badges | | Agencies & consultants | Client-grade datasets without building or maintaining scrapers | | Data teams & developers | Reliable "Walmart API" via Apify — clean JSON, no SP-API equivalent needed | --- ### What makes the data so rich? A single **Product Details** record typically contains: **Pricing & value** - price, wasPrice, unitPrice (with display string like "$0.08 / fl oz"), savings, rollback/clearance flags **Availability & logistics (unique Walmart strength)** - inStock + detailed status - pickupAvailable / pickupToday / pickupEstimate - deliveryEstimate, shippingSpeed, freeShipping, Walmart+ eligibility - fulfillmentOptions array (detailed) **Trust & merchandising** - rating + full breakdown, reviewCount, photo/video counts - badges: Best Seller, Walmart Exclusive, Sponsored, Rollback, Clearance, New... **Seller** - sellerName, isWalmart, fulfilledBy, marketplace seller info **Rich attributes** - specifications: full key-value map (Material, Flavor, Dimensions string, Count, Container Type, etc.) - dimensions object (parsed numeric length/width/height/weight) - highlights, longDescription **Variants** - variantOptionTypes + full variants array with per-option pricing/stock/images **Media** - primary + large gallery of imageUrls (often 10-20+) **Context** - breadcrumbs, categories, related/frequently bought **Search & Deals** records are also packed with the above signals where present on the page. This level of coverage fits **price monitoring, catalog sync, competitive intelligence, local stock estimation, ML training sets, and more**. --- ### Features | Feature | Default | Description | |----------------------|---------|-----------------------------------------------------------------------------| | 🔍 Product Search | ON | Keyword search with position, price, badges, fulfillment snippets, ratings | | 📦 Product Details | OFF | Deep PDP — the richest output. Use for exact items or follow-up enrichment | | ⭐ Product Reviews | OFF | Paginated reviews including customer photos | | 🔗 Scrape By URL | OFF | Any Walmart URL — auto-detects search / product / deals / category | | 🏷️ Deals | OFF | Rollbacks, clearance, special buys, flash deals | | 🏆 Best Sellers | OFF | Ranked best sellers or trending from hubs or categories | | 📂 Category Browse | OFF | Browse any department/category URL for rich product grids | --- ### 25+ Marketplaces? No — focused & deep **Primary**: United States (`US` — walmart.com) — full coverage **Secondary**: Canada (`CA` — walmart.ca) Walmart's strength is depth on the US site. We optimized for quality and anti-bot success here. --- ### How to run 1. Open the Actor on Apify. 2. Choose **country** (US recommended). 3. Check the features you need (Product Search is on by default). 4. Provide keywords, item IDs (e.g. `13802306327`), or full URLs. 5. Use **Residential proxies** (Apify RESIDENTIAL or DataImpulse — we provide rotation guidance). 6. Run. Filter results by `featureType` in the dataset. **Pro tip**: Schedule runs (hourly/daily) + webhooks for price/availability/stock signal monitoring. --- ### Example Inputs (Console, API, MCP) **Important**: When calling a single feature via API/MCP, set `"enableProductSearch": false` and enable only the one(s) you want. #### Product Search only (default behavior) ```json { "country": "US", "enableProductSearch": true, "searchKeywords": ["wireless mouse", "tide detergent"], "searchMaxResultsPerKeyword": 15, "searchSort": "best_match" } ```` #### Product Details only (ultra rich) ```json { "country": "US", "enableProductSearch": false, "enableProductDetails": true, "itemIds": ["13802306327", "10450124"], "productUrls": ["https://www.walmart.com/ip/Logitech-Silent-Wireless-Mouse-Black-Walmart-Exclusive/13802306327"] } ``` #### Reviews (standalone) ```json { "country": "US", "enableProductSearch": false, "enableProductReviews": true, "reviewItemIds": ["13802306327"], "reviewsMaxPerProduct": 30, "reviewsSortBy": "newest" } ``` #### Search + Reviews (no manual item IDs) Automatically scrape reviews (and product ratings) for products found in search: ```json { "country": "US", "enableProductSearch": true, "enableProductReviews": true, "searchKeywords": ["wireless mouse"], "searchMaxResultsPerKeyword": 10, "searchScrapeReviews": true, "searchReviewsMaxProducts": 5, "reviewsMaxPerProduct": 10, "reviewsSortBy": "newest" } ``` Review rows include `searchKeyword`, `searchPosition`, and `productAverageRating` when chained from search. #### Deals + Best Sellers ```json { "country": "US", "enableProductSearch": false, "enableDeals": true, "dealsType": "rollbacks", "dealsMaxProducts": 50, "enableBestSellers": true, "bestSellersCategoryUrls": ["https://www.walmart.com/browse/electronics/3944_1089430"] } ``` #### Scrape any URL(s) ```json { "country": "US", "enableProductSearch": false, "enableScrapeByUrl": true, "scrapeUrls": [ "https://www.walmart.com/search?q=airpods", "https://www.walmart.com/ip/Some-Product/123456789" ], "scrapeMaxPages": 2 } ``` #### Combined (search + details) When both Search and Details are enabled, **Details runs first** (fresh session) then Search — better PDP success on Walmart. ```json { "country": "US", "enableProductSearch": true, "searchKeywords": ["gaming mouse"], "searchMaxResultsPerKeyword": 5, "enableProductDetails": true, "itemIds": ["13802306327"] } ``` All results land in one dataset. Use `featureType` (`product_search`, `product_details`, `product_reviews`, `deals`, `best_sellers`, `category_browse`, `scrape_by_url`) to split them. *** ### Output Schema Highlights (per featureType) Every record always has: - `featureType` - `country` - `url` / `sourceUrl` - `scrapedAt` (ISO string) - `itemId` #### product\_search `position`, `keyword`, `title`, `brand`, `price`, `wasPrice`, `unitPrice`, `savingsPercent`, `rating`, `reviewCount`, `badges[]`, `isSponsored`, fulfillment signals, `imageUrl`, `sellerName`... #### product\_details (the big one) See FEATURES\_AND\_DATA\_POINTS.md for 40-60 field list. Includes `specifications`, `dimensions`, `variants[]`, `fulfillmentOptions[]`, `imageUrls[]`, `breadcrumbs`, full seller, badges, etc. #### product\_reviews `rating`, `title`, `text`, `author`, `verifiedPurchase`, `photos[]`, `helpfulVotes`, `purchasedVariant`, `productAverageRating`, `reviewCount` (product total)... When scraped via search (`searchScrapeReviews`): also `searchKeyword`, `searchPosition`. #### deals / best\_sellers / category\_browse Rich product shape + `rank` or `dealType` / `discountPercent` + badges. Full schemas also live in `.actor/output_schema.json` and dataset views. *** ### Integrations & Workflows - **Daily price + availability monitor** — Search or item list + Details → webhook on change. - **Rollback alert feed** — Deals feature scheduled every morning → Slack / email / Sheets. - **Local stock proxy** — Track pickupToday / deliveryEstimate across proxy rotations or zip (future). - **Catalog builder** — Search or category browse + Details enrichment → your DB or Shopify import. - **Review intelligence** — Reviews feature + photos for sentiment or visual QA. - **Competitor tracking** — Multi-item Details runs on key ASIN/item lists. Works seamlessly with: Apify API, MCP (`call-actor`), webhooks, Zapier, Make, Google Sheets, Airbyte, custom Python/Node ETL, n8n, etc. *** ### Proxy & CAPTCHA recommendations **Best**: Apify Residential proxies with country matching (US/CA). **Local / advanced**: DataImpulse residential (gw.dataimpulse.com:10000). Username routing for country (`__cr.us`). **CAPTCHA**: Actor handles many challenges internally. 2Captcha key supported for hard cases (we tested with provided key). Always use residential — datacenter IPs get blocked quickly on Walmart. *** ### FAQ **Is Walmart harder to scrape than Amazon?**\ Yes — different bot protection (PerimeterX/HUMAN). We use multiple proven bypass strategies + stealth + residential proxies. Success rate is high with proper config. **How many items can I process?**\ Hundreds per run is realistic. For thousands, split across scheduled runs or increase memory/timeout. **Do I get variant-level pricing?**\ Yes — Details returns the full variants matrix with per-variant price/stock when present. **Can I get same-day pickup signals?**\ Yes. These are excellent real-time proxies for local availability. Results reflect the proxy's geo. **How is output structured for easy use?**\ One dataset. Filter by `featureType`. Consistent top-level keys. Timestamped. **Do I need to code?**\ No for Console use. Full JSON examples for API/MCP/automation above. **What about rate limits?**\ We rotate sessions, add delays, respect limits, and retry. Use residential + reasonable batch sizes. *** ### Input Schema Reference (key fields) See `.actor/input_schema.json` for the exact Console form (with sections and help text). Core toggles (checkboxes): - `enableProductSearch` (default true) - `enableProductDetails` - `enableProductReviews` - `enableScrapeByUrl` - `enableDeals` - `enableBestSellers` - `enableCategoryBrowse` Key arrays: - `searchKeywords` - `itemIds` / `productUrls` (for details) - `reviewItemIds` (optional when `searchScrapeReviews` is on) - `scrapeUrls` - `categoryUrls` Search → reviews chaining: - `searchScrapeReviews` — auto-fetch reviews for search result item IDs - `searchReviewsMaxProducts` — cap products per keyword (default 5) Other common: - `country` - `searchMaxResultsPerKeyword`, `searchSort` - `reviewsMaxPerProduct`, `reviewsSortBy` - `dealsMaxProducts`, `dealsType` - `proxyConfiguration` (editor: proxy) *** ### Output Example Snippet (product\_details style) ```json { "featureType": "product_details", "country": "US", "itemId": "13802306327", "title": "Logitech Silent Wireless Mouse, Black, Walmart Exclusive", "brand": "Logitech", "price": 14.52, "wasPrice": null, "unitPrice": null, "savingsPercent": null, "rating": 4.5, "reviewCount": 4969, "badges": ["Walmart Exclusive", "Best Seller"], "inStock": true, "pickupAvailable": true, "pickupToday": true, "deliveryEstimate": "tomorrow", "isWalmartPlus": true, "sellerName": "Walmart", "specifications": { "Color": "Black", "Wireless Technology": "2.4 GHz", "DPI": "1600", ... }, "dimensions": { "length": 4.5, "width": 2.8, "height": 1.6, "weight": 0.2, "unit": "in" }, "variants": [...], "imageUrls": ["https://...", ...], "breadcrumbs": ["Electronics", "Computer Accessories", "Mice"], "url": "https://www.walmart.com/ip/.../13802306327", "scrapedAt": "2026-07-05T..." } ``` Full fields vary by feature and page content. *** ### Get Started 1. Click **Try for free** / **Start**. 2. Pick US, enable the features you want. 3. Add 1-2 test keywords or item IDs. 4. Use Residential proxy. 5. Run → explore the rich dataset. **Live Walmart data. Extremely rich structured JSON. Zero maintenance.** *** ### Contact Me Need a **custom scraping project**, **data pipeline**, or **web app** built from scratch? I build production-grade scrapers (e-commerce, social, maps, lead gen, and more) and full-stack web applications. - **Email:** - **GitHub:** [github.com/DrunkCodes](https://github.com/DrunkCodes) Reach out for custom Apify actors, anti-bot solutions, monitoring dashboards, APIs, or any automation you need. *** *Built with the same battle-tested patterns as Amazon Real-Time Data + Wayfair Real-Time Data, with Walmart-specific stealth and data depth.* # Actor input Schema ## `country` (type: `string`): Walmart marketplace. Currently US (walmart.com) and CA (walmart.ca). Drives domain and currency. ## `enableProductSearch` (type: `boolean`): Search Walmart by keyword. Returns rich cards with price, badges, fulfillment signals, ratings. ## `searchKeywords` (type: `array`): Keywords to search (e.g. "wireless mouse", "tide"). 1-20 supported. ## `searchMaxResultsPerKeyword` (type: `integer`): Maximum products per keyword (1-200). ## `searchMaxPages` (type: `integer`): How many search result pages to crawl. ## `searchSort` (type: `string`): How to sort search results. ## `searchScrapeReviews` (type: `boolean`): When Product Reviews is also enabled, automatically fetch reviews (and product ratings) for items found in search. Works standalone with search + reviews only — no manual reviewItemIds needed. ## `searchReviewsMaxProducts` (type: `integer`): How many search-result products to pull reviews for per keyword (1-50). Defaults to max results per keyword. ## `enableProductDetails` (type: `boolean`): Fetch extremely rich PDP data (40-60+ fields): specs, dimensions, variants, fulfillment, seller, images, etc. ## `itemIds` (type: `array`): Walmart numeric item IDs (usItemId), e.g. 13802306327 or 10450124. Primary identifier. ## `productUrls` (type: `array`): Full Walmart product page URLs (https://www.walmart.com/ip/...). Alternative to itemIds. ## `includeVariants` (type: `boolean`): Extract full variant matrix with per-option pricing and stock. ## `includeSpecs` (type: `boolean`): Extract full specifications map + parsed dimensions. ## `includeFulfillment` (type: `boolean`): Extract pickup, delivery estimates, Walmart+ signals, shipping options. ## `includeImages` (type: `boolean`): Return full image gallery URLs. ## `enableProductReviews` (type: `boolean`): Paginated customer reviews including photos when available. ## `reviewItemIds` (type: `array`): Numeric item IDs to fetch reviews for. Optional when searchScrapeReviews is enabled with Product Search. ## `reviewsMaxPerProduct` (type: `integer`): How many reviews to collect per product (1-100). ## `reviewsSortBy` (type: `string`): Sort order for reviews. ## `enableScrapeByUrl` (type: `boolean`): Paste any Walmart URL (search, PDP, deals, category). Auto-detects page type and extracts rich data. ## `scrapeUrls` (type: `array`): Any walmart.com or walmart.ca URLs. ## `scrapeMaxPages` (type: `integer`): Follow pagination on search/category/deals pages. ## `enableDeals` (type: `boolean`): Scrape today's deals, rollbacks, clearance, and special buys. ## `dealsType` (type: `string`): Filter deal type. ## `dealsMaxProducts` (type: `integer`): Maximum deal items to return. ## `enableBestSellers` (type: `boolean`): Ranked best sellers or trending products from category hubs. ## `bestSellersCategoryUrls` (type: `array`): Direct category or best-seller page URLs. ## `bestSellerMaxProducts` (type: `integer`): Limit per category. ## `enableCategoryBrowse` (type: `boolean`): Browse any Walmart department or category URL and get rich product grids. ## `categoryUrls` (type: `array`): e.g. https://www.walmart.com/browse/electronics/3944\_1089430 ## `categoryMaxPages` (type: `integer`): Pagination depth. ## `maxItems` (type: `integer`): Safety cap applied across features when no specific max is set. ## `proxyConfiguration` (type: `object`): Residential proxies are strongly recommended for Walmart. Apify Residential or your own provider. ## Actor input object example ```json { "country": "US", "enableProductSearch": true, "searchKeywords": [ "wireless mouse" ], "searchMaxResultsPerKeyword": 10, "searchMaxPages": 1, "searchSort": "best_match", "searchScrapeReviews": false, "searchReviewsMaxProducts": 5, "enableProductDetails": false, "itemIds": [], "productUrls": [], "includeVariants": true, "includeSpecs": true, "includeFulfillment": true, "includeImages": true, "enableProductReviews": false, "reviewItemIds": [], "reviewsMaxPerProduct": 20, "reviewsSortBy": "newest", "enableScrapeByUrl": false, "scrapeUrls": [], "scrapeMaxPages": 1, "enableDeals": false, "dealsType": "all", "dealsMaxProducts": 50, "enableBestSellers": false, "bestSellersCategoryUrls": [], "bestSellerMaxProducts": 50, "enableCategoryBrowse": false, "categoryUrls": [], "categoryMaxPages": 1, "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `allResults` (type: `string`): Complete dataset with every field from all enabled features in this run. ## `overview` (type: `string`): Compact table — feature type, item ID, title, price, rating, and source URL. ## `search` (type: `string`): Search result rows only (featureType = product\_search). ## `details` (type: `string`): Product detail page rows (featureType = product\_details). ## `reviews` (type: `string`): Customer review rows (featureType = product\_reviews). ## `deals` (type: `string`): Deal hub rows (featureType = deals). ## `bestSellers` (type: `string`): Best seller ranking rows (featureType = best\_sellers). ## `categoryBrowse` (type: `string`): Category grid rows (featureType = category\_browse). # 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 = { "searchKeywords": [ "wireless mouse" ] }; // Run the Actor and wait for it to finish const run = await client.actor("b2b_leads/walmart-scraper-live-prices-reviews-deals-product-data").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 = { "searchKeywords": ["wireless mouse"] } # Run the Actor and wait for it to finish run = client.actor("b2b_leads/walmart-scraper-live-prices-reviews-deals-product-data").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchKeywords": [ "wireless mouse" ] }' | apify call b2b_leads/walmart-scraper-live-prices-reviews-deals-product-data --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=b2b_leads/walmart-scraper-live-prices-reviews-deals-product-data", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Walmart Scraper | Live Prices, Reviews, Deals & Product Data", "description": "Walmart scraper for real-time data: keyword search, rich PDP specs (variants, fulfillment, 40+ fields), reviews w/ photos, rollbacks, deals, best sellers & categories. US + Canada. Anti-bot + proxy. PerimeterX bypass. JSON for price tracking, repricing & catalog builds.", "version": "0.0", "x-build-id": "7bM6l9ofTDjWwiQIw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/b2b_leads~walmart-scraper-live-prices-reviews-deals-product-data/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-b2b_leads-walmart-scraper-live-prices-reviews-deals-product-data", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/b2b_leads~walmart-scraper-live-prices-reviews-deals-product-data/runs": { "post": { "operationId": "runs-sync-b2b_leads-walmart-scraper-live-prices-reviews-deals-product-data", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/b2b_leads~walmart-scraper-live-prices-reviews-deals-product-data/run-sync": { "post": { "operationId": "run-sync-b2b_leads-walmart-scraper-live-prices-reviews-deals-product-data", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "country": { "title": "Marketplace country", "enum": [ "US", "CA" ], "type": "string", "description": "Walmart marketplace. Currently US (walmart.com) and CA (walmart.ca). Drives domain and currency.", "default": "US" }, "enableProductSearch": { "title": "Product Search", "type": "boolean", "description": "Search Walmart by keyword. Returns rich cards with price, badges, fulfillment signals, ratings.", "default": true }, "searchKeywords": { "title": "Search keywords", "type": "array", "description": "Keywords to search (e.g. \"wireless mouse\", \"tide\"). 1-20 supported.", "default": [ "wireless mouse" ], "items": { "type": "string" } }, "searchMaxResultsPerKeyword": { "title": "Max results per keyword", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum products per keyword (1-200).", "default": 10 }, "searchMaxPages": { "title": "Max pages per keyword", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many search result pages to crawl.", "default": 1 }, "searchSort": { "title": "Sort order", "enum": [ "best_match", "price_low", "price_high", "rating", "newest", "best_seller" ], "type": "string", "description": "How to sort search results.", "default": "best_match" }, "searchScrapeReviews": { "title": "Scrape reviews from search results", "type": "boolean", "description": "When Product Reviews is also enabled, automatically fetch reviews (and product ratings) for items found in search. Works standalone with search + reviews only — no manual reviewItemIds needed.", "default": false }, "searchReviewsMaxProducts": { "title": "Max products to review per keyword", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many search-result products to pull reviews for per keyword (1-50). Defaults to max results per keyword.", "default": 5 }, "enableProductDetails": { "title": "Product Details", "type": "boolean", "description": "Fetch extremely rich PDP data (40-60+ fields): specs, dimensions, variants, fulfillment, seller, images, etc.", "default": false }, "itemIds": { "title": "Item IDs", "type": "array", "description": "Walmart numeric item IDs (usItemId), e.g. 13802306327 or 10450124. Primary identifier.", "default": [], "items": { "type": "string" } }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Full Walmart product page URLs (https://www.walmart.com/ip/...). Alternative to itemIds.", "default": [], "items": { "type": "string" } }, "includeVariants": { "title": "Include variants", "type": "boolean", "description": "Extract full variant matrix with per-option pricing and stock.", "default": true }, "includeSpecs": { "title": "Include specifications", "type": "boolean", "description": "Extract full specifications map + parsed dimensions.", "default": true }, "includeFulfillment": { "title": "Include fulfillment", "type": "boolean", "description": "Extract pickup, delivery estimates, Walmart+ signals, shipping options.", "default": true }, "includeImages": { "title": "Include images", "type": "boolean", "description": "Return full image gallery URLs.", "default": true }, "enableProductReviews": { "title": "Product Reviews", "type": "boolean", "description": "Paginated customer reviews including photos when available.", "default": false }, "reviewItemIds": { "title": "Review item IDs", "type": "array", "description": "Numeric item IDs to fetch reviews for. Optional when searchScrapeReviews is enabled with Product Search.", "default": [], "items": { "type": "string" } }, "reviewsMaxPerProduct": { "title": "Max reviews per item", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many reviews to collect per product (1-100).", "default": 20 }, "reviewsSortBy": { "title": "Reviews sort", "enum": [ "recommended", "newest", "oldest", "highest", "lowest" ], "type": "string", "description": "Sort order for reviews.", "default": "newest" }, "enableScrapeByUrl": { "title": "Scrape By URL", "type": "boolean", "description": "Paste any Walmart URL (search, PDP, deals, category). Auto-detects page type and extracts rich data.", "default": false }, "scrapeUrls": { "title": "URLs to scrape", "type": "array", "description": "Any walmart.com or walmart.ca URLs.", "default": [], "items": { "type": "string" } }, "scrapeMaxPages": { "title": "Max pages (for list pages)", "minimum": 1, "maximum": 10, "type": "integer", "description": "Follow pagination on search/category/deals pages.", "default": 1 }, "enableDeals": { "title": "Deals & Rollbacks", "type": "boolean", "description": "Scrape today's deals, rollbacks, clearance, and special buys.", "default": false }, "dealsType": { "title": "Deals type", "enum": [ "all", "rollbacks", "clearance", "special_buy", "flash" ], "type": "string", "description": "Filter deal type.", "default": "all" }, "dealsMaxProducts": { "title": "Max deal products", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum deal items to return.", "default": 50 }, "enableBestSellers": { "title": "Best Sellers / Trending", "type": "boolean", "description": "Ranked best sellers or trending products from category hubs.", "default": false }, "bestSellersCategoryUrls": { "title": "Best seller category URLs", "type": "array", "description": "Direct category or best-seller page URLs.", "default": [], "items": { "type": "string" } }, "bestSellerMaxProducts": { "title": "Max best seller products", "minimum": 1, "maximum": 200, "type": "integer", "description": "Limit per category.", "default": 50 }, "enableCategoryBrowse": { "title": "Category Browse", "type": "boolean", "description": "Browse any Walmart department or category URL and get rich product grids.", "default": false }, "categoryUrls": { "title": "Category URLs", "type": "array", "description": "e.g. https://www.walmart.com/browse/electronics/3944_1089430", "default": [], "items": { "type": "string" } }, "categoryMaxPages": { "title": "Max pages to browse", "minimum": 1, "maximum": 5, "type": "integer", "description": "Pagination depth.", "default": 1 }, "maxItems": { "title": "Global max items", "minimum": 1, "type": "integer", "description": "Safety cap applied across features when no specific max is set.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxies are strongly recommended for Walmart. Apify Residential or your own provider.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```