{ "openapi": "3.0.1", "info": { "title": "Walmart Products Scraper", "description": "Scrape Walmart product search results, prices, ratings, availability, brands, sellers, and URLs.", "version": "0.1", "x-build-id": "cWN3LXifsRtCedrq4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~walmart-products-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-walmart-products-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/fetch_cat~walmart-products-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-walmart-products-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/fetch_cat~walmart-products-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-walmart-products-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": { "searchQueries": { "title": "Search queries", "maxItems": 100, "type": "array", "description": "Walmart product search phrases to scrape, such as iphone, coffee maker, or lego.", "items": { "type": "string", "maxLength": 500 } }, "searchUrls": { "title": "Walmart search URLs", "maxItems": 100, "type": "array", "description": "Optional public Walmart search result URLs to scrape. Use this when you already have category/search URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "Maximum products", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Total number of Walmart products to save across all queries and URLs.", "default": 20 }, "pageLimit": { "title": "Pages per query", "minimum": 1, "maximum": 25, "type": "integer", "description": "How many Walmart search pages to request for each query. Keep this low for quick test runs.", "default": 1 }, "sort": { "title": "Sort order", "enum": [ "best_match", "price_low", "price_high", "best_seller", "rating_high", "new" ], "type": "string", "description": "Optional Walmart search sorting preference.", "default": "best_match" }, "includeSponsored": { "title": "Include sponsored products", "type": "boolean", "description": "Turn off to exclude products Walmart marks as sponsored.", "default": true }, "connectionMode": { "title": "Connection", "enum": [ "direct", "automatic" ], "type": "string", "description": "Automatic tries direct mobile access once, then one ordinary Apify datacenter request, then at most one Apify Unblocker request if retries are enabled. Large independent single-page batches can fetch up to three sources concurrently; small or tightly budgeted runs remain sequential. No browser or repeated paid retries are used in Automatic. Proxy traffic can incur additional usage costs. Direct makes one request with no proxy or paid fallback. Explicit legacy proxyConfiguration settings always take precedence, including opt-outs and customer proxies. Use at most 100 combined search sources. Processing is limited to four minutes independently of the platform timeout.", "default": "automatic" }, "maxRequestRetries": { "title": "Retries per page", "minimum": 0, "maximum": 10, "type": "integer", "description": "Upper retry limit within the shared four-minute processing budget. Automatic uses one ordinary datacenter fallback, then one managed Unblocker fallback that may retry once only after a timeout or brief temporary failure when this ceiling and the original deadline allow; zero disables fallback. Direct does not retry. Explicit legacy proxy overrides retain their configured retry policy and one browser attempt after an exhausted challenge. Explicit UNBLOCKER uses one request without session/country selection or browser fanout.", "default": 10 }, "requestTimeoutSecs": { "title": "Request timeout", "minimum": 10, "maximum": 120, "type": "integer", "description": "Maximum wait for direct and legacy proxy attempts. Automatic direct access is capped at eight seconds; the ordinary datacenter fallback uses this value. Managed Unblocker attempts reserve at least 60 seconds (up to this value if higher), always within the shared four-minute processing limit.", "default": 30 }, "requestDelayMs": { "title": "Delay between pages", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Polite delay between successful page requests. Increase this for larger scheduled runs.", "default": 500 }, "proxyConfiguration": { "title": "Saved proxy settings (optional override)", "type": "object", "description": "Optional legacy/API override, taking precedence over Connection. Existing managed groups/country and HTTP(S) customer proxy pools remain supported. useApifyProxy:false without customer URLs stays direct. Customer URLs are used from the first attempt without managed fallback. An omitted override uses Connection. Invalid settings fail before requests or charging." } } }, "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 } } } } } } } } } }