{ "openapi": "3.0.1", "info": { "title": "Walmart Reviews Scraper - Product Review Extraction", "description": "Extract Walmart product reviews at scale. Scrape review text, star ratings, verified status, helpful votes, photos, pros, cons, and rating breakdowns. Search by URL or keyword. Filter by rating, sort by date or relevance. Great for product research and sentiment analysis.", "version": "1.0", "x-build-id": "MZmAhO3fTu6ndgO80" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sovereigntaylor~walmart-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sovereigntaylor-walmart-reviews-scraper", "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/sovereigntaylor~walmart-reviews-scraper/runs": { "post": { "operationId": "runs-sync-sovereigntaylor-walmart-reviews-scraper", "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/sovereigntaylor~walmart-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-sovereigntaylor-walmart-reviews-scraper", "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": { "productUrls": { "title": "Product URLs", "type": "array", "description": "List of Walmart product page URLs to scrape reviews from. Examples: 'https://www.walmart.com/ip/Apple-AirPods-Pro-2nd-Generation/1752657021', 'https://www.walmart.com/ip/12345'. You can paste full URLs with query parameters — the product ID will be extracted automatically.", "default": [ "https://www.amazon.com/dp/B0BSHF7WHW" ], "items": { "type": "string" } }, "searchQuery": { "title": "Product Search Query", "type": "string", "description": "Search Walmart for products matching this keyword. Reviews will be scraped from the top search results. Use this when you don't have specific product URLs. Examples: 'wireless headphones', 'air fryer', 'gaming laptop'.", "default": "coffee shop" }, "maxReviews": { "title": "Max Reviews Per Product", "minimum": 0, "maximum": 50000, "type": "integer", "description": "Maximum number of reviews to scrape per product. Walmart shows 20 reviews per page. Set to 0 for unlimited (caution: popular products can have 10K+ reviews). Recommended: 100-500 for most use cases.", "default": 10 }, "sortBy": { "title": "Sort Reviews By", "enum": [ "recent", "highest", "lowest", "relevant" ], "type": "string", "description": "How to sort the reviews before scraping. 'Most Recent' gets the newest reviews first. 'Highest Rating' gets 5-star reviews first. 'Lowest Rating' gets 1-star reviews first. 'Most Relevant' uses Walmart's default relevance algorithm.", "default": "relevant" }, "verifiedOnly": { "title": "Verified Purchases Only", "type": "boolean", "description": "If enabled, only scrape reviews from verified purchasers. Verified reviews are from people who actually bought the item on Walmart. Default: false (scrape all reviews).", "default": false }, "maxSearchResults": { "title": "Max Search Results", "minimum": 1, "maximum": 50, "type": "integer", "description": "When using searchQuery, how many products from search results to scrape reviews for. Increase for broader coverage. Only relevant when searchQuery is provided.", "default": 5 }, "minRating": { "title": "Minimum Star Rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only scrape reviews with this rating or higher (1-5). Set to 1 to get all reviews. Set to 4 to get only positive reviews.", "default": 1 }, "maxRating": { "title": "Maximum Star Rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only scrape reviews with this rating or lower (1-5). Set to 5 to get all reviews. Set to 2 to get only negative reviews.", "default": 5 }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum number of concurrent page requests. Walmart has bot detection — lower values are safer but slower. Recommended: 2-5.", "default": 3 }, "maxRetries": { "title": "Max Retries Per Page", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many times to retry a failed page request before giving up. Retries use different User-Agents and longer delays.", "default": 5 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Recommended: Use Apify proxies for reliable results. Walmart may block datacenter IPs. Residential proxies provide the best success rates.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }