{ "openapi": "3.0.1", "info": { "title": "Walmart Reviews Scraper With Seller & Variant Details", "description": "Walmart Reviews Scraper extracts product reviews with seller and variant details, including ratings, review text, dates, verified purchase status, seller information, product variants, and product data. Ideal for review analysis, competitor research, and e-commerce insights.", "version": "0.1", "x-build-id": "Ijwbx8Usj7lX9mfqm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simpleapi~walmart-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simpleapi-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/simpleapi~walmart-reviews-scraper/runs": { "post": { "operationId": "runs-sync-simpleapi-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/simpleapi~walmart-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-simpleapi-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": { "walmartProducts": { "title": "๐Ÿ“ฆ Walmart Product URLs, Search URLs, or Keywords", "type": "array", "description": "๐Ÿ“‹ Add one item per line.\n\nโœ… Supported inputs:\nโ€ข ๐Ÿ”— Product URL (e.g. https://www.walmart.com/ip/product-name/123456)\nโ€ข ๐Ÿ”Ž Search URL (e.g. https://walmart.com/search?q=tshirt)\nโ€ข ๐Ÿง  Keyword (e.g. tshirt)\n\n๐Ÿ’ก Bulk input is supported.", "items": { "type": "string" } }, "startUrls": { "title": "๐Ÿ”— Legacy: Start URLs", "type": "array", "description": "๐Ÿ—‚๏ธ Legacy alias of walmartProducts, kept for backward compatibility with existing input JSON. Leave empty and use walmartProducts above for new runs.", "items": { "type": "string" } }, "maxReviewsPerItem": { "title": "๐Ÿงพ Maximum Reviews Per Product", "minimum": 0, "maximum": 1000, "type": "integer", "description": "๐ŸŽฏ Max reviews to extract per product. Example: 20 โ†’ up to 20 reviews per product. 0 = unlimited (bounded only by the real pagination ceiling)." }, "maxComments": { "title": "๐Ÿงพ Legacy: Maximum Reviews Per Product", "minimum": 0, "maximum": 1000, "type": "integer", "description": "๐Ÿ—‚๏ธ Legacy alias of maxReviewsPerItem, kept for backward compatibility with existing input JSON." }, "sortOrder": { "title": "๐Ÿ”€ Review Sort Order", "enum": [ "relevancy", "submission-desc", "helpful", "rating-desc", "rating-asc" ], "type": "string", "description": "๐Ÿ“‘ Choose review ordering:\nโ€ข โญ relevancy (most relevant)\nโ€ข ๐Ÿ†• submission-desc (newest first)\nโ€ข ๐Ÿ‘ helpful (most helpful)\nโ€ข โฌ†๏ธ rating-desc (highest rating first)\nโ€ข โฌ‡๏ธ rating-asc (lowest rating first)", "default": "relevancy" }, "maxProductsPerStartUrl": { "title": "๐Ÿ›๏ธ Maximum Products Per Search/Keyword", "minimum": 0, "maximum": 1000, "type": "integer", "description": "๐Ÿ›๏ธ For search URLs or keywords, limit how many products are processed from each entry.\n๐Ÿ’ก Higher values collect more data but increase run time.", "default": 10 }, "skipProductsWithoutReviews": { "title": "โญ๏ธ Skip Products Without Reviews", "type": "boolean", "description": "โšก Controls how zero-review products are logged during the run (skipped vs. shown with 0 reviews). Does not change which products are fetched.", "default": true }, "flagVariantMismatch": { "title": "๐Ÿ”Ž Flag Variant Mismatches", "type": "boolean", "description": "๐Ÿงฉ When enabled, each review is compared against the product you requested. If the review was actually written about a different color/size SKU, variantMismatch is set to true and the real reviewed item is identified. Default is enabled.", "default": true }, "includeReviewedItemDetails": { "title": "๐Ÿท๏ธ Include Reviewed Item Details", "type": "boolean", "description": "๐Ÿ“› When enabled, each review includes the reviewed SKU's own id, name, and image URL, plus the product id you requested โ€” so a variantMismatch can be explained, not just flagged. Default is enabled.", "default": true }, "includeSellerInfo": { "title": "๐Ÿช Include Seller & Fulfillment Info", "type": "boolean", "description": "๐Ÿฌ When enabled, each review includes who sold (soldBy) and who fulfilled (fulfilledBy) the reviewed item. Default is enabled.", "default": true }, "flagThirdPartySellers": { "title": "๐Ÿท๏ธ Flag Third-Party Sellers", "type": "boolean", "description": "๐Ÿ”– When enabled, each review includes isThirdPartySeller (true when soldBy/fulfilledBy is not Walmart itself). Real seller diversity shows up when a run covers several products across categories, not necessarily within one product's own review set. Default is enabled.", "default": true }, "proxyConfiguration": { "title": "๐ŸŒ Proxy Configuration", "type": "object", "description": "๐Ÿ›ก๏ธ Controls how requests reach Walmart. Enabled by default for reliable results across regions; disable to use a direct connection instead, or supply your own configuration." } } }, "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 } } } } } } } } } }