{ "openapi": "3.0.1", "info": { "title": "Kroger Scraper: Weekly Ad Deals & Card Prices by ZIP", "description": "Monitor Kroger, Ralphs, Fred Meyer, King Soopers, Harris Teeter and other banners' weekly-ad deals by ZIP: advertised and card prices, conditions, original prices, images and dates for daily or weekly tracking. About $0.0035 per ad observation. No login.", "version": "1.0", "x-build-id": "EBsyGfwuhQ8ql8lua" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vant47~kroger-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vant47-kroger-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/vant47~kroger-scraper/runs": { "post": { "operationId": "runs-sync-vant47-kroger-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/vant47~kroger-scraper/run-sync": { "post": { "operationId": "run-sync-vant47-kroger-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": { "banner": { "title": "Store banner", "enum": [ "kroger", "ralphs", "fredmeyer", "kingsoopers", "harristeeter", "frys", "smiths", "qfc", "dillons", "marianos", "picknsave", "food4less", "citymarket", "bakersplus", "gerbes" ], "type": "string", "description": "One banner per run. This private partial build reads regional weekly ads, not exact-store catalog prices.", "default": "kroger" }, "searchTerms": { "title": "Product names in current ads", "type": "array", "description": "Match current regional ad titles, for example cheese, chicken or coffee. Use * for all current priced ad entries. This is a limited ad assortment; native Kroger catalog search is unavailable.", "items": { "type": "string" } }, "startUrls": { "title": "Weekly-ad or deal URLs", "type": "array", "description": "Weekly-ad or deal landing URLs of the selected banner select all current regional ad items. Native product and category URLs are unavailable in this partial build.", "items": { "type": "string" } }, "productIds": { "title": "Ad item IDs", "type": "array", "description": "Only flyer: identifiers from a previous output are supported. These identify ad entries, not native Kroger UPCs or catalog SKUs.", "items": { "type": "string" } }, "locations": { "title": "Regional ZIP codes", "type": "array", "description": "Five-digit US ZIP codes, such as 45202. Selects regional ads. It does not verify prices at an exact store. Empty locations produce a free note.", "items": { "type": "string" } }, "storeIds": { "title": "Exact store IDs (unavailable)", "type": "array", "description": "Retained for family input compatibility. Exact-store pricing is unavailable; requesting store IDs returns a free note and no substituted regional prices.", "items": { "type": "string" } }, "maxItemsPerSearch": { "title": "Maximum observations per source and ZIP", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Limit for each search term or all-ads source at a ZIP. Repeated ad IDs are delivered and charged once per run.", "default": 20 }, "maxItems": { "title": "Maximum observations in this run", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Global distinct ad-observation cap. About $0.0035 each; 20 cost about $0.07 plus the small start charge.", "default": 20 }, "dealsOnly": { "title": "Deals only", "type": "boolean", "description": "Every supported result is a regional weekly-ad offer. Card and purchase conditions remain separate; no account coupons are clipped.", "default": true }, "includeDetails": { "title": "Include extra ad details", "type": "boolean", "description": "Add supplied ad description, disclaimer, specifications and features in details. Price conditions and dates are always included, with no extra event fee.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Default: direct HTTP from the run datacenter. Enable Apify proxy or supply custom proxies if needed. When this field is omitted, retries progress through direct datacenter, datacenter proxy and US residential.", "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 }, "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 } } } } } } } } } }