{ "openapi": "3.0.1", "info": { "title": "Instacart Scraper", "description": "[💰 $10 / 1K] Scrape Instacart products by keyword for any US delivery ZIP — names, brands, prices, sizes, images, availability, and dietary info. Search multiple terms at once; results reflect real location-based pricing.", "version": "1.0", "x-build-id": "5VI9UFZaXWseOyZdk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~instacart-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-instacart-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/solidcode~instacart-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-instacart-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/solidcode~instacart-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-instacart-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": "Plain keywords to search Instacart for, such as 'milk', 'organic eggs' or 'olive oil'. We build the search for you — no need to create URLs. Add as many terms as you like; each one runs its own search across the stores you choose.", "items": { "type": "string" } }, "postalCode": { "title": "Delivery ZIP Code", "pattern": "^\\d{5}$", "type": "string", "description": "US ZIP code for the delivery area you want prices for (e.g. '10001' for Manhattan). This genuinely controls the location: results come from the stores that deliver to this ZIP, with that area's real prices. Every result also reports the ZIP it was collected for. Leave empty to use an approximate location detected automatically (enter a ZIP for precise, location-specific pricing)." }, "streetAddress": { "title": "Street Address (optional)", "type": "string", "description": "Optional street address for a more precise delivery point within the ZIP (e.g. '350 5th Ave, New York'). Leave empty to use the ZIP's centre. Most searches only need the ZIP." }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of products to return in total, across all search terms and stores. Set to 0 to collect everything available. Results are collected in batches and complete batches are always kept, so the final count can slightly exceed this number (you are never charged less than the data you receive). Tip: start with 20-100 to test, then increase." }, "inStockOnly": { "title": "In-stock products only", "type": "boolean", "description": "When on, only products currently available to order are returned (products marked out of stock are skipped).", "default": false }, "retailers": { "title": "Limit to specific stores (optional)", "type": "array", "description": "Optionally search only specific stores by their Instacart store slug, e.g. 'costco', 'safeway', 'cvs', 'walmart', 'sprouts'. Matching is case-insensitive. Leave empty to automatically search the top 3 stores available for your ZIP (a good, fast default). The stores available depend on the location, so a slug that exists in one area may not exist in another; unavailable slugs are skipped with a note in the log.", "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 } } }, "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 } } } } } } } } } }