{ "openapi": "3.0.1", "info": { "title": "Zepto Catalogue by Location", "description": "Every Zepto product for a delivery location, category by category, with price, MRP, discount, live available quantity and out-of-stock state.", "version": "0.1", "x-build-id": "QWGIgOywSPJ2z2XJr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ikmal_suzali_atr~zepto-catalog/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ikmal_suzali_atr-zepto-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~zepto-catalog/runs": { "post": { "operationId": "runs-sync-ikmal_suzali_atr-zepto-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~zepto-catalog/run-sync": { "post": { "operationId": "run-sync-ikmal_suzali_atr-zepto-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 slug/name contains one of these strings (case-insensitive). Empty = all.", "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" } }, "maxPagesPerCategory": { "title": "Max pages per category", "minimum": 0, "type": "integer", "description": "Safety cap on pagination per category (0 = until Zepto reports endOfPage).", "default": 0 }, "delayMs": { "title": "Delay between API calls (ms)", "minimum": 100, "type": "integer", "description": "Delay between API calls (ms).", "default": 400 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "REQUIRED in practice: Zepto blocks an IP after ~5 automated page loads (HTTP 202 WAF). Use Apify residential proxy, country IN. 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,\"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 } } } } } } } } } }