{ "openapi": "3.0.1", "info": { "title": "Walmart Product & Reviews Scraper", "description": "Walmart product details (price, stock, seller, UPC, specs, variants) and every review with verified-only, star, date, keyword and photo filters. Monitoring mode charges only for new reviews. No login, errors never charged.", "version": "0.1", "x-build-id": "ZmgMFzQIrOkby5ePM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/metqo~walmart-product-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-metqo-walmart-product-reviews", "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/metqo~walmart-product-reviews/runs": { "post": { "operationId": "runs-sync-metqo-walmart-product-reviews", "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/metqo~walmart-product-reviews/run-sync": { "post": { "operationId": "run-sync-metqo-walmart-product-reviews", "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": { "products": { "title": "Walmart products", "type": "array", "description": "Walmart item IDs (e.g. 604342441), product URLs (walmart.com/ip/...) or review URLs (walmart.com/reviews/product/...).", "items": { "type": "string" } }, "scrapeProductDetails": { "title": "Include product details", "type": "boolean", "description": "One record per product: price, was-price, stock, seller, seller rating, UPC, specs, variants, delivery date, rating breakdown.", "default": true }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 0, "maximum": 5000, "type": "integer", "description": "0 = product details only. Up to 5,000.", "default": 100 }, "sort": { "title": "Sort reviews by", "enum": [ "submission-desc", "submission-asc", "helpful", "relevancy", "rating-desc", "rating-asc" ], "type": "string", "description": "Order in which reviews are collected. Newest first is needed for 'Reviews since' and monitoring mode.", "default": "submission-desc" }, "stars": { "title": "Only these star ratings", "type": "array", "description": "e.g. [1, 2] for complaints only. Empty = all stars.", "default": [] }, "verifiedOnly": { "title": "Verified purchases only", "type": "boolean", "description": "Only reviews from verified purchases.", "default": false }, "withMediaOnly": { "title": "Only reviews with photos or videos", "type": "boolean", "description": "Only reviews that include photos or videos.", "default": false }, "reviewsSince": { "title": "Reviews since (date)", "type": "string", "description": "YYYY-MM-DD. Stops at older reviews. Needs sort = Newest first." }, "keywords": { "title": "Keywords", "type": "array", "description": "Keep only reviews whose title or text contains any of these words (case-insensitive).", "items": { "type": "string" } }, "topics": { "title": "Review topics", "type": "array", "description": "Walmart's own review topics, e.g. \"Freshness\", \"Value For Money\", \"Quality\", \"Battery Life\". Filtered by Walmart itself, so it's fast. Every run lists each product's topics with mention counts in its summary row.", "items": { "type": "string" } }, "onlyNewReviews": { "title": "Monitoring mode: only new reviews", "type": "boolean", "description": "Skip reviews delivered by your earlier runs of this actor, and stop paging once caught up. You pay only for new reviews. Best with sort = Newest first on a schedule.", "default": false }, "includePersonalInfo": { "title": "Include reviewer name and location", "type": "boolean", "description": "Off by default. Enable only if you have a lawful basis under GDPR/CCPA.", "default": false }, "maxAgeHours": { "title": "Maximum data age (hours)", "minimum": 0, "maximum": 720, "type": "integer", "description": "Data fetched by anyone in the last N hours may be returned instantly from our cache (same price, faster, each row marked fromCache). 0 = always fetch live.", "default": 24 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many products to process in parallel.", "default": 3 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "US residential proxies are recommended.", "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 }, "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 } } } } } } } } } }