{ "openapi": "3.0.1", "info": { "title": "Walmart Product & Price Scraper: Categories, UPC, Sellers", "description": "Scrape Walmart.com products from category, shop, brand and product links: price, was price, stock, rating, reviews, seller (Walmart or marketplace), category path and images, plus brand, UPC, specifications and variants from product pages. No login, no browser. Pay per product.", "version": "0.1", "x-build-id": "nZm1BvFqhifGmnzqq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~walmart-product-price-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-walmart-product-price-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/themineworks~walmart-product-price-scraper/runs": { "post": { "operationId": "runs-sync-themineworks-walmart-product-price-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/themineworks~walmart-product-price-scraper/run-sync": { "post": { "operationId": "run-sync-themineworks-walmart-product-price-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": { "categoryUrls": { "title": "Category links", "type": "array", "description": "Walmart.com category links, one per line: a category (https://www.walmart.com/browse/...), a shop or deals page (/shop/...), a department page (/cp/...) or a brand page (/brand/...). Filters and a sort order in the link are passed to Walmart unchanged. Search links (/search?q=...) are not accepted because Walmart's robots.txt disallows them; open the category on walmart.com and paste its link instead. Up to 100 per run.", "items": { "type": "string" } }, "productUrls": { "title": "Product links or ids", "type": "array", "description": "Walmart.com product links (https://www.walmart.com/ip//) or bare item ids (the number at the end of the link), one per line. Each is read from its product page, with brand, UPC, specifications and variants. Up to 5,000 per run; the same product given twice is read once.", "items": { "type": "string" } }, "maxProductsPerCategory": { "title": "Products per category link", "minimum": 1, "maximum": 500, "type": "integer", "description": "Most products to return from each category link, in the order Walmart lists them. Walmart shows about 40 products a page and 10 pages to a visitor who is not logged in, so one link gives about 400 at most. For more, add the same category with another sort order (for example ?sort=price_high) or its subcategories; a product found twice in one run is delivered once. A department or brand page (/cp/, /brand/) that is not a category list gives the products in its carousels, usually 20 to 80.", "default": 100 }, "fetchDetails": { "title": "Open each product's page", "type": "boolean", "description": "Also open the product page of every product found on a category page, for brand, UPC, model, specifications, 1 to 5 star counts, every image and every variant with its price. Slower, since each product is one more page. Product links are always read from their product page.", "default": false }, "sort": { "title": "Sort order", "enum": [ "best_match", "best_seller", "price_low", "price_high", "rating_high", "new" ], "type": "string", "description": "Order of the category list. A sort already in a link is kept.", "default": "best_match" }, "skipSponsored": { "title": "Skip sponsored products", "type": "boolean", "description": "Leave out the sponsored (advertised) products Walmart places among a category's products. When kept, they carry is_sponsored: true.", "default": false } } }, "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 } } } } } } } } } }