# Walmart Data Extractor (`khadinakbar/walmart-data-extractor`) Actor Extract Walmart.com products from search, category, product URLs, or item IDs. Returns prices, ratings, stock, seller, variants, breadcrumbs, and specifications. Optional per-review extraction. PPE pricing — $0.003 per product, $0.002 per review. - **URL**: https://apify.com/khadinakbar/walmart-data-extractor.md - **Developed by:** [Khadin Akbar](https://apify.com/khadinakbar) (community) - **Categories:** E-commerce, MCP servers, Automation - **Stats:** 3 total users, 3 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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 Data Extractor — Products, Prices, Reviews & Sellers Production-grade scraper that extracts structured **product data from Walmart.com**: titles, brands, current and list prices, savings, ratings, review counts, stock status, seller name and type (Walmart vs marketplace), pickup/shipping availability, images, variants, breadcrumbs, and specifications. Optionally pulls individual customer reviews. Built on Walmart's `__NEXT_DATA__` JSON blob (richer and more reliable than DOM scraping) and runs through Apify Residential proxies to clear Walmart's Akamai + PerimeterX defense. **One actor, four modes** — search, category, direct product URLs, or raw Walmart item IDs. ### What you get per product | Field | Description | | --- | --- | | `itemId` | Walmart numeric item ID (a.k.a. `usItemId`). | | `productUrl` | Canonical Walmart product page URL. | | `title` | Product title. | | `brand` | Brand name. | | `model` | Manufacturer model number, when available. | | `category` | Leaf category (`Laptops`, `Wireless Headphones`, etc.). | | `breadcrumbs[]` | Full category path from root → leaf. | | `currentPrice` | Current selling price (USD). | | `listPrice` | MSRP / strikethrough price, when shown. | | `savings` | `listPrice - currentPrice`, when both present. | | `onSale` | `true` if savings > 0. | | `currency` | Currency code (`USD`). | | `rating` | Average customer rating (0–5). | | `reviewCount` | Total number of customer reviews. | | `inStock` | Boolean parsed from `availabilityStatus`. | | `sellerName` | Selling entity (`Walmart.com` or marketplace seller). | | `sellerType` | `walmart` / `marketplace` / `walmart_or_marketplace`. | | `pickupAvailable` | Local store pickup available. | | `shippingAvailable` | Ships from any fulfillment channel. | | `freeShipping` | Free shipping flagged. | | `imageUrl` | Primary image URL. | | `images[]` | Full image gallery. | | `variants[]` | Color / size / configuration variants (when `includeVariants`). | | `specifications{}` | Manufacturer spec sheet as a `{key: value}` map (when `includeSpecifications`). | | `description` | Short product description. | | `badges[]` | Promotional badges (`Rollback`, `Reduced Price`, `Bestseller`, etc.). | | `scrapedAt` | ISO timestamp the record was captured. | When `includeReviews = true`, the same dataset also receives **review records** tagged `_type: "review"`: | Field | Description | | --- | --- | | `reviewId` | Walmart review identifier. | | `itemId` | Parent product item ID. | | `rating` | Star rating (1–5). | | `title` | Review title. | | `text` | Review body. | | `author` | Reviewer display name. | | `verifiedPurchaser` | Verified buyer flag. | | `helpfulVotes` / `unhelpfulVotes` | Community vote counts. | | `photos[]` | Review-attached photos. | | `pros[]` / `cons[]` | Bullet pros/cons (when present). | | `submittedAt` | ISO date of the review. | ### When to use this actor - **Walmart Marketplace sellers** tracking competitor SKUs, Buy Box wins, and MAP violations. - **Retail price-monitoring SaaS** building cross-retailer feeds (pair with our Amazon, eBay, and Google Shopping actors). - **Dropshipping / arbitrage agents** comparing Walmart prices against Amazon/Walmart pricing in real time. - **Brand teams** monitoring review sentiment and rating drift on their SKUs. - **AI shopping agents** that need current Walmart prices/stock as a tool call (`apify--walmart-data-extractor` via Apify MCP). ### When NOT to use - **Walmart Canada / Mexico** — this actor targets `walmart.com` only. Walmart.ca and walmart.com.mx have different DOM/JSON shapes. - **Bulk catalogs > 500 products per run** — split into multiple runs. Walmart's anti-bot pool degrades with sustained heavy concurrency. - **Walmart Grocery delivery** — grocery uses a separate API surface; out of scope here. ### Modes #### `mode: search` Run a keyword search. ```json { "mode": "search", "searchQuery": "samsung 65 inch tv", "maxProducts": 50 } ```` #### `mode: category` Crawl a Walmart category/listing URL. ```json { "mode": "category", "categoryUrls": ["https://www.walmart.com/shop/electronics/laptops"] } ``` #### `mode: productUrls` Direct product detail pages. ```json { "mode": "productUrls", "productUrls": [ "https://www.walmart.com/ip/Apple-AirPods-Pro/588402301", "https://www.walmart.com/ip/123456789" ] } ``` #### `mode: itemIds` Bulk catalog enrichment from a list of Walmart item IDs. ```json { "mode": "itemIds", "itemIds": ["588402301", "210384701"] } ``` ### Pricing — Pay Per Event This actor uses Apify's **pay-per-event** billing — you only pay for results you actually receive, plus a tiny start fee. | Event | Price | | --- | --- | | `apify-actor-start` | $0.00005 (one-time per run) | | `product-extracted` | **$0.003** per product | | `review-extracted` | **$0.002** per review (only when `includeReviews = true`) | **Typical costs:** - 50 products: `~$0.15` - 50 products + 10 reviews each: `~$1.15` - 500 products: `~$1.50` Pay-per-usage (compute + proxy) is also enabled for heavy power-user jobs — buyers self-select at run time. ### Usage examples #### Via Apify console 1. Pick a `mode` and supply the matching field (`searchQuery`, `categoryUrls`, `productUrls`, or `itemIds`). 2. Optionally set `includeReviews: true` and `maxReviewsPerProduct`. 3. Run. #### Via API (Node.js) ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_TOKEN' }); const run = await client.actor('khadinakbar/walmart-data-extractor').call({ mode: 'search', searchQuery: 'wireless headphones', maxProducts: 50, includeReviews: false, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` #### Via API (Python) ```python from apify_client import ApifyClient client = ApifyClient('YOUR_TOKEN') run = client.actor('khadinakbar/walmart-data-extractor').call(run_input={ 'mode': 'productUrls', 'productUrls': ['https://www.walmart.com/ip/588402301'], 'includeReviews': True, 'maxReviewsPerProduct': 20, }) items = list(client.dataset(run['defaultDatasetId']).iterate_items()) print(items) ``` #### Via Apify MCP (Claude / GPT / Gemini agents) Tool name: `apify--walmart-data-extractor`. The actor's input schema is wired for AI-agent consumption — every property has a 4-sentence description with a literal example and disambiguator. ### How it works - **PlaywrightCrawler (Chromium)** with realistic Chrome 120+ fingerprint pool (Windows + macOS desktop, en-US locale). - **Apify Residential proxy** pinned to US — non-US IPs see different (or missing) Walmart inventory due to geo-locking. - **Session pool with cookie persistence** — PerimeterX scores per-session, so we keep sessions warm. Sessions are retired on 403/429/503 or block-page detection. - **Resource blocking** — images, fonts, stylesheets, and media are aborted in `preNavigationHooks` for ~3x faster page loads (we don't need them, the data lives in `__NEXT_DATA__`). - **Multi-path defensive extraction** — `parsers.js` walks several known Next.js layouts so a single Walmart schema change rarely breaks the extractor. - **Silent-failure guard** — runs that complete with 0 products and >0 errors **fail** with an actionable status message rather than charging the start fee on an empty dataset. ### Known limits - **Walmart caps search at 25 pages** (~1,000 results). Use category URLs or split keyword variants for larger catalogs. - **Reviews shape may vary** for some product types (auto, grocery, books). The extractor falls back gracefully — partial review records over no review records. - **Akamai + PerimeterX rate-limits the residential pool** under heavy concurrent load. If a run produces 0 items, retry in 10–15 minutes or lower `maxProducts`. - **Geo-locking** — Walmart shows different prices/availability per ZIP. The default US residential proxy yields the "default" US view; ZIP-aware pricing is on the roadmap for v0.2. ### Legal This actor scrapes publicly available product information from `walmart.com`. By using it, you assume responsibility for your compliance with Walmart's [Terms of Use](https://www.walmart.com/help/article/walmart-com-terms-of-use/3b75080af40340d6bbd596f116fae5a0) and applicable scraping/data laws in your jurisdiction. The actor does **not** require any Walmart account login and does not extract account-only or personal data. Use at your own risk. ### Related actors in the Khadin Akbar portfolio - [Amazon Product Intelligence](https://apify.com/khadinakbar/amazon-product-intelligence) - [Amazon Reviews Scraper](https://apify.com/khadinakbar/amazon-reviews-scraper) - [Amazon Competitor Price Tracker](https://apify.com/khadinakbar/amazon-competitor-price-tracker) - [eBay All-in-One Scraper](https://apify.com/khadinakbar/ebay-all-in-one-scraper) - [Etsy All-in-One Scraper](https://apify.com/khadinakbar/etsy-all-in-one-scraper) - [Shopify All-in-One Scraper](https://apify.com/khadinakbar/shopify-all-in-one-scraper) - [Google Shopping Scraper](https://apify.com/khadinakbar/google-shopping-scraper) # Actor input Schema ## `mode` (type: `string`): Which extraction surface to scrape on Walmart.com. `search` runs a keyword search (returns search-card data — title, price, brand, rating, stock — for many products fast); `productUrls` fetches detail pages directly (returns full data — variants, specifications, image gallery, description — per URL); `itemIds` looks up each ID via the search engine and returns search-card data. Defaults to `search`. ## `searchQuery` (type: `string`): Free-text query run on Walmart's search engine (e.g., 'wireless headphones', 'samsung 65 inch tv'). Required when `mode = search`. To narrow by category, append a Walmart `cat_id` filter to the URL via the `sortBy` + filters fields, or include the category name in the keyword itself. ## `productUrls` (type: `array`): Direct Walmart product detail URLs (e.g., `https://www.walmart.com/ip/JLab-Studio-2-Wireless-Headphones/13544111159`). Required when `mode = productUrls`. Each URL produces one full product record with variants, specifications, and image gallery. NOT search URLs — those use `mode = search`. ## `itemIds` (type: `array`): Numeric Walmart item IDs (e.g., `13544111159`). Required when `mode = itemIds`. Each ID is resolved via Walmart's search engine (more reliable than the slug-less /ip/{id} URL which PerimeterX often blocks) and returned as a search-card record (title, price, brand, rating, stock, seller). For full detail with variants and specs, use `productUrls` with the canonical slug URL instead. ## `maxProducts` (type: `integer`): Upper bound on total products written to the dataset. Higher values cost more (each product is $0.003). The example prefill is intentionally small so Apify health checks finish quickly; raise it for production runs. Hard cap 500 — for larger jobs split into multiple runs to keep cost predictable. ## `includeReviews` (type: `boolean`): When true, each product also fetches its customer reviews and pushes them as separate records into the dataset (each tagged `_type: review`). Reviews are charged separately at $0.002 each. Off by default. ## `maxReviewsPerProduct` (type: `integer`): Upper bound on reviews scraped per product when `includeReviews = true`. Default 20. Hard cap 200 per product — most signal lives in the first 20 reviews. ## `includeVariants` (type: `boolean`): Include the `variants` array on product detail records (size/color/configuration options). Default true. Disable to shrink record size when variants aren't needed. ## `includeSpecifications` (type: `boolean`): Include the `specifications` object on product detail records (manufacturer-supplied spec sheet). Default true. Disable to shrink record size when specs aren't needed. ## `minPrice` (type: `integer`): Filter out products whose current price is below this value. Applied client-side; products without a parsed price are NOT filtered out. Omit for no lower bound. ## `maxPrice` (type: `integer`): Filter out products whose current price is above this value. Applied client-side; products without a parsed price are NOT filtered out. Omit for no upper bound. ## `brands` (type: `array`): Optional case-insensitive substring match against the product's brand (e.g., \['Apple', 'Samsung']). Products with a matching brand are kept; products with no brand attribute are dropped. Omit to disable brand filtering. ## `minRating` (type: `number`): Filter out products with an average rating below this value (1.0–5.0). Products without ratings are NOT filtered. Omit to disable rating filtering. ## `sortBy` (type: `string`): Sort order applied to search results. Ignored for `productUrls` and `itemIds` modes. `bestMatch` = Walmart's default ranking; `priceLow`/`priceHigh` = price ascending/descending; `rating` = highest-rated first; `newest` = recently added; `bestSelling` = top sellers. ## `proxyConfiguration` (type: `object`): Apify proxy configuration. Defaults to Apify Residential proxies pinned to US — required because Walmart geo-locks pricing/availability and runs Akamai + PerimeterX. Override only if you have a specific reason (e.g., your own residential pool). ## Actor input object example ```json { "mode": "search", "searchQuery": "samsung 65 inch tv", "maxProducts": 5, "includeReviews": false, "maxReviewsPerProduct": 20, "includeVariants": true, "includeSpecifications": true, "sortBy": "bestMatch", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `dataset` (type: `string`): All scraped Walmart products (and reviews when includeReviews=true). Download as JSON, CSV, Excel, HTML, or RSS. ## `runSummary` (type: `string`): End-of-run JSON with counts, charges, errors, and warning samples. # 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 = { "mode": "search", "searchQuery": "wireless headphones", "maxProducts": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("khadinakbar/walmart-data-extractor").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 = { "mode": "search", "searchQuery": "wireless headphones", "maxProducts": 5, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("khadinakbar/walmart-data-extractor").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 '{ "mode": "search", "searchQuery": "wireless headphones", "maxProducts": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call khadinakbar/walmart-data-extractor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=khadinakbar/walmart-data-extractor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Walmart Data Extractor", "description": "Extract Walmart.com products from search, category, product URLs, or item IDs. Returns prices, ratings, stock, seller, variants, breadcrumbs, and specifications. Optional per-review extraction. PPE pricing — $0.003 per product, $0.002 per review.", "version": "0.8", "x-build-id": "2bUl4ZMd6nP9k2TFf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~walmart-data-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-walmart-data-extractor", "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/khadinakbar~walmart-data-extractor/runs": { "post": { "operationId": "runs-sync-khadinakbar-walmart-data-extractor", "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/khadinakbar~walmart-data-extractor/run-sync": { "post": { "operationId": "run-sync-khadinakbar-walmart-data-extractor", "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": { "mode": { "title": "Mode", "enum": [ "search", "productUrls", "itemIds" ], "type": "string", "description": "Which extraction surface to scrape on Walmart.com. `search` runs a keyword search (returns search-card data — title, price, brand, rating, stock — for many products fast); `productUrls` fetches detail pages directly (returns full data — variants, specifications, image gallery, description — per URL); `itemIds` looks up each ID via the search engine and returns search-card data. Defaults to `search`.", "default": "search" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Free-text query run on Walmart's search engine (e.g., 'wireless headphones', 'samsung 65 inch tv'). Required when `mode = search`. To narrow by category, append a Walmart `cat_id` filter to the URL via the `sortBy` + filters fields, or include the category name in the keyword itself." }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Direct Walmart product detail URLs (e.g., `https://www.walmart.com/ip/JLab-Studio-2-Wireless-Headphones/13544111159`). Required when `mode = productUrls`. Each URL produces one full product record with variants, specifications, and image gallery. NOT search URLs — those use `mode = search`.", "items": { "type": "string" } }, "itemIds": { "title": "Walmart item IDs", "type": "array", "description": "Numeric Walmart item IDs (e.g., `13544111159`). Required when `mode = itemIds`. Each ID is resolved via Walmart's search engine (more reliable than the slug-less /ip/{id} URL which PerimeterX often blocks) and returned as a search-card record (title, price, brand, rating, stock, seller). For full detail with variants and specs, use `productUrls` with the canonical slug URL instead.", "items": { "type": "string" } }, "maxProducts": { "title": "Maximum products", "minimum": 1, "maximum": 500, "type": "integer", "description": "Upper bound on total products written to the dataset. Higher values cost more (each product is $0.003). The example prefill is intentionally small so Apify health checks finish quickly; raise it for production runs. Hard cap 500 — for larger jobs split into multiple runs to keep cost predictable.", "default": 50 }, "includeReviews": { "title": "Include customer reviews", "type": "boolean", "description": "When true, each product also fetches its customer reviews and pushes them as separate records into the dataset (each tagged `_type: review`). Reviews are charged separately at $0.002 each. Off by default.", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 1, "maximum": 200, "type": "integer", "description": "Upper bound on reviews scraped per product when `includeReviews = true`. Default 20. Hard cap 200 per product — most signal lives in the first 20 reviews.", "default": 20 }, "includeVariants": { "title": "Include variants", "type": "boolean", "description": "Include the `variants` array on product detail records (size/color/configuration options). Default true. Disable to shrink record size when variants aren't needed.", "default": true }, "includeSpecifications": { "title": "Include specifications", "type": "boolean", "description": "Include the `specifications` object on product detail records (manufacturer-supplied spec sheet). Default true. Disable to shrink record size when specs aren't needed.", "default": true }, "minPrice": { "title": "Minimum price (USD)", "minimum": 0, "type": "integer", "description": "Filter out products whose current price is below this value. Applied client-side; products without a parsed price are NOT filtered out. Omit for no lower bound." }, "maxPrice": { "title": "Maximum price (USD)", "minimum": 0, "type": "integer", "description": "Filter out products whose current price is above this value. Applied client-side; products without a parsed price are NOT filtered out. Omit for no upper bound." }, "brands": { "title": "Brand filter", "type": "array", "description": "Optional case-insensitive substring match against the product's brand (e.g., ['Apple', 'Samsung']). Products with a matching brand are kept; products with no brand attribute are dropped. Omit to disable brand filtering.", "items": { "type": "string" } }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "number", "description": "Filter out products with an average rating below this value (1.0–5.0). Products without ratings are NOT filtered. Omit to disable rating filtering." }, "sortBy": { "title": "Sort order", "enum": [ "bestMatch", "priceLow", "priceHigh", "rating", "newest", "bestSelling" ], "type": "string", "description": "Sort order applied to search results. Ignored for `productUrls` and `itemIds` modes. `bestMatch` = Walmart's default ranking; `priceLow`/`priceHigh` = price ascending/descending; `rating` = highest-rated first; `newest` = recently added; `bestSelling` = top sellers.", "default": "bestMatch" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy configuration. Defaults to Apify Residential proxies pinned to US — required because Walmart geo-locks pricing/availability and runs Akamai + PerimeterX. Override only if you have a specific reason (e.g., your own residential pool).", "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 } } } } } } } } } } ```