{ "openapi": "3.0.1", "info": { "title": "Walmart API | Product, Seller, Price and Review Data", "description": "Walmart API for product search, product details, customer reviews and marketplace seller offers. Built for Walmart price tracking and seller monitoring, with reliability on the seller lookup where competing tools fail most. Works as a Walmart scraper, pay per result billing, MCP ready for AI agents.", "version": "0.0", "x-build-id": "sHgPgbt0mtm9FKO3u" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/johnvc~walmart-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-johnvc-walmart-api", "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/johnvc~walmart-api/runs": { "post": { "operationId": "runs-sync-johnvc-walmart-api", "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/johnvc~walmart-api/run-sync": { "post": { "operationId": "run-sync-johnvc-walmart-api", "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", "required": [ "search_mode" ], "properties": { "search_mode": { "title": "Search mode", "enum": [ "search", "product", "reviews", "sellers" ], "type": "string", "description": "What to fetch. 'Search' finds products by keyword and returns both ids you need for the other modes. 'Product' returns full detail for one product. 'Reviews' returns customer reviews. 'Sellers' returns every seller offering the product, which is the mode most competing tools handle badly.", "default": "search" }, "query": { "title": "Search query", "type": "string", "description": "Required when search mode is 'search'. The keyword to search for, such as 'laptop', 'coffee maker' or 'running shoes'. Ignored in the other modes." }, "item_id": { "title": "Product or item ID", "type": "string", "description": "The Walmart item to look up in product, reviews or sellers mode. Use the numeric usItemId (like 14894095), which every search result row includes and which works in all three modes, or paste a walmart.com product URL. The alphanumeric productId still works in product and sellers modes, but Walmart reassigns it over time, so a stored one can stop resolving. Reviews mode accepts only the usItemId. To look up many items in one run, use Item IDs below." }, "item_ids": { "title": "Item IDs (batch)", "maxItems": 100, "type": "array", "description": "Look up many items in one run, up to 100. Same ids as above: usItemIds or walmart.com product URLs work best. Duplicates are skipped, each id is billed only for the rows it returns, and an id that fails gets its own error row while the rest carry on.", "items": { "type": "string" } }, "store_id": { "title": "Store ID", "type": "string", "description": "Optional, used by sellers mode only. Pricing and availability are store specific. Leave blank to use the default store, or copy the storeId returned on every search result row to match a particular location." }, "max_results": { "title": "Maximum results", "minimum": 1, "maximum": 2000, "type": "integer", "description": "How many rows to return before stopping. Search returns up to about 50 products per upstream call and reviews returns 20 per call, so the Actor pages automatically until it reaches this number or the source runs out. In reviews mode the limit applies to each item. Product mode always returns exactly one row per item.", "default": 100 } } }, "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 } } } } } } } } } }