{ "components": { "schemas": { "ZeptoPlaceAutocompleteExecuteRequest": { "additionalProperties": false, "example": { "capability": "zepto.place.autocomplete", "input": { "limit": 3, "query": "Indiranagar Bengaluru" } }, "properties": { "capability": { "enum": [ "zepto.place.autocomplete" ], "type": "string" }, "input": { "$ref": "#/components/schemas/ZeptoPlaceAutocompleteInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 180000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "ZeptoPlaceResolveInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Input for resolving a place by query or place ID, returning both place details and Zepto location info.", "properties": { "limit": { "minimum": 1, "type": "integer" }, "max_records": { "minimum": 1, "type": "integer" }, "place_id": { "description": "Google Maps place ID to resolve directly.", "type": "string" }, "query": { "description": "Place name or address to search for.", "type": "string" } }, "title": "ResolvePlaceInput", "type": "object" }, "JobPendingResponse": { "additionalProperties": false, "properties": { "capability": { "enum": [ "zepto.ads", "zepto.categories", "zepto.category.products", "zepto.health", "zepto.location", "zepto.place.autocomplete", "zepto.place.details", "zepto.place.resolve", "zepto.product", "zepto.search", "zepto.search.filters" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "zepto" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "state": { "enum": [ "queued", "running", "retrying" ], "type": "string" } }, "required": [ "job_id", "request_id", "platform", "capability", "state" ], "type": "object" }, "ZeptoCategoryProductsInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Input for listing products within a Zepto category or subcategory.", "properties": { "category_id": { "description": "Zepto category ID to browse.", "type": "string" }, "latitude": { "description": "Latitude for location-based store resolution.", "type": "number" }, "limit": { "default": 20, "description": "Maximum number of products to return per page.", "maximum": 100, "minimum": 1, "type": "integer" }, "longitude": { "description": "Longitude for location-based store resolution.", "type": "number" }, "max_pages": { "default": 10, "description": "Maximum number of pages to fetch.", "maximum": 20, "minimum": 1, "type": "integer" }, "max_records": { "minimum": 1, "type": "integer" }, "page_number": { "default": 1, "description": "One-based page number to start from.", "minimum": 1, "type": "integer" }, "store_id": { "description": "Zepto store ID. Defaults to the public Bangalore sample store.", "type": "string" }, "subcategory_id": { "description": "Zepto subcategory ID to browse.", "type": "string" }, "url": { "description": "Direct URL to a Zepto category page.", "type": "string" } }, "title": "ListCategoryProductsInput", "type": "object" }, "ZeptoLocationCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "zepto.location" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "zepto" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee.", "example": { "location_eta_in_minutes": 4, "location_eta_serviceable": true, "location_latitude": 12.96902, "location_longitude": 77.75395, "location_secondary_store_ids": [ "0059ff6a-7eb0-477a-a7f5-69256f2c444b" ], "location_serviceable": true, "location_source_url": "https://bff-gateway.zepto.com/lms/api/v2/get_page?latitude=12.96902&longitude=77.75395&page_type=HOME&version=v2&show_new_eta_banner=true&page_size=3&enforce_platform_type=DESKTOP", "location_store_id": "b4dc8d65-ed2e-4142-81b6-373982b13500", "location_store_ids": [ "b4dc8d65-ed2e-4142-81b6-373982b13500", "0059ff6a-7eb0-477a-a7f5-69256f2c444b" ] } }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "ZeptoSearchFiltersInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Input for fetching available search filters for a query.", "properties": { "latitude": { "description": "Latitude for location-based store resolution.", "type": "number" }, "limit": { "minimum": 1, "type": "integer" }, "longitude": { "description": "Longitude for location-based store resolution.", "type": "number" }, "max_records": { "minimum": 1, "type": "integer" }, "query": { "description": "Search query to get filters for.", "type": "string" }, "store_id": { "description": "Zepto store ID. Defaults to the public Bangalore sample store.", "type": "string" } }, "required": [ "query" ], "title": "SearchFiltersInput", "type": "object" }, "ZeptoProductCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "zepto.product" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "zepto" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee.", "example": { "product": { "available_quantity": 4, "brand": "Fruits", "brand_id": "d396c794-de67-421c-9af1-dc36df2c2471", "country_of_origin": "India", "description": "The water of a tender coconut is nothing, but the endosperm of the coconut and it is one of the most nutritious beverages available to us. This nutritious water is what matures and forms the flesh of the coconut over time. Tender coconut water is the liquid and not the milk of the coconut.", "discount_percent": 49, "discounted_selling_price_paise": 8100, "formatted_pack_size": "1 pc", "image_path": "cms/product_variant/c3a49c51-d6bd-4298-8af4-092a10bcd4c3.jpeg", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/c3a49c51-d6bd-4298-8af4-092a10bcd4c3.jpeg", "image_urls": [ "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/c3a49c51-d6bd-4298-8af4-092a10bcd4c3.jpeg", "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/038d5d99-2081-46d2-89aa-14f34d3e77bb.jpeg", "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/1fbea0e4-38a2-45e1-aa69-f5a5c5f6b7a4.jpeg" ], "is_active": true, "l3_category_id": "464cd640-d308-418e-9ad2-37e3973e511d", "max_allowed_quantity": 6, "mrp_paise": 16100, "name": "Tender Coconut", "pack_size": 1, "product_id": "29c55962-65c9-4a04-87fc-406edce13b27", "product_url": "https://www.zepto.com/pn/tender-coconut/pvid/b9fbf0e7-de2d-4a89-ae74-b12a7c0ab236", "product_variant_id": "b9fbf0e7-de2d-4a89-ae74-b12a7c0ab236", "quantity": 4, "shelf_life_in_hours": "3 days", "source_url": "https://www.zepto.com/pn/product/pvid/b9fbf0e7-de2d-4a89-ae74-b12a7c0ab236", "store_product_id": "ff391715-6e8b-5a21-9caa-6cd7df7ccc02", "unit_of_measure": "PIECE", "weight_in_gms": 58 } } }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "ZeptoAdsExecuteRequest": { "additionalProperties": false, "example": { "capability": "zepto.ads", "input": { "latitude": 12.96902, "limit": 5, "longitude": 77.75395, "page_type": "HOME" } }, "properties": { "capability": { "enum": [ "zepto.ads" ], "type": "string" }, "input": { "$ref": "#/components/schemas/ZeptoAdsInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 180000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "ZeptoCategoriesExecuteRequest": { "additionalProperties": false, "example": { "capability": "zepto.categories", "input": { "latitude": 12.96902, "longitude": 77.75395 } }, "properties": { "capability": { "enum": [ "zepto.categories" ], "type": "string" }, "input": { "$ref": "#/components/schemas/ZeptoCategoriesInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 180000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "ZeptoPlaceDetailsInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Input for fetching details of a specific place.", "properties": { "limit": { "minimum": 1, "type": "integer" }, "max_records": { "minimum": 1, "type": "integer" }, "place_id": { "description": "Google Maps place ID to look up.", "type": "string" } }, "required": [ "place_id" ], "title": "PlaceDetailsInput", "type": "object" }, "ZeptoSearchFiltersExecuteRequest": { "additionalProperties": false, "example": { "capability": "zepto.search.filters", "input": { "latitude": 12.96902, "longitude": 77.75395, "query": "rice" } }, "properties": { "capability": { "enum": [ "zepto.search.filters" ], "type": "string" }, "input": { "$ref": "#/components/schemas/ZeptoSearchFiltersInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 180000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "JobBilling": { "additionalProperties": false, "properties": { "credits_charged": { "anyOf": [ { "description": "Actual credits charged. Null only when retained historical facts cannot establish the amount.", "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "credits_per_unit": { "anyOf": [ { "description": "Snapshotted price for one billed unit. Zero only for historical free work; null when unknown.", "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "model": { "enum": [ "per_request", "per_record", "free", "unknown" ], "type": "string" }, "pricing": { "additionalProperties": false, "properties": { "rule_id": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ] }, "scope": { "anyOf": [ { "enum": [ "module", "platform", "capability" ], "type": "string" }, { "type": "null" } ] }, "source": { "enum": [ "manifest", "price_book" ], "type": "string" }, "version": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ] } }, "required": [ "source", "scope", "version", "rule_id" ], "type": "object" }, "units": { "anyOf": [ { "description": "Billed units under the stated model. Null when units do not apply or cannot be established.", "minimum": 0, "type": "integer" }, { "type": "null" } ] } }, "required": [ "model", "units", "credits_per_unit", "credits_charged", "pricing" ], "type": "object" }, "UnauthorizedError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "unauthorized", "type": "string" }, "message": { "enum": [ "authentication required", "invalid bearer token", "missing bearer token" ], "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "ZeptoSearchInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Input for searching Zepto products by keyword.", "properties": { "latitude": { "description": "Latitude for location-based store resolution.", "type": "number" }, "limit": { "default": 20, "description": "Maximum number of products to return per page.", "maximum": 100, "minimum": 1, "type": "integer" }, "longitude": { "description": "Longitude for location-based store resolution.", "type": "number" }, "max_pages": { "default": 10, "description": "Maximum number of pages to fetch.", "maximum": 20, "minimum": 1, "type": "integer" }, "max_records": { "minimum": 1, "type": "integer" }, "page_number": { "default": 0, "description": "Zero-based page number to start from.", "minimum": 0, "type": "integer" }, "query": { "description": "Search query string.", "type": "string" }, "store_id": { "description": "Zepto store ID. Defaults to the public Bangalore sample store.", "type": "string" } }, "required": [ "query" ], "title": "SearchProductsInput", "type": "object" }, "JobStats": { "additionalProperties": false, "properties": { "duration_ms": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "failed": { "const": 0, "type": "integer" }, "passed": { "const": 1, "type": "integer" }, "total": { "const": 1, "type": "integer" } }, "required": [ "total", "passed", "failed", "duration_ms" ], "type": "object" }, "ZeptoSearchExecuteRequest": { "additionalProperties": false, "example": { "capability": "zepto.search", "input": { "limit": 5, "query": "rice" } }, "properties": { "capability": { "enum": [ "zepto.search" ], "type": "string" }, "input": { "$ref": "#/components/schemas/ZeptoSearchInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 180000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "InternalError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "internal_error", "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "CredentialsRequiredError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "credentials_required", "type": "string" }, "message": { "const": "this capability requires authentication credentials; save them via POST /credentials", "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "ZeptoHealthInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Input for running a Zepto scraper health check.", "properties": { "latitude": { "description": "Latitude for location-based health check.", "type": "number" }, "limit": { "minimum": 1, "type": "integer" }, "longitude": { "description": "Longitude for location-based health check.", "type": "number" }, "max_records": { "minimum": 1, "type": "integer" } }, "title": "HealthInput", "type": "object" }, "ZeptoHealthCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "zepto.health" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "zepto" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee.", "example": { "ads_category_count": 1, "ads_category_ok": true, "ads_home_count": 1, "ads_home_ok": true, "categories_count": 238, "categories_ok": true, "first_error": "parse error: decode JSON: unexpected end of JSON input", "location_ok": true, "location_store_id": "b4dc8d65-ed2e-4142-81b6-373982b13500", "status": "degraded" } }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "ZeptoHealthExecuteRequest": { "additionalProperties": false, "example": { "capability": "zepto.health", "input": { "latitude": 12.96902, "longitude": 77.75395 } }, "properties": { "capability": { "enum": [ "zepto.health" ], "type": "string" }, "input": { "$ref": "#/components/schemas/ZeptoHealthInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 180000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "JobErrorObject": { "additionalProperties": false, "properties": { "code": { "description": "Machine-readable error code (e.g. forbidden, not_found, invalid_input, upstream_timeout, upstream_error).", "type": "string" }, "message": { "description": "Human-readable error description.", "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "ValidationErrors": { "additionalProperties": false, "properties": { "errors": { "additionalProperties": { "items": { "type": "string" }, "type": "array" }, "type": "object" } }, "required": [ "errors" ], "type": "object" }, "ZeptoCategoryProductsCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "zepto.category.products" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "zepto" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee.", "example": { "count": 5, "page_number": 1, "pages_fetched": 1, "results": [ { "discount_amount_paise": 8700, "unit_of_measure": "PIECE", "discounted_selling_price_paise": 7800, "product_type": "SELLABLESKU", "image_path": "cms/product_variant/fa6acfce-a598-4f3e-aa28-eb94df49d743.png", "weight_in_gms": 58, "country_of_origin": "India", "store_product_id": "8e03ba55-b787-5b9b-9dc6-6fafd06228cd", "discount_percent": 52, "max_allowed_quantity": 6, "mrp_paise": 16500, "description": "Custard apple is a tropical fruit that grows mostly in tropical climates. The fruits are heart-shaped with light green exterior and smooth creamy white flesh and are well-known for their exquisite taste. The fruit is high in carbs, minerals, and a good source of vitamin c.", "cached": true, "name": "Custard Apple Semi Ripe", "source_url": "https://bff-gateway.zepto.com/product-assortment-service/api/v2/store-products-by-store-subcategory-id?category_id=64374cfe-d06f-4a01-898e-c07c46462c36&page_number=1&store_id=b4dc8d65-ed2e-4142-81b6-373982b13500&subcategory_id=09e63c15-e5f7-4712-9ff8-513250b79942", "brand_id": "d396c794-de67-421c-9af1-dc36df2c2471", "available_quantity": 6, "quantity": 6, "pack_size": 2, "category_id": "64374cfe-d06f-4a01-898e-c07c46462c36", "l3_category_id": "5942b588-81c1-4195-afca-f776c8c4c094", "rank": 1, "brand": "Fruits", "formatted_pack_size": "2 pcs (360 - 450 g)", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/fa6acfce-a598-4f3e-aa28-eb94df49d743.png", "product_variant_id": "b5cb2914-895d-4b3e-86d0-9bd9f9234428", "store_id": "b4dc8d65-ed2e-4142-81b6-373982b13500", "image_urls": [ "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/fa6acfce-a598-4f3e-aa28-eb94df49d743.png" ], "is_primary": true, "primary_subcategory_id": "09e63c15-e5f7-4712-9ff8-513250b79942", "product_id": "31e25f4a-c334-4c8a-acce-10a6a0677aed", "selling_price_paise": 7800, "is_active": true, "product_url": "https://www.zepto.com/pn/custard-apple-semi-ripe/pvid/b5cb2914-895d-4b3e-86d0-9bd9f9234428", "shelf_life_in_hours": "4 days" }, { "discount_amount_paise": 4100, "unit_of_measure": "PIECE", "discounted_selling_price_paise": 3100, "product_type": "SELLABLESKU", "image_path": "cms/product_variant/2ee02a46-99b9-4fc7-b389-0e881c02fe56.jpeg", "weight_in_gms": 200, "country_of_origin": "India", "store_product_id": "44cd61e6-c62a-5661-99c0-e2ac41309cb9", "discount_percent": 56, "max_allowed_quantity": 6, "mrp_paise": 7200, "cached": true, "name": "Banana Robusta", "source_url": "https://bff-gateway.zepto.com/product-assortment-service/api/v2/store-products-by-store-subcategory-id?category_id=64374cfe-d06f-4a01-898e-c07c46462c36&page_number=1&store_id=b4dc8d65-ed2e-4142-81b6-373982b13500&subcategory_id=09e63c15-e5f7-4712-9ff8-513250b79942", "brand_id": "d69ba762-dfca-47f4-8e52-d09a6d1ffbd0", "available_quantity": 6, "quantity": 6, "pack_size": 4, "category_id": "64374cfe-d06f-4a01-898e-c07c46462c36", "l3_category_id": "d16cc33d-74e8-480d-9414-5dc06cdb47ea", "rank": 2, "brand": "Unbranded", "formatted_pack_size": "4 pcs", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/2ee02a46-99b9-4fc7-b389-0e881c02fe56.jpeg", "product_variant_id": "436c0025-de54-4748-a189-79e292f26071", "store_id": "b4dc8d65-ed2e-4142-81b6-373982b13500", "image_urls": [ "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/2ee02a46-99b9-4fc7-b389-0e881c02fe56.jpeg" ], "is_primary": true, "primary_subcategory_id": "09e63c15-e5f7-4712-9ff8-513250b79942", "product_id": "c6bce5f8-a70b-4806-99c1-c2b8df503e1a", "selling_price_paise": 3100, "is_active": true, "product_url": "https://www.zepto.com/pn/banana-robusta/pvid/436c0025-de54-4748-a189-79e292f26071", "shelf_life_in_hours": "3 days" }, { "discount_amount_paise": 7600, "unit_of_measure": "GRAM", "discounted_selling_price_paise": 7300, "product_type": "SELLABLESKU", "image_path": "cms/product_variant/cf8f80c4-1b42-46bc-a3cf-55360cd418e9.jpeg", "weight_in_gms": 500, "country_of_origin": "India", "store_product_id": "22ba089c-c0c2-5d4a-b4d6-d11d823b088f", "discount_percent": 51, "max_allowed_quantity": 6, "mrp_paise": 14900, "description": "Elaichi bananas might be small in size but are equally nutritious as any regular-sized banana. These dwarf bananas contain far lesser calories than regular bananas, which aids metabolism. Elaichi banana also helps the body maintain a regular heartbeat, lower blood pressure and a proper balance of water in the body.", "cached": true, "name": "Banana Elaichi (Yelakki)", "source_url": "https://bff-gateway.zepto.com/product-assortment-service/api/v2/store-products-by-store-subcategory-id?category_id=64374cfe-d06f-4a01-898e-c07c46462c36&page_number=1&store_id=b4dc8d65-ed2e-4142-81b6-373982b13500&subcategory_id=09e63c15-e5f7-4712-9ff8-513250b79942", "brand_id": "d69ba762-dfca-47f4-8e52-d09a6d1ffbd0", "available_quantity": 6, "quantity": 6, "pack_size": 500, "category_id": "64374cfe-d06f-4a01-898e-c07c46462c36", "l3_category_id": "d16cc33d-74e8-480d-9414-5dc06cdb47ea", "rank": 3, "brand": "Unbranded", "formatted_pack_size": "500 g", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/cf8f80c4-1b42-46bc-a3cf-55360cd418e9.jpeg", "product_variant_id": "db471557-f745-4574-9e82-1916a88d9e6b", "store_id": "b4dc8d65-ed2e-4142-81b6-373982b13500", "image_urls": [ "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/cf8f80c4-1b42-46bc-a3cf-55360cd418e9.jpeg" ], "is_primary": true, "primary_subcategory_id": "09e63c15-e5f7-4712-9ff8-513250b79942", "product_id": "89412b09-5a51-45b0-bb76-83a520cad0c8", "selling_price_paise": 7300, "is_active": true, "product_url": "https://www.zepto.com/pn/banana-elaichi-yelakki/pvid/db471557-f745-4574-9e82-1916a88d9e6b", "shelf_life_in_hours": "3 days" } ], "source_url": "https://bff-gateway.zepto.com/product-assortment-service/api/v2/store-products-by-store-subcategory-id?category_id=64374cfe-d06f-4a01-898e-c07c46462c36&page_number=1&store_id=b4dc8d65-ed2e-4142-81b6-373982b13500&subcategory_id=09e63c15-e5f7-4712-9ff8-513250b79942" } }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "QuotaError": { "oneOf": [ { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "account_inactive", "type": "string" }, "message": { "const": "an active paid account is required", "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "quota_exhausted", "type": "string" }, "message": { "const": "request quota exhausted for current billing period", "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" } ] }, "JobFailedResponse": { "additionalProperties": false, "properties": { "capability": { "enum": [ "zepto.ads", "zepto.categories", "zepto.category.products", "zepto.health", "zepto.location", "zepto.place.autocomplete", "zepto.place.details", "zepto.place.resolve", "zepto.product", "zepto.search", "zepto.search.filters" ], "type": "string" }, "error": { "$ref": "#/components/schemas/JobErrorObject" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "zepto" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "type": "null" }, "state": { "const": "failed", "type": "string" }, "stats": { "type": "null" }, "success": { "const": false, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "error", "results", "stats" ], "type": "object" }, "ZeptoCategoriesInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Input for listing Zepto product categories.", "properties": { "latitude": { "description": "Latitude for location-based store resolution.", "type": "number" }, "limit": { "minimum": 1, "type": "integer" }, "longitude": { "description": "Longitude for location-based store resolution.", "type": "number" }, "max_records": { "minimum": 1, "type": "integer" }, "store_id": { "description": "Zepto store ID. Defaults to the public Bangalore sample store.", "type": "string" } }, "title": "ListCategoriesInput", "type": "object" }, "ExecuteNetwork": { "additionalProperties": false, "properties": { "session_id": { "description": "Optional explicit session identifier.", "minLength": 1, "type": "string" }, "session_key": { "description": "Optional stable key used to derive a reusable session.", "minLength": 1, "type": "string" }, "sticky": { "description": "Whether the request should reuse the resolved session.", "type": "boolean" } }, "type": "object" }, "ZeptoAdsInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Input for listing Zepto ad placements.", "properties": { "category_id": { "description": "Category ID (relevant when page_type is CATEGORY).", "type": "string" }, "latitude": { "description": "Latitude for location-based store resolution.", "type": "number" }, "limit": { "default": 20, "description": "Maximum number of ad placements to return.", "maximum": 100, "minimum": 1, "type": "integer" }, "longitude": { "description": "Longitude for location-based store resolution.", "type": "number" }, "max_records": { "minimum": 1, "type": "integer" }, "page_type": { "default": "HOME", "description": "Type of page to fetch ads for.", "enum": [ "HOME", "SEARCH", "CATEGORY" ], "type": "string" }, "query": { "description": "Search query (relevant when page_type is SEARCH).", "type": "string" }, "store_id": { "description": "Zepto store ID. Defaults to the public Bangalore sample store.", "type": "string" }, "subcategory_id": { "description": "Subcategory ID (relevant when page_type is CATEGORY).", "type": "string" }, "url": { "description": "Direct URL to a Zepto page for ad context.", "type": "string" } }, "title": "ListAdsInput", "type": "object" }, "ZeptoLocationInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Input for resolving a Zepto delivery location from geographic coordinates.", "properties": { "latitude": { "description": "Latitude of the delivery location.", "type": "number" }, "limit": { "minimum": 1, "type": "integer" }, "longitude": { "description": "Longitude of the delivery location.", "type": "number" }, "max_records": { "minimum": 1, "type": "integer" } }, "required": [ "latitude", "longitude" ], "title": "ResolveLocationInput", "type": "object" }, "ExecuteAcceptedResponse": { "additionalProperties": false, "properties": { "capability": { "enum": [ "zepto.ads", "zepto.categories", "zepto.category.products", "zepto.health", "zepto.location", "zepto.place.autocomplete", "zepto.place.details", "zepto.place.resolve", "zepto.product", "zepto.search", "zepto.search.filters" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "zepto" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "state": { "const": "queued", "type": "string" } }, "required": [ "job_id", "request_id", "platform", "capability", "state" ], "type": "object" }, "ZeptoAdsCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "zepto.ads" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "zepto" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee.", "example": { "count": 5, "location_eta_in_minutes": 4, "location_eta_serviceable": true, "location_latitude": 12.96902, "location_longitude": 77.75395, "location_secondary_store_ids": [ "0059ff6a-7eb0-477a-a7f5-69256f2c444b" ], "location_serviceable": true, "location_source_url": "https://bff-gateway.zepto.com/lms/api/v2/get_page?latitude=12.96902&longitude=77.75395&page_type=HOME&version=v2&show_new_eta_banner=true&page_size=3&enforce_platform_type=DESKTOP", "location_store_id": "b4dc8d65-ed2e-4142-81b6-373982b13500", "location_store_ids": [ "b4dc8d65-ed2e-4142-81b6-373982b13500", "0059ff6a-7eb0-477a-a7f5-69256f2c444b" ], "page_type": "HOME", "results": [ { "element_id": "422c1cbe-a5b5-4118-9c6b-f7c6251fced3", "element_name": "Everyday lowest price", "element_position_inside_widget": 1, "element_type": "BANNER", "image_path": "inventory/banner/601180a6-b82f-499b-a24f-c079904e9f53.png", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/inventory/banner/601180a6-b82f-499b-a24f-c079904e9f53.png", "page_type": "HOME", "placement_type": "banner", "position_in_list": 1, "rank": 1, "source_url": "https://bff-gateway.zepto.com/lms/api/v2/get_page?enforce_platform_type=DESKTOP&latitude=12.96902&longitude=77.75395&page_size=20&page_type=HOME&show_new_eta_banner=true&version=v2", "widget_id": "100000357", "widget_name": "WEB_PAAN_OLSX", "widget_position": 80, "widget_type": "BANNER_GRID" }, { "deeplink_url": "https://www.zepto.com/cn/paan-corner/cigarettes/cid/cd50825e-baf8-47fe-9abc-ed9556122a9a/scid/5bcbee47-7c83-4279-80f0-7ecc068496df", "element_id": "bad6912d-f8a8-4fa6-9bd7-b5cc63a521ef", "element_name": "Paan", "element_position_inside_widget": 2, "element_type": "BANNER", "image_path": "inventory/banner/85b9411e-fa0e-427f-96ec-97fd4d13aaed.png", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/inventory/banner/85b9411e-fa0e-427f-96ec-97fd4d13aaed.png", "page_type": "HOME", "placement_type": "banner", "position_in_list": 2, "rank": 2, "source_url": "https://bff-gateway.zepto.com/lms/api/v2/get_page?enforce_platform_type=DESKTOP&latitude=12.96902&longitude=77.75395&page_size=20&page_type=HOME&show_new_eta_banner=true&version=v2", "widget_id": "100000357", "widget_name": "WEB_PAAN_OLSX", "widget_position": 80, "widget_type": "BANNER_GRID" }, { "discount_amount_paise": 4000, "is_sponsored": true, "discounted_selling_price_paise": 22000, "element_position_inside_widget": 1, "pc_tags_json": "{}", "image_path": "cms/product_variant/17235b1c-37cf-4232-8a0b-c12784b07e17.jpg", "pricing_campaigns_json": "{\"pricingEntityPrices\":[{\"discountedSellingPrice\":22000,\"pricingEntity\":\"SUPER_SAVER\"}]}", "element_id": "8f5eb151-9e1a-5f53-a171-299f6f539d9e", "items_left": 4, "store_product_id": "8f5eb151-9e1a-5f53-a171-299f6f539d9e", "primary_category_name": "Cleaning Essentials", "element_type": "PRODUCT", "product_name": "Rin Matic Top Load Detergent Liquid | Pouch", "discount_percent": 15, "widget_name": "Laundry_Care_HORIZONTAL_LIST", "campaign_name": "bachat", "mrp_paise": 26000, "source_url": "https://bff-gateway.zepto.com/lms/api/v2/get_page?enforce_platform_type=DESKTOP&latitude=12.96902&longitude=77.75395&page_size=20&page_type=HOME&show_new_eta_banner=true&version=v2", "primary_subcategory_name": "Liquid Detergents & Additives", "category_id": "1a7e46a8-e627-450f-8960-490b550eeee6", "rank": 3, "brand": "Rin", "formatted_pack_size": "1 pack (2 kg)", "widget_id": "24238", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/17235b1c-37cf-4232-8a0b-c12784b07e17.jpg", "product_variant_id": "5f54bb83-f3e0-4d8d-89b0-6339f3312089", "store_id": "b4dc8d65-ed2e-4142-81b6-373982b13500", "placement_type": "sponsored_product", "primary_subcategory_id": "dfb37880-b40f-4783-9502-a56e12edbabc", "product_id": "4ad95205-6122-41b2-b5af-f18f187f924b", "selling_price_paise": 22000, "page_type": "HOME", "product_url": "https://www.zepto.com/pn/rin-matic-top-load-detergent-liquid-pouch/pvid/5f54bb83-f3e0-4d8d-89b0-6339f3312089", "widget_type": "HORIZONTAL_LIST", "widget_position": 270, "position_in_list": 1 } ], "source_url": "https://bff-gateway.zepto.com/lms/api/v2/get_page?enforce_platform_type=DESKTOP&latitude=12.96902&longitude=77.75395&page_size=20&page_type=HOME&show_new_eta_banner=true&version=v2" } }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "ZeptoPlaceResolveCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "zepto.place.resolve" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "zepto" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee.", "example": { "city": "Bengaluru", "country": "India", "country_code": "IN", "district": "Bengaluru Urban", "formatted_address": "Indiranagar, Bengaluru, Karnataka, India", "latitude": 12.9783692, "locality": "Indiranagar", "location_eta_in_minutes": 12, "location_eta_serviceable": true, "location_latitude": 12.9783692, "location_longitude": 77.6408356, "location_serviceable": true, "location_source_url": "https://bff-gateway.zepto.com/lms/api/v2/get_page?latitude=12.9783692&longitude=77.6408356&page_type=HOME&version=v2&show_new_eta_banner=true&page_size=3&enforce_platform_type=DESKTOP", "location_store_id": "5b1796e1-36c2-4ae9-83a0-c03c25cac05a", "location_store_ids": [ "5b1796e1-36c2-4ae9-83a0-c03c25cac05a" ], "location_type": "APPROXIMATE", "longitude": 77.6408356, "place_id": "ChIJkQN3GKQWrjsRNhBQJrhGD7U", "query": "Indiranagar Bengaluru", "source_url": "https://bff-gateway.zepto.com/api/v1/maps/place/details/?place_id=ChIJkQN3GKQWrjsRNhBQJrhGD7U&session_token=aae244b8-7164-42ab-a0de-671480b892c2", "state": "Karnataka", "state_code": "KA", "types": "political sublocality sublocality_level_1" } }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "ZeptoProductInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Input for fetching a single Zepto product.", "properties": { "latitude": { "description": "Latitude for location-based store resolution.", "type": "number" }, "limit": { "minimum": 1, "type": "integer" }, "longitude": { "description": "Longitude for location-based store resolution.", "type": "number" }, "max_records": { "minimum": 1, "type": "integer" }, "pvid": { "description": "Zepto product variant ID.", "type": "string" }, "store_id": { "description": "Zepto store ID. Defaults to the public Bangalore sample store.", "type": "string" }, "url": { "description": "Direct URL to a Zepto product page.", "type": "string" } }, "title": "GetProductInput", "type": "object" }, "ZeptoLocationExecuteRequest": { "additionalProperties": false, "example": { "capability": "zepto.location", "input": { "latitude": 12.96902, "longitude": 77.75395 } }, "properties": { "capability": { "enum": [ "zepto.location" ], "type": "string" }, "input": { "$ref": "#/components/schemas/ZeptoLocationInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 180000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "ZeptoPlaceResolveExecuteRequest": { "additionalProperties": false, "example": { "capability": "zepto.place.resolve", "input": { "query": "Indiranagar Bengaluru" } }, "properties": { "capability": { "enum": [ "zepto.place.resolve" ], "type": "string" }, "input": { "$ref": "#/components/schemas/ZeptoPlaceResolveInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 180000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "ZeptoPlaceAutocompleteInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Input for autocompleting place names via Zepto.", "properties": { "limit": { "default": 5, "description": "Maximum number of autocomplete suggestions to return.", "maximum": 20, "minimum": 1, "type": "integer" }, "max_records": { "minimum": 1, "type": "integer" }, "query": { "description": "Partial place name or address to autocomplete.", "type": "string" } }, "required": [ "query" ], "title": "PlaceAutocompleteInput", "type": "object" }, "ZeptoCategoriesCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "zepto.categories" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "zepto" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee.", "example": { "count": 226, "location_eta_in_minutes": 4, "location_eta_serviceable": true, "location_latitude": 12.96902, "location_longitude": 77.75395, "location_secondary_store_ids": [ "0059ff6a-7eb0-477a-a7f5-69256f2c444b" ], "location_serviceable": true, "location_source_url": "https://bff-gateway.zepto.com/lms/api/v2/get_page?latitude=12.96902&longitude=77.75395&page_type=HOME&version=v2&show_new_eta_banner=true&page_size=3&enforce_platform_type=DESKTOP", "location_store_id": "b4dc8d65-ed2e-4142-81b6-373982b13500", "location_store_ids": [ "b4dc8d65-ed2e-4142-81b6-373982b13500", "0059ff6a-7eb0-477a-a7f5-69256f2c444b" ], "results": [ { "category_id": "64374cfe-d06f-4a01-898e-c07c46462c36", "category_image_path": "inventory/category/[redacted:token].png", "category_image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/inventory/category/[redacted:token].png", "category_name": "Fruits & Vegetables", "category_priority": 1, "category_subcategory_ids_json": "[]", "category_url": "https://www.zepto.com/cn/fruits-vegetables/all/cid/64374cfe-d06f-4a01-898e-c07c46462c36/scid/e78a8422-5f20-4e4b-9a9f-22a0e53962e3", "discount_applicable": true, "display_secondary_image": true, "facebook_subcategory": "food & beverages > food", "google_subcategory": "Food, Beverages & Tobacco", "mrp_sp_mismatch_allowed": true, "price_guardrail_threshold": 20, "rank": 1, "source_url": "https://bff-gateway.zepto.com/product-assortment-service/api/v2/category/grid?store_id=b4dc8d65-ed2e-4142-81b6-373982b13500", "subcategory_id": "e78a8422-5f20-4e4b-9a9f-22a0e53962e3", "subcategory_image_path": "cms/sub_category/c067507c-a931-4a09-b701-a2171b8f6bf9.png", "subcategory_image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/sub_category/c067507c-a931-4a09-b701-a2171b8f6bf9.png", "subcategory_image_v2_path": "cms/sub_category/102e9688-c220-4a0e-bc35-0f0b16de6ad1.png", "subcategory_image_v2_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/sub_category/102e9688-c220-4a0e-bc35-0f0b16de6ad1.png", "subcategory_name": "All", "subcategory_priority": 10 }, { "category_id": "64374cfe-d06f-4a01-898e-c07c46462c36", "category_image_path": "inventory/category/[redacted:token].png", "category_image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/inventory/category/[redacted:token].png", "category_name": "Fruits & Vegetables", "category_priority": 1, "category_subcategory_ids_json": "[]", "category_url": "https://www.zepto.com/cn/fruits-vegetables/fresh-vegetables/cid/64374cfe-d06f-4a01-898e-c07c46462c36/scid/b4827798-fcb6-4520-ba5b-0f2bd9bd7208", "discount_applicable": true, "display_secondary_image": true, "facebook_subcategory": "food & beverages > food > fruits & vegetables", "google_subcategory": "Food, Beverages & Tobacco", "mrp_sp_mismatch_allowed": true, "price_guardrail_threshold": 20, "rank": 2, "source_url": "https://bff-gateway.zepto.com/product-assortment-service/api/v2/category/grid?store_id=b4dc8d65-ed2e-4142-81b6-373982b13500", "subcategory_id": "b4827798-fcb6-4520-ba5b-0f2bd9bd7208", "subcategory_image_path": "cms/sub_category/694c07e0-542b-49db-a596-b1f4f4935342.png", "subcategory_image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/sub_category/694c07e0-542b-49db-a596-b1f4f4935342.png", "subcategory_image_v2_path": "cms/sub_category/694c07e0-542b-49db-a596-b1f4f4935342.png", "subcategory_image_v2_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/sub_category/694c07e0-542b-49db-a596-b1f4f4935342.png", "subcategory_name": "Fresh Vegetables", "subcategory_priority": 20 }, { "category_id": "64374cfe-d06f-4a01-898e-c07c46462c36", "category_image_path": "inventory/category/[redacted:token].png", "category_image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/inventory/category/[redacted:token].png", "category_name": "Fruits & Vegetables", "category_priority": 1, "category_subcategory_ids_json": "[]", "category_url": "https://www.zepto.com/cn/fruits-vegetables/fresh-fruits/cid/64374cfe-d06f-4a01-898e-c07c46462c36/scid/09e63c15-e5f7-4712-9ff8-513250b79942", "discount_applicable": true, "display_secondary_image": true, "facebook_subcategory": "food & beverages > food > fruits & vegetables", "google_subcategory": "Food, Beverages & Tobacco", "mrp_sp_mismatch_allowed": true, "price_guardrail_threshold": 20, "rank": 3, "source_url": "https://bff-gateway.zepto.com/product-assortment-service/api/v2/category/grid?store_id=b4dc8d65-ed2e-4142-81b6-373982b13500", "subcategory_id": "09e63c15-e5f7-4712-9ff8-513250b79942", "subcategory_image_path": "cms/sub_category/7e51d0f6-ee57-42f3-98f9-945033ad3e5f.png", "subcategory_image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/sub_category/7e51d0f6-ee57-42f3-98f9-945033ad3e5f.png", "subcategory_image_v2_path": "cms/sub_category/7e51d0f6-ee57-42f3-98f9-945033ad3e5f.png", "subcategory_image_v2_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/sub_category/7e51d0f6-ee57-42f3-98f9-945033ad3e5f.png", "subcategory_name": "Fresh Fruits", "subcategory_priority": 40 } ], "source_url": "https://bff-gateway.zepto.com/product-assortment-service/api/v2/category/grid?store_id=b4dc8d65-ed2e-4142-81b6-373982b13500" } }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "RateLimitError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "rate_limited", "type": "string" }, "message": { "const": "rate limit exceeded", "type": "string" }, "retry_after_ms": { "description": "Milliseconds until the rolling window resets enough to retry. The `retry-after` response header carries the same value rounded up to seconds.", "minimum": 0, "type": "integer" } }, "required": [ "code", "message", "retry_after_ms" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "ExecuteReplayResponse": { "additionalProperties": false, "description": "Replayed response matching the original job's current state (completed, failed, or pending).", "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "zepto.ads", "zepto.categories", "zepto.category.products", "zepto.health", "zepto.location", "zepto.place.autocomplete", "zepto.place.details", "zepto.place.resolve", "zepto.product", "zepto.search", "zepto.search.filters" ], "type": "string" }, "error": {}, "idempotent_replay": { "const": true, "type": "boolean" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "zepto" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": {}, "state": { "enum": [ "queued", "running", "retrying", "completed", "failed" ], "type": "string" }, "stats": {}, "success": { "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "idempotent_replay" ], "type": "object" }, "NotFoundError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "not_found", "type": "string" }, "message": { "const": "job not found", "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "ZeptoProductExecuteRequest": { "additionalProperties": false, "example": { "capability": "zepto.product", "input": { "url": "https://www.zepto.com/pn/tender-coconut/pvid/b9fbf0e7-de2d-4a89-ae74-b12a7c0ab236" } }, "properties": { "capability": { "enum": [ "zepto.product" ], "type": "string" }, "input": { "$ref": "#/components/schemas/ZeptoProductInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 180000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "IdempotencyConflictError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "idempotency_conflict", "type": "string" }, "message": { "const": "idempotency key has already been used for a different request", "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "ZeptoPlaceDetailsExecuteRequest": { "additionalProperties": false, "example": { "capability": "zepto.place.details", "input": { "place_id": "ChIJkQN3GKQWrjsRNhBQJrhGD7U" } }, "properties": { "capability": { "enum": [ "zepto.place.details" ], "type": "string" }, "input": { "$ref": "#/components/schemas/ZeptoPlaceDetailsInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 180000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "ZeptoPlaceDetailsCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "zepto.place.details" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "zepto" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee.", "example": { "city": "Bengaluru", "country": "India", "country_code": "IN", "district": "Bengaluru Urban", "formatted_address": "Indiranagar, Bengaluru, Karnataka, India", "latitude": 12.9783692, "locality": "Indiranagar", "location_type": "APPROXIMATE", "longitude": 77.6408356, "place_id": "ChIJkQN3GKQWrjsRNhBQJrhGD7U", "source_url": "https://bff-gateway.zepto.com/api/v1/maps/place/details/?place_id=ChIJkQN3GKQWrjsRNhBQJrhGD7U&session_token=2ef912dc-b111-4590-9d01-96bc40bbb47e", "state": "Karnataka", "state_code": "KA", "types": "political sublocality sublocality_level_1" } }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "ZeptoPlaceAutocompleteCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "zepto.place.autocomplete" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "zepto" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee.", "example": { "count": 3, "query": "Indiranagar Bengaluru", "results": [ { "description": "Indiranagar, Bengaluru, Karnataka, India", "main_text": "Indiranagar", "place_id": "ChIJkQN3GKQWrjsRNhBQJrhGD7U", "rank": 1, "secondary_text": "Bengaluru, Karnataka, India", "source_url": "https://bff-gateway.zepto.com/api/v1/maps/place/autocomplete/?place_name=Indiranagar+Bengaluru&session_token=fd238724-f981-4bed-9318-1225ca084feb", "types": "geocode political sublocality sublocality_level_1" }, { "description": "Indiranagar, Chinmaya Mission Hospital Road, Binnamangala, Stage 1, Indiranagar, Bengaluru, Karnataka, India", "main_text": "Indiranagar", "place_id": "ChIJZbZd-qQWrjsRe7G5a9GUZ9U", "rank": 2, "secondary_text": "Chinmaya Mission Hospital Road, Binnamangala, Stage 1, Indiranagar, Bengaluru, Karnataka, India", "source_url": "https://bff-gateway.zepto.com/api/v1/maps/place/autocomplete/?place_name=Indiranagar+Bengaluru&session_token=fd238724-f981-4bed-9318-1225ca084feb", "types": "establishment point_of_interest subway_station transit_station" }, { "description": "Indiranagar, 6th Block, Koramangala, Bengaluru, Karnataka, India", "main_text": "Indiranagar, 6th Block, Koramangala", "place_id": "ChIJXTaHq0UUrjsRXCmRVp-vx3I", "rank": 3, "secondary_text": "Bengaluru, Karnataka, India", "source_url": "https://bff-gateway.zepto.com/api/v1/maps/place/autocomplete/?place_name=Indiranagar+Bengaluru&session_token=fd238724-f981-4bed-9318-1225ca084feb", "types": "geocode political sublocality sublocality_level_3" } ], "source_url": "https://bff-gateway.zepto.com/api/v1/maps/place/autocomplete/?place_name=Indiranagar+Bengaluru&session_token=fd238724-f981-4bed-9318-1225ca084feb" } }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "ZeptoSearchCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "zepto.search" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "zepto" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee." }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "ZeptoCategoryProductsExecuteRequest": { "additionalProperties": false, "example": { "capability": "zepto.category.products", "input": { "limit": 5, "url": "https://www.zepto.com/cn/fruits-vegetables/fresh-fruits/cid/64374cfe-d06f-4a01-898e-c07c46462c36/scid/09e63c15-e5f7-4712-9ff8-513250b79942" } }, "properties": { "capability": { "enum": [ "zepto.category.products" ], "type": "string" }, "input": { "$ref": "#/components/schemas/ZeptoCategoryProductsInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 180000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "ZeptoSearchFiltersCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "zepto.search.filters" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "zepto" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee." }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" } }, "securitySchemes": { "BearerAuth": { "bearerFormat": "API Key", "scheme": "bearer", "type": "http" } } }, "info": { "description": "Scrape India's Zepto q-commerce platform: product details, search, category listings, ad placements, place/location resolution, search filters, and platform health checks. No login required.\nThis spec includes only the live `Zepto` capabilities exposed by Upscrape.\nExecution uses the generic `POST /execute` endpoint and job polling uses `GET /jobs/{id}`.\nSupported capabilities: `zepto.ads`, `zepto.categories`, `zepto.category.products`, `zepto.health`, `zepto.location`, `zepto.place.autocomplete`, `zepto.place.details`, `zepto.place.resolve`, `zepto.product`, `zepto.search`, `zepto.search.filters`\n## Rate limiting\n\nRequests are rate-limited per API key at **1200 requests per minute** on a rolling window. Every response includes `x-ratelimit-limit`, `x-ratelimit-remaining`, and `x-ratelimit-reset` (Unix ms) headers so clients can self-pace. When the limit is exceeded the API returns `429` with a `rate_limited` error body and a `retry-after` header in seconds plus a `retry_after_ms` field on the body for finer-grained backoff.", "title": "Zepto API", "version": "v0.1.11" }, "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema", "openapi": "3.1.0", "paths": { "/execute": { "post": { "description": "All executions are asynchronous. Submit a capability-specific payload to `POST /execute`, then poll the returned `job_id`.", "operationId": "zepto_execute", "parameters": [ { "description": "Optional idempotency key. Reusing the same key with the same request replays the original job.", "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "maxLength": 255, "type": "string" } }, { "description": "Request synchronous completion. Use `wait=N` to hold the connection up to N seconds (max 300). If the job completes within the window, the response is `200` with full results (same shape as `GET /jobs/{id}`). If not, the response is the normal `202` with a `job_id` for polling. Omit this header for default asynchronous behavior.", "examples": { "wait30": { "summary": "Wait up to 30 seconds", "value": "wait=30" }, "wait5": { "summary": "Wait up to 5 seconds", "value": "wait=5" } }, "in": "header", "name": "Prefer", "required": false, "schema": { "example": "wait=30", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "capability": "zepto.ads", "input": { "latitude": 12.96902, "limit": 5, "longitude": 77.75395, "page_type": "HOME" } }, "schema": { "discriminator": { "mapping": { "zepto.ads": "#/components/schemas/ZeptoAdsExecuteRequest", "zepto.categories": "#/components/schemas/ZeptoCategoriesExecuteRequest", "zepto.category.products": "#/components/schemas/ZeptoCategoryProductsExecuteRequest", "zepto.health": "#/components/schemas/ZeptoHealthExecuteRequest", "zepto.location": "#/components/schemas/ZeptoLocationExecuteRequest", "zepto.place.autocomplete": "#/components/schemas/ZeptoPlaceAutocompleteExecuteRequest", "zepto.place.details": "#/components/schemas/ZeptoPlaceDetailsExecuteRequest", "zepto.place.resolve": "#/components/schemas/ZeptoPlaceResolveExecuteRequest", "zepto.product": "#/components/schemas/ZeptoProductExecuteRequest", "zepto.search": "#/components/schemas/ZeptoSearchExecuteRequest", "zepto.search.filters": "#/components/schemas/ZeptoSearchFiltersExecuteRequest" }, "propertyName": "capability" }, "oneOf": [ { "$ref": "#/components/schemas/ZeptoAdsExecuteRequest" }, { "$ref": "#/components/schemas/ZeptoCategoriesExecuteRequest" }, { "$ref": "#/components/schemas/ZeptoCategoryProductsExecuteRequest" }, { "$ref": "#/components/schemas/ZeptoHealthExecuteRequest" }, { "$ref": "#/components/schemas/ZeptoLocationExecuteRequest" }, { "$ref": "#/components/schemas/ZeptoPlaceAutocompleteExecuteRequest" }, { "$ref": "#/components/schemas/ZeptoPlaceDetailsExecuteRequest" }, { "$ref": "#/components/schemas/ZeptoPlaceResolveExecuteRequest" }, { "$ref": "#/components/schemas/ZeptoProductExecuteRequest" }, { "$ref": "#/components/schemas/ZeptoSearchExecuteRequest" }, { "$ref": "#/components/schemas/ZeptoSearchFiltersExecuteRequest" } ] } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ZeptoAdsCompletedJob" }, { "$ref": "#/components/schemas/ZeptoCategoriesCompletedJob" }, { "$ref": "#/components/schemas/ZeptoCategoryProductsCompletedJob" }, { "$ref": "#/components/schemas/ZeptoHealthCompletedJob" }, { "$ref": "#/components/schemas/ZeptoLocationCompletedJob" }, { "$ref": "#/components/schemas/ZeptoPlaceAutocompleteCompletedJob" }, { "$ref": "#/components/schemas/ZeptoPlaceDetailsCompletedJob" }, { "$ref": "#/components/schemas/ZeptoPlaceResolveCompletedJob" }, { "$ref": "#/components/schemas/ZeptoProductCompletedJob" }, { "$ref": "#/components/schemas/ZeptoSearchCompletedJob" }, { "$ref": "#/components/schemas/ZeptoSearchFiltersCompletedJob" }, { "$ref": "#/components/schemas/ExecuteReplayResponse" }, { "$ref": "#/components/schemas/JobFailedResponse" } ] } } }, "description": "Job completed within the `Prefer: wait` window, or existing job replayed via idempotency key.", "headers": { "Preference-Applied": { "description": "Present when the server honored the `Prefer: wait` preference.", "schema": { "example": "wait=30", "type": "string" } }, "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "202": { "content": { "application/json": { "example": { "capability": "zepto.ads", "job_id": "00000000-0000-0000-0000-000000000001", "platform": "zepto", "request_id": "00000000-0000-0000-0000-000000000001", "state": "queued", "success": false }, "schema": { "$ref": "#/components/schemas/ExecuteAcceptedResponse" } } }, "description": "Job accepted and queued.", "headers": { "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedError" } } }, "description": "Unauthorized" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } }, "description": "The authenticated account cannot execute the request." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IdempotencyConflictError" } } }, "description": "Idempotency conflict" }, "422": { "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ValidationErrors" }, { "$ref": "#/components/schemas/CredentialsRequiredError" } ] } } }, "description": "The request body failed validation." }, "429": { "content": { "application/json": { "example": { "error": { "code": "rate_limited", "message": "rate limit exceeded", "retry_after_ms": 4200 } }, "schema": { "$ref": "#/components/schemas/RateLimitError" } } }, "description": "The per-API-key rate limit has been exceeded. Clients should back off until `retry_after_ms` has elapsed (or `retry-after` seconds).", "headers": { "retry-after": { "description": "Seconds until the client may retry (ceiling of `retry_after_ms`).", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InternalError" } } }, "description": "Unexpected server error" } }, "security": [ { "BearerAuth": [] } ], "summary": "Queue a Zepto capability run", "tags": [ "Execution" ] } }, "/jobs/{id}": { "get": { "description": "Get job status and result", "operationId": "zepto_getJob", "parameters": [ { "description": "The job ID returned by `POST /execute`.", "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ZeptoAdsCompletedJob" }, { "$ref": "#/components/schemas/ZeptoCategoriesCompletedJob" }, { "$ref": "#/components/schemas/ZeptoCategoryProductsCompletedJob" }, { "$ref": "#/components/schemas/ZeptoHealthCompletedJob" }, { "$ref": "#/components/schemas/ZeptoLocationCompletedJob" }, { "$ref": "#/components/schemas/ZeptoPlaceAutocompleteCompletedJob" }, { "$ref": "#/components/schemas/ZeptoPlaceDetailsCompletedJob" }, { "$ref": "#/components/schemas/ZeptoPlaceResolveCompletedJob" }, { "$ref": "#/components/schemas/ZeptoProductCompletedJob" }, { "$ref": "#/components/schemas/ZeptoSearchCompletedJob" }, { "$ref": "#/components/schemas/ZeptoSearchFiltersCompletedJob" }, { "$ref": "#/components/schemas/JobFailedResponse" } ] } } }, "description": "Completed or terminal job state.", "headers": { "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "202": { "content": { "application/json": { "example": { "capability": "zepto.ads", "job_id": "00000000-0000-0000-0000-000000000001", "platform": "zepto", "request_id": "00000000-0000-0000-0000-000000000001", "state": "running", "success": false }, "schema": { "$ref": "#/components/schemas/JobPendingResponse" } } }, "description": "Job is still queued, running, or retrying.", "headers": { "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedError" } } }, "description": "Unauthorized" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotFoundError" } } }, "description": "Job not found" }, "429": { "content": { "application/json": { "example": { "error": { "code": "rate_limited", "message": "rate limit exceeded", "retry_after_ms": 4200 } }, "schema": { "$ref": "#/components/schemas/RateLimitError" } } }, "description": "The per-API-key rate limit has been exceeded. Clients should back off until `retry_after_ms` has elapsed (or `retry-after` seconds).", "headers": { "retry-after": { "description": "Seconds until the client may retry (ceiling of `retry_after_ms`).", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } } }, "security": [ { "BearerAuth": [] } ], "summary": "Poll a Zepto job", "tags": [ "Jobs" ] } }, "/jobs/{id}/result": { "get": { "description": "Backward-compatible alias for `/jobs/{id}`.", "operationId": "zepto_getJobResult", "parameters": [ { "description": "The job ID returned by `POST /execute`.", "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ZeptoAdsCompletedJob" }, { "$ref": "#/components/schemas/ZeptoCategoriesCompletedJob" }, { "$ref": "#/components/schemas/ZeptoCategoryProductsCompletedJob" }, { "$ref": "#/components/schemas/ZeptoHealthCompletedJob" }, { "$ref": "#/components/schemas/ZeptoLocationCompletedJob" }, { "$ref": "#/components/schemas/ZeptoPlaceAutocompleteCompletedJob" }, { "$ref": "#/components/schemas/ZeptoPlaceDetailsCompletedJob" }, { "$ref": "#/components/schemas/ZeptoPlaceResolveCompletedJob" }, { "$ref": "#/components/schemas/ZeptoProductCompletedJob" }, { "$ref": "#/components/schemas/ZeptoSearchCompletedJob" }, { "$ref": "#/components/schemas/ZeptoSearchFiltersCompletedJob" }, { "$ref": "#/components/schemas/JobFailedResponse" } ] } } }, "description": "Completed or terminal job state.", "headers": { "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "202": { "content": { "application/json": { "example": { "capability": "zepto.ads", "job_id": "00000000-0000-0000-0000-000000000001", "platform": "zepto", "request_id": "00000000-0000-0000-0000-000000000001", "state": "running", "success": false }, "schema": { "$ref": "#/components/schemas/JobPendingResponse" } } }, "description": "Job is still queued, running, or retrying.", "headers": { "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedError" } } }, "description": "Unauthorized" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotFoundError" } } }, "description": "Job not found" }, "429": { "content": { "application/json": { "example": { "error": { "code": "rate_limited", "message": "rate limit exceeded", "retry_after_ms": 4200 } }, "schema": { "$ref": "#/components/schemas/RateLimitError" } } }, "description": "The per-API-key rate limit has been exceeded. Clients should back off until `retry_after_ms` has elapsed (or `retry-after` seconds).", "headers": { "retry-after": { "description": "Seconds until the client may retry (ceiling of `retry_after_ms`).", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } } }, "security": [ { "BearerAuth": [] } ], "summary": "Poll a Zepto job", "tags": [ "Jobs" ] } } }, "servers": [ { "url": "https://data.upscrape.com" } ], "tags": [ { "description": "Submit asynchronous capability runs.", "name": "Execution" }, { "description": "Poll queued jobs for status and results.", "name": "Jobs" } ] }