{ "openapi": "3.0.1", "info": { "title": "Food City Scraper: Store Prices, ValuCard Deals & Stock", "description": "Get Food City grocery products for a selected store or ZIP: price, regular price, ValuCard offers, sale dates, unit price, pack size and pickup stock where public. Search, categories or product URLs. About $0.004 per product: 1,000 products cost $4. No login.", "version": "1.0", "x-build-id": "Yjw25aVi5X6aJyeiN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/moggedhq~food-city-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-moggedhq-food-city-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/moggedhq~food-city-scraper/runs": { "post": { "operationId": "runs-sync-moggedhq-food-city-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/moggedhq~food-city-scraper/run-sync": { "post": { "operationId": "run-sync-moggedhq-food-city-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Find products such as milk, chicken or coffee. Each term is searched at every selected store. Leave empty when using only URLs or product IDs.", "items": { "type": "string" } }, "startUrls": { "title": "Category, deals or product URLs", "type": "array", "description": "Foodcity.com search/category, weekly savings or product URLs. Only K-VA-T Food City. Run storeIds or locations select the store; a URL store number does not override it.", "items": { "type": "string" } }, "productIds": { "title": "Product IDs", "type": "array", "description": "Food City retailer UPC/lookup keys from the final segment of product URLs, such as 0019347600001. Accepted keys are 8-14 digits. Supply strings and preserve leading zeros. These lookup IDs are not validated GTIN barcodes.", "items": { "type": "string" } }, "locations": { "title": "ZIP codes", "type": "array", "description": "US ZIP codes, such as 24210 or 37919. Resolves and echoes the first public grocery pickup store from Food City near each ZIP. storeIds take precedence. Empty uses the public locator default.", "items": { "type": "string" } }, "storeIds": { "title": "Store IDs", "type": "array", "description": "Exact Food City store numbers, such as 823 (Abingdon). Each store and every product/store link are checked. Store numbers in pasted URLs do not override your selection.", "items": { "type": "string" } }, "maxItemsPerSearch": { "title": "Maximum products per search and store", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum new product rows from each term, category or deals source at one store. Duplicates are free.", "default": 20 }, "maxItems": { "title": "Maximum products in this run", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Global limit across all products and stores. About $0.004 per product: 20 products cost about $0.08 plus the small start charge.", "default": 20 }, "dealsOnly": { "title": "Deals only", "type": "boolean", "description": "Keep source sale flags, weekly-ad products, public coupon badges and basket promotions. Coupon and minimum-spend conditions are retained separately and are not subtracted from price.", "default": false }, "includeDetails": { "title": "Include product details", "type": "boolean", "description": "Add slower product-page metadata such as ingredients and nutrition when public. No extra product fee. Stock is an online orderability signal, not an audited shelf count.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Uses the default datacenter pool first; fresh anonymous US residential sessions are a fallback after source refusals. Custom proxy settings are supported.", "default": { "useApifyProxy": true } }, "postalCodes": { "title": "ZIP codes (alias)", "type": "array", "description": "Alias for locations. Use locations when stacking this Actor with the US grocery family.", "items": { "type": "string" } }, "categoryUrls": { "title": "Category URLs (alias)", "type": "array", "description": "Optional alias for Food City search/category URLs. startUrls remains the family input name.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }