{ "openapi": "3.0.1", "info": { "title": "Blinkit Products & Prices Scraper", "description": "Scrape Blinkit product data by search term, category or product URL: prices, MRP, discounts, pack sizes, stock levels, delivery ETAs and ratings — for any Indian city, PIN code or coordinates.", "version": "1.1", "x-build-id": "PT8mhogQ7OiTeGGVD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zapticx~blinkit-products-prices-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zapticx-blinkit-products-prices-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/zapticx~blinkit-products-prices-scraper/runs": { "post": { "operationId": "runs-sync-zapticx-blinkit-products-prices-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/zapticx~blinkit-products-prices-scraper/run-sync": { "post": { "operationId": "run-sync-zapticx-blinkit-products-prices-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 terms", "type": "array", "description": "What to search for on Blinkit — the same words you would type into its search box. One term per line. Example: chocolate, Amul milk, Red Bull.", "items": { "type": "string" } }, "locations": { "title": "Delivery locations", "type": "array", "description": "Where to price the products. Blinkit charges different prices and holds different stock in each city, so add several to compare them side by side. Accepts a city or locality name (Delhi, Koramangala), a 6-digit PIN code (110001) or exact coordinates (28.6139,77.2090). Major cities and their PIN codes resolve to a city-level point; other places are matched with Blinkit's own location search and used only on an exact match — pass coordinates when you need a particular local store.", "default": [ "Delhi" ], "items": { "type": "string" } }, "maxResults": { "title": "Max products per location", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stops each location once it has this many products. With 3 locations and a limit of 100 you get up to 300 rows. Start small to preview the data, then raise it.", "default": 50 }, "categories": { "title": "Categories", "type": "array", "description": "Scrape whole categories instead of, or as well as, searching. Enter a category name (ice cream, chips, atta) or paste a category URL from Blinkit such as https://blinkit.com/cn/munchies/cid/1237/940. Names are matched against Blinkit's live category list; if a name is ambiguous the run tells you which categories it meant.", "default": [], "items": { "type": "string" } }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Track specific products. Paste Blinkit product links such as https://blinkit.com/prn/amul-gold-milk/prid/14639. Each one is checked in every location you listed, which is the quickest way to compare one product across cities.", "default": [], "items": { "type": "string" } }, "brandFilter": { "title": "Only these brands", "type": "array", "description": "Keep only products whose Blinkit brand matches one of these names, e.g. Amul, Cadbury (case-insensitive, whole words, so Amul also keeps Amul Gold). The product name is used only when Blinkit gives no brand. Leave empty to keep everything. If Blinkit returns products but none match, the run still succeeds, returns no rows and says which filter removed them.", "default": [], "items": { "type": "string" } }, "includeOutOfStock": { "title": "Include out-of-stock products", "type": "boolean", "description": "Keep products the local store has run out of. Useful for tracking stockouts; turn off if you only want products a customer could buy right now.", "default": true }, "includeSponsored": { "title": "Include sponsored products", "type": "boolean", "description": "Blinkit mixes paid placements into its results. They are always marked with isSponsored so you can filter them later — turn this off to leave them out of the dataset entirely.", "default": true }, "maxRequestRetries": { "title": "Max retries per request", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many times to retry a request that fails before giving up on it. The default suits almost every run.", "default": 3 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Blinkit refuses connections from data-centre servers, so runs need residential proxies. This is already set up correctly — leave it as it is unless you have your own proxy setup.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }