{ "openapi": "3.0.1", "info": { "title": "Walmart Reviews Scraper", "description": "Walmart Reviews Scraper — Extract Walmart product reviews including ratings, review text, usernames, dates, verified purchase status, helpful votes, product details, and review URLs. Useful for customer sentiment analysis, product research, competitor analysis, and e-commerce insights.", "version": "0.1", "x-build-id": "8wLSsB2x6mc1vlohK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fastdataapi~walmart-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fastdataapi-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/fastdataapi~walmart-reviews-scraper/runs": { "post": { "operationId": "runs-sync-fastdataapi-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/fastdataapi~walmart-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-fastdataapi-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "🔗 Walmart URLs, Keywords, or Search Terms", "type": "array", "description": "Add one item per line.\n\nSupported inputs:\n- Product URL (e.g. https://www.walmart.com/ip/product-name/123456) or a product's review page link\n- Search, browse or category URL (e.g. https://walmart.com/search?q=tshirt)\n- Keyword (e.g. tshirt), searched on Walmart\n\nLinks to other websites are skipped and listed in the log. Plain strings and { \"url\": \"...\" } objects are both accepted.", "items": { "type": "string" } }, "sortOrder": { "title": "🔃 Review Sort Order", "enum": [ "relevancy", "submission-desc", "helpful", "rating-desc", "rating-asc", "submission-asc" ], "type": "string", "description": "Order in which each product's reviews are collected: most relevant, most helpful, newest, oldest, highest rating or lowest rating first.", "default": "relevancy" }, "maxComments": { "title": "🔢 Maximum Reviews Per Product", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of reviews saved per product. A product with fewer written reviews returns all it has.\n\nFree plan: up to 20 reviews per run (all products together) and 200 per month; paid plans have no limit.\n\nDefault is 5.", "default": 5 }, "maxProductsPerStartUrl": { "title": "🔢 Maximum Products Per Start URL", "minimum": 0, "maximum": 1000, "type": "integer", "description": "For search, browse, category URLs and keywords: how many products are taken from each one, in the order Walmart lists them. Colour and size variants that share one set of reviews count once.\n\n0 takes every product the listing shows. Default is 10.", "default": 10 }, "skipProductsWithoutReviews": { "title": "✅ Skip Products Without Reviews", "type": "boolean", "description": "When on, products that show no reviews in the listing are left out and do not count towards Maximum Products Per Start URL, so the run moves straight to products that have reviews. When off, they are opened and counted too (they return no rows).", "default": true }, "proxyConfiguration": { "title": "🌐 Proxy", "type": "object", "description": "With a proxy selected, every request goes through it on a new connection. With the proxy off, the run starts on a direct connection and switches to the Apify US residential proxy as soon as Walmart blocks it." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }