{ "openapi": "3.0.1", "info": { "title": "Walmart Grocery Prices Scraper", "description": "Scrape Walmart grocery prices by department: shelf price, was price, savings and the unit price per ounce, plus rating, availability, in-store aisle and pickup or delivery windows. Filter by brand, special diet, SNAP EBT, rollback and star rating. No proxy needed.", "version": "0.1", "x-build-id": "rvB1xmzvEzZskDB92" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~walmart-grocery-prices-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-walmart-grocery-prices-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/parseforge~walmart-grocery-prices-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-walmart-grocery-prices-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/parseforge~walmart-grocery-prices-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-walmart-grocery-prices-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": { "departments": { "title": "Grocery Departments", "uniqueItems": true, "type": "array", "description": "Walmart grocery departments to collect. Every department is paged until Max Items is reached. Leave empty and use Walmart URLs instead if you want a specific aisle.", "items": { "type": "string", "enum": [ "all-food", "bakery-bread", "baking", "beverages", "breakfast-cereal", "candy", "coffee", "condiments-sauces-spices", "dairy-eggs", "deli", "dietary-lifestyle", "fresh-produce", "frozen-foods", "grab-and-go", "international-food", "meat-seafood", "organic-shop", "pantry", "protein-foods", "seasonal-grocery", "snacks-cookies-chips", "alcohol" ], "enumTitles": [ "All Food", "Bakery & Bread", "Baking", "Beverages", "Breakfast & Cereal", "Candy", "Coffee", "Condiments, Sauces & Spices", "Dairy & Eggs", "Deli", "Dietary & Lifestyle Shop", "Fresh Produce", "Frozen Foods", "Grab & Go", "International Food", "Meat & Seafood", "Organic Shop", "Pantry", "Protein Foods", "Seasonal Grocery", "Snacks, Cookies & Chips", "Alcohol" ] } }, "startUrls": { "title": "Walmart Category URLs", "type": "array", "description": "Any Walmart.com grocery category URL copied from your browser, for example https://www.walmart.com/browse/food/dairy-eggs/976759_9176907 or https://www.walmart.com/cp/dairy-eggs/9176907. Each URL is paged like a department. Product (/ip/) and search (/search) URLs are not supported: Walmart shields those two paths.", "items": { "type": "string" } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000. The budget is split evenly across the departments and URLs you selected." }, "includeSubcategories": { "title": "Expand Into Subcategories", "type": "boolean", "description": "Walmart caps any one category at 24 pages (about 1,150 products). Turn this on to walk the department's own subcategory list and page each aisle separately, which is the only way to get past that ceiling.", "default": false }, "sortBy": { "title": "Sort By", "enum": [ "best_match", "price_low", "price_high", "best_seller", "rating_high", "new" ], "type": "string", "description": "Result order, exactly as Walmart's own sort menu.", "default": "best_match" }, "minPrice": { "title": "Min Price (USD)", "minimum": 0, "type": "integer", "description": "Only return products priced at or above this amount." }, "maxPrice": { "title": "Max Price (USD)", "minimum": 0, "type": "integer", "description": "Only return products priced at or below this amount." }, "brands": { "title": "Brands", "type": "array", "description": "Brand names exactly as Walmart spells them on the filter panel, for example Great Value or Kerrygold. Several brands are combined with OR.", "items": { "type": "string" } }, "dietaryNeeds": { "title": "Special Diet Needs", "uniqueItems": true, "type": "array", "description": "Walmart's own dietary filter. Which values a department offers varies, so a value that department does not carry returns nothing rather than everything.", "items": { "type": "string", "enum": [ "Organic", "Gluten-Free", "Non-GMO", "High Protein", "Dairy-Free", "Sugar-Free", "Low Sugar", "Low Glycemic", "Vegan", "Keto Friendly" ], "enumTitles": [ "Organic", "Gluten-Free", "Non-GMO", "High Protein", "Dairy-Free", "Sugar-Free", "Low Sugar", "Low Glycemic", "Vegan", "Keto Friendly" ] } }, "snapEbtOnly": { "title": "SNAP EBT Eligible Only", "type": "boolean", "description": "Only return products Walmart flags as payable with SNAP EBT. Applied server-side by Walmart's own Benefit Programs filter; the listing tiles themselves do not carry a trustworthy per-item SNAP flag, so this filter is the reliable way to get that set.", "default": false }, "dealsOnly": { "title": "Deals Only", "enum": [ "", "Rollback", "Clearance" ], "type": "string", "description": "Restrict to products Walmart currently marks as a Rollback or as Clearance.", "default": "" }, "minCustomerRating": { "title": "Minimum Customer Rating", "enum": [ "", "4 - 5 Stars", "3 - 3.9 Stars" ], "type": "string", "description": "Walmart's star-band filter.", "default": "" }, "retailerType": { "title": "Sold By", "enum": [ "", "Walmart", "Pro Sellers", "Marketplace Sellers fulfilled by Walmart" ], "type": "string", "description": "Restrict to items sold by Walmart itself, or to marketplace sellers.", "default": "" }, "inStockOnly": { "title": "In Stock Only", "type": "boolean", "description": "Hide items Walmart reports as unavailable at the serving store.", "default": false }, "facet": { "title": "Raw Facet Filter (advanced)", "type": "string", "description": "Walmart's raw facet string, appended to whatever the boxes above produce. Same value the site puts in the URL when you tick a filter, for example food_form:Sticks or container_type:Bag||flavor:Original." }, "includeFulfillment": { "title": "Include Fulfillment & Aisle", "type": "boolean", "description": "Adds the pickup and delivery windows, fulfillment methods, the serving store id and the in-store aisle location (for example A28).", "default": false }, "includeBadges": { "title": "Include Badges & Promos", "type": "boolean", "description": "Adds Walmart's tile badges as text: Rollback, Clearance, best seller, SNAP EBT eligible, Walmart+ and any promo line.", "default": false }, "includeSeller": { "title": "Include Seller", "type": "boolean", "description": "Adds seller name, seller id, seller type and the offer id.", "default": false }, "includeCategoryTree": { "title": "Include Category Tree", "type": "boolean", "description": "Adds one row per subcategory Walmart lists under each department, with its category id and URL. Useful to pick the exact aisle for a later run.", "default": false }, "includePriceSummary": { "title": "Include Price Summary", "type": "boolean", "description": "Adds one summary row per category with the min, max, average and median price of the products collected from it, plus the share on rollback and out of stock.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Walmart's category pages answer direct requests, so the proxy is off by default. Switch to Apify residential proxies if your runs start seeing the 'Robot or human?' challenge.", "default": { "useApifyProxy": 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 } } }, "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 } } } } } } } } } }