{ "openapi": "3.0.1", "info": { "title": "Swiggy Instamart Catalogue by Location", "description": "Every Swiggy Instamart product for a delivery location: category → subcategory → products with price, MRP, discount, in-stock state, purchase cap and a sponsored/ad flag.", "version": "0.1", "x-build-id": "Rfx993qpU93hsdlQS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ikmal_suzali_atr~instamart-catalog/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ikmal_suzali_atr-instamart-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~instamart-catalog/runs": { "post": { "operationId": "runs-sync-ikmal_suzali_atr-instamart-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~instamart-catalog/run-sync": { "post": { "operationId": "run-sync-ikmal_suzali_atr-instamart-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 categories whose name contains one of these strings (case-insensitive). Empty = all (~35).", "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" } }, "maxSubcategoriesPerCategory": { "title": "Max subcategories per category", "minimum": 0, "type": "integer", "description": "0 = all.", "default": 0 }, "delayMs": { "title": "Delay between listing calls (ms)", "minimum": 200, "type": "integer", "description": "Instamart degrades a session (empty pages, then a block page) after ~70 rapid calls; pace calls and let the actor re-mint sessions.", "default": 1000 }, "callsPerSession": { "title": "Calls per browser session", "minimum": 10, "type": "integer", "description": "Open a fresh browser session (new IP when using a rotating proxy) after this many listing calls.", "default": 50 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Residential IN proxy strongly recommended — Swiggy's WAF blocks an IP after repeated automated sessions. 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": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "IN" } }, "locations": { "title": "Locations (advanced)", "type": "array", "description": "Optional instead of pincodes: exact coordinates, e.g. [{\"lat\":28.4595,\"lng\":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 } } } } } } } } } }