{ "openapi": "3.0.1", "info": { "title": "Walmart Price & Stock Monitor — Products, Sellers, Buy Box", "description": "Track Walmart product prices, rollbacks, stock status and marketplace-seller competition. Give it your own item IDs or URLs and re-run on a schedule to watch prices move — or discover products from Walmart's own sitemaps. Unit prices, discounts, buy-box offer counts. Company-level data only.", "version": "1.0", "x-build-id": "HRnYeogJ1LeW52ByL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mochiboo~walmart-product-price-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mochiboo-walmart-product-price-monitor", "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/mochiboo~walmart-product-price-monitor/runs": { "post": { "operationId": "runs-sync-mochiboo-walmart-product-price-monitor", "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/mochiboo~walmart-product-price-monitor/run-sync": { "post": { "operationId": "run-sync-mochiboo-walmart-product-price-monitor", "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": { "productUrls": { "title": "Walmart product URLs", "type": "array", "description": "Walmart product-page URLs to monitor, e.g. https://www.walmart.com/ip/Redken-Extreme-Length-Shampoo-10-1-oz/620196775 . This is the main way to use the actor: paste your own watch-list and re-run it on a schedule to track price and stock changes. Leave empty to discover products from Walmart's sitemap instead.", "default": [], "items": { "type": "string" } }, "itemIds": { "title": "Walmart item IDs", "type": "array", "description": "Walmart item IDs (the number at the end of a product URL), e.g. 620196775. Equivalent to productUrls but shorter to store in a spreadsheet or database.", "default": [], "items": { "type": "string" } }, "discoverFromSitemap": { "title": "Discover products from Walmart's sitemap", "type": "boolean", "description": "When no URLs or item IDs are supplied, pull products from Walmart's own published sitemaps. Walmart disallows crawling its search pages, so its sitemaps are the only sanctioned way to discover products — this actor never touches /search or /api/.", "default": true }, "sitemapType": { "title": "Which sitemap to discover from", "enum": [ "high-interest", "long-tail" ], "type": "string", "description": "high-interest = popular items (measured: 43% sold by marketplace sellers, 95% carry ratings, 24% have competing offers). long-tail = the broad catalogue (nearly all sold by Walmart itself, ~9% carry ratings). Only used when no URLs or item IDs are supplied.", "default": "high-interest" }, "maxResults": { "title": "Maximum products", "minimum": 1, "type": "integer", "description": "Maximum number of product pages to fetch in this run.", "default": 20 }, "onlyInStock": { "title": "Only in-stock products", "type": "boolean", "description": "Skip products that are out of stock or unavailable.", "default": false }, "minDiscountPercent": { "title": "Minimum discount %", "minimum": 0, "type": "integer", "description": "Only return products discounted by at least this percentage off their was-price. 0 disables the filter. Note that most Walmart items carry no was-price at any given moment, so a non-zero value here will return few rows.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Apify Proxy is strongly recommended — Walmart intermittently serves a page shell without product data, and rotating IPs plus the actor's built-in retries keep the miss rate low.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }