{ "openapi": "3.0.1", "info": { "title": "Blinkit Catalogue by Location", "description": "Every Blinkit product for a delivery location: category → subcategory → products with price, MRP, discount, live inventory count and sold-out state. Give it lat/lon (or pincode centroids) and get the whole store.", "version": "0.1", "x-build-id": "X4odAAitGYrsWiUax" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ikmal_suzali_atr~blinkit-catalog/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ikmal_suzali_atr-blinkit-catalog", "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/ikmal_suzali_atr~blinkit-catalog/runs": { "post": { "operationId": "runs-sync-ikmal_suzali_atr-blinkit-catalog", "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/ikmal_suzali_atr~blinkit-catalog/run-sync": { "post": { "operationId": "run-sync-ikmal_suzali_atr-blinkit-catalog", "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": { "pincodes": { "title": "Pincodes", "type": "array", "description": "Indian 6-digit pincodes to scrape, e.g. 122002. Each is resolved to the pincode's centre and the platform picks the store serving it. Pincodes with no store nearby are reported as failed locations, never as another city's data.", "items": { "type": "string" } }, "categoryFilter": { "title": "Category filter", "type": "array", "description": "Optional: only scrape top-level categories whose name contains one of these strings (case-insensitive), e.g. `[\"Munchies\", \"Cold Drinks\"]`. Empty = all categories.", "items": { "type": "string" } }, "subcategories": { "title": "Subcategories", "type": "array", "description": "Only scrape these subcategories (case-insensitive name match, or the subcategory id). Empty = all subcategories in the selected categories.", "items": { "type": "string" } }, "maxSubcategoriesPerLocation": { "title": "Max subcategories per location", "minimum": 0, "type": "integer", "description": "0 = all (a Blinkit store has ~350 subcategories).", "default": 0 }, "delayMs": { "title": "Delay between listing calls (ms)", "minimum": 200, "type": "integer", "description": "Blinkit rate-limits per IP: ~6 requests/s triggers 429 within 30 calls, while one call every 2–3 s ran 100+ calls with zero 429s. Lower this only when using a rotating residential proxy.", "default": 2200 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Blinkit is behind Cloudflare; residential IPs work. Apify residential proxy (country IN) recommended for more than one location per run. Each minted session is pinned to one proxy exit IP (Apify Proxy sessions; for custom proxy URLs put `{session}` where your provider takes a session id) — the site binds its anti-bot state to the minting IP, so a per-request rotating gateway kills sessions within a few calls.", "default": { "useApifyProxy": false } }, "chainId": { "title": "Blinkit chain id", "type": "integer", "description": "Merchant chain used for the category tree (1383 = Blinkit).", "default": 1383 }, "locations": { "title": "Locations (advanced)", "type": "array", "description": "Optional instead of pincodes: exact coordinates, e.g. [{\"lat\":28.4595,\"lon\":77.0266,\"label\":\"Gurgaon DLF\"}]." } } }, "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 } } } } } } } } } }