{ "openapi": "3.0.1", "info": { "title": "Walmart Scraper - Products, Prices, Ratings, Sellers", "description": "Search Walmart and get products as clean rows: title, brand, model, UPC, category, rating, review count, availability, seller and the real current price from each product page. No browser and no CAPTCHA solving on your side.", "version": "0.1", "x-build-id": "Meu7iA1pgBMXzGUDS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s-r~walmart-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s-r-walmart-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/s-r~walmart-scraper/runs": { "post": { "operationId": "runs-sync-s-r-walmart-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/s-r~walmart-scraper/run-sync": { "post": { "operationId": "run-sync-s-r-walmart-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": { "mode": { "title": "What to scrape", "enum": [ "search", "reviews", "bestsellers" ], "type": "string", "description": "Search returns products for a query or category URL. Reviews returns one product's customer reviews. Bestsellers returns a category's best-seller chart, ranked by what Walmart sells.", "default": "search" }, "query": { "title": "Search term", "type": "string", "description": "Search mode: what to look for on walmart.com. Optional if you pass a URL." }, "url": { "title": "Walmart URL", "type": "string", "description": "A walmart.com URL to read instead: search or category in search mode, a product page in reviews mode, a category or chart in bestsellers mode. Takes precedence." }, "product_id": { "title": "Product id", "type": "string", "description": "Reviews mode: a Walmart item id such as 18656507313, or a product URL. Wins over the url field. Reviews come from walmart.com/reviews/product/." }, "category": { "title": "Category", "type": "string", "description": "Bestsellers mode: a department (beauty, electronics, home, grocery, toys...), a Walmart category id, or a walmart.com category URL. The chart is Walmart's own best-selling order." }, "sort": { "title": "Review sort", "enum": [ "relevancy", "helpful", "submission-desc", "submission-asc", "rating-desc", "rating-asc" ], "type": "string", "description": "Reviews mode: how Walmart orders the reviews. Wired server-side and confirmed by the sort the page echoes back. Helpfulness and both directions of date and rating are available.", "default": "relevancy" }, "rating_filter": { "title": "Only this star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Reviews mode: keep only reviews with this many stars, 1 to 5. Walmart filters stars in the browser only, so this is applied to the pages fetched and the summary says so." }, "max_reviews": { "title": "Maximum reviews", "minimum": 1, "maximum": 200, "type": "integer", "description": "Reviews mode: how many reviews to return, 1 to 200. Walmart serves 10 per page, so 200 costs 20 requests.", "default": 30 }, "fetch_prices": { "title": "Fetch product details", "type": "boolean", "description": "Search mode: open each product's own page to get its price, barcode (UPC), brand, seller, category path and description. Walmart serves none of these in search results. One extra request per product, so runs are much slower and cost more.", "default": false }, "limit": { "title": "Maximum products", "minimum": 1, "maximum": 600, "type": "integer", "description": "Search and bestsellers modes: how many rows to return, 1 to 600. A page carries about 40 to 60.", "default": 60 }, "retries": { "title": "Retries per page", "minimum": 1, "maximum": 6, "type": "integer", "description": "Retry attempts per page, each with a rotated identity and TLS fingerprint.", "default": 3 } } }, "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 } } } } } } } } } }