# List categories List Zepto categories and subcategories for a store or delivery context, including IDs used for category browsing. - Platform: [Zepto](https://docs.upscrape.com/docs/platforms/zepto) - Capability ID: `zepto.categories` - Cost: 1 credit per request - Maximum runtime: 180 seconds - Execute endpoint: `POST https://data.upscrape.com/execute` ## Request Use the exact public capability ID in the shared execute envelope. ```bash curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "input": { "latitude": 12.96902, "longitude": 77.75395 }, "capability": "zepto.categories" }' ``` ## Input For a location-specific directory, provide store_id, a six-digit pincode, or both latitude and longitude. Do not combine pincode with coordinates. Omitting location can use the capability’s default context, so supply an explicit context for comparisons. | Field | Type | Required | Description | | --- | --- | --- | --- | | `latitude` | `number` | No | Latitude for location-based store resolution. From -90 to 90. | | `longitude` | `number` | No | Longitude for location-based store resolution. From -180 to 180. | | `pincode` | `string` | No | Six-digit Indian pincode. When provided, Upscrape resolves coordinates and the Zepto delivery store automatically. | | `store_id` | `string` | No | Zepto store ID. Defaults to the public Bangalore sample store. | ### Example input ```json { "latitude": 12.96902, "longitude": 77.75395 } ``` ## Response Successful output is returned in `results[0].data`. categories contains the grouped category tree while results exposes flat category/subcategory rows. count refers to flat rows rather than the number of parent category groups. Use returned category_id and subcategory_id values with category-products calls at the same delivery context. Category structure can vary by store. ### Illustrative sample output This example shows one response. Values and optional fields vary with the data available. ```json { "captured_at": "2026-09-24T09:54:33.889557818Z", "categories": [ { "category_id": "64374cfe-d06f-4a01-898e-c07c46462c36", "category_name": "Fruits & Vegetables", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/inventory/category/[redacted:token].png", "rank": 1, "subcategories": [ { "category_url": "https://www.zepto.com/cn/fruits-vegetables/all/cid/64374cfe-d06f-4a01-898e-c07c46462c36/scid/e78a8422-5f20-4e4b-9a9f-22a0e53962e3", "image_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", "rank": 1, "subcategory_id": "e78a8422-5f20-4e4b-9a9f-22a0e53962e3", "subcategory_name": "All" }, { "category_url": "https://www.zepto.com/cn/fruits-vegetables/fresh-vegetables/cid/64374cfe-d06f-4a01-898e-c07c46462c36/scid/b4827798-fcb6-4520-ba5b-0f2bd9bd7208", "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", "rank": 2, "subcategory_id": "b4827798-fcb6-4520-ba5b-0f2bd9bd7208", "subcategory_name": "Fresh Vegetables" }, { "category_url": "https://www.zepto.com/cn/fruits-vegetables/fresh-fruits/cid/64374cfe-d06f-4a01-898e-c07c46462c36/scid/09e63c15-e5f7-4712-9ff8-513250b79942", "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", "rank": 3, "subcategory_id": "09e63c15-e5f7-4712-9ff8-513250b79942", "subcategory_name": "Fresh Fruits" } ] }, { "category_id": "4b938e02-7bde-4479-bc0a-2b54cb6bd5f5", "category_name": "Dairy, Bread & Eggs", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/category/ce6636e2-16a7-4efb-b318-d911bbf7271d.png", "rank": 2, "subcategories": [ { "category_url": "https://www.zepto.com/cn/dairy-bread-eggs/milk/cid/4b938e02-7bde-4479-bc0a-2b54cb6bd5f5/scid/22964a2b-0439-4236-9950-0d71b532b243", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/sub_category/87.png", "rank": 1, "subcategory_id": "22964a2b-0439-4236-9950-0d71b532b243", "subcategory_name": "Milk" }, { "category_url": "https://www.zepto.com/cn/dairy-bread-eggs/breads-buns/cid/4b938e02-7bde-4479-bc0a-2b54cb6bd5f5/scid/30566884-bbd7-49fa-8c3f-43c90a571c9e", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/sub_category/85.png", "rank": 2, "subcategory_id": "30566884-bbd7-49fa-8c3f-43c90a571c9e", "subcategory_name": "Breads & Buns" }, { "category_url": "https://www.zepto.com/cn/dairy-bread-eggs/fresh-bakery/cid/4b938e02-7bde-4479-bc0a-2b54cb6bd5f5/scid/40a4be6f-9589-4a6e-9554-99e4039393a8", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/sub_category/fee22698-b755-4f69-af5f-f1d479cd8273.jpeg", "rank": 3, "subcategory_id": "40a4be6f-9589-4a6e-9554-99e4039393a8", "subcategory_name": "Fresh Bakery" } ] }, { "category_id": "4654bd8a-fb30-4ee1-ab30-4bf581b6c6e3", "category_name": "Meats, Fish & Eggs", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/category/1fa05fc7-5136-4f5f-a10b-a416c0aed89a.png", "rank": 3, "subcategories": [ { "category_url": "https://www.zepto.com/cn/meats-fish-eggs/chicken/cid/4654bd8a-fb30-4ee1-ab30-4bf581b6c6e3/scid/95157c69-f03e-48e5-ae2f-d947af34397f", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/sub_category/ad4edb2e-4031-4933-a4fc-7264add2e99f.png", "rank": 1, "subcategory_id": "95157c69-f03e-48e5-ae2f-d947af34397f", "subcategory_name": "Chicken" }, { "category_url": "https://www.zepto.com/cn/meats-fish-eggs/fish-sea-food/cid/4654bd8a-fb30-4ee1-ab30-4bf581b6c6e3/scid/c41382e7-5331-4116-ab96-8cf25af8eab9", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/sub_category/c4957766-020b-43a7-ae7e-664fa7d69c17.png", "rank": 2, "subcategory_id": "c41382e7-5331-4116-ab96-8cf25af8eab9", "subcategory_name": "Fish & Sea Food" }, { "category_url": "https://www.zepto.com/cn/meats-fish-eggs/mutton/cid/4654bd8a-fb30-4ee1-ab30-4bf581b6c6e3/scid/af20acbf-4144-4482-8e42-1352843803a1", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/sub_category/fc1bd7f7-7616-46cd-81b9-01e3afde2ebf.png", "rank": 3, "subcategory_id": "af20acbf-4144-4482-8e42-1352843803a1", "subcategory_name": "Mutton" } ] } ], "count": 9, "location": { "eta_minutes": 6, "eta_serviceable": true, "latitude": 12.96902, "longitude": 77.75395, "secondary_store_ids": [ "0059ff6a-7eb0-477a-a7f5-69256f2c444b" ], "serviceable": true, "store_id": "b4dc8d65-ed2e-4142-81b6-373982b13500", "store_ids": [ "b4dc8d65-ed2e-4142-81b6-373982b13500", "0059ff6a-7eb0-477a-a7f5-69256f2c444b" ] }, "location_eta_in_minutes": 6, "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_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_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_url": "https://www.zepto.com/cn/fruits-vegetables/all/cid/64374cfe-d06f-4a01-898e-c07c46462c36/scid/e78a8422-5f20-4e4b-9a9f-22a0e53962e3", "rank": 1, "subcategory_id": "e78a8422-5f20-4e4b-9a9f-22a0e53962e3", "subcategory_image_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" }, { "category_id": "64374cfe-d06f-4a01-898e-c07c46462c36", "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_url": "https://www.zepto.com/cn/fruits-vegetables/fresh-vegetables/cid/64374cfe-d06f-4a01-898e-c07c46462c36/scid/b4827798-fcb6-4520-ba5b-0f2bd9bd7208", "rank": 2, "subcategory_id": "b4827798-fcb6-4520-ba5b-0f2bd9bd7208", "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_name": "Fresh Vegetables" }, { "category_id": "64374cfe-d06f-4a01-898e-c07c46462c36", "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_url": "https://www.zepto.com/cn/fruits-vegetables/fresh-fruits/cid/64374cfe-d06f-4a01-898e-c07c46462c36/scid/09e63c15-e5f7-4712-9ff8-513250b79942", "rank": 3, "subcategory_id": "09e63c15-e5f7-4712-9ff8-513250b79942", "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_name": "Fresh Fruits" } ] } ``` ### Illustrative output fields Derived from the sample above for orientation only. These fields are not a fixed response schema. | Path | Observed type | Example | | --- | --- | --- | | `captured_at` | `string` | 2026-09-24T09:54:33.889557818Z | | `categories` | `array` | 3 items | | `categories` | `array` | 3 items | | `count` | `integer` | 9 | | `location` | `object` | 8 fields | | `location.eta_minutes` | `integer` | 6 | | `location.eta_serviceable` | `boolean` | true | | `location.latitude` | `number` | 12.96902 | | `location.longitude` | `number` | 77.75395 | | `location.secondary_store_ids` | `array` | 1 items | | `location.serviceable` | `boolean` | true | | `location.store_id` | `string` | b4dc8d65-ed2e-4142-81b6-373982b13500 | | `location.store_ids` | `array` | 2 items | | `location_eta_in_minutes` | `integer` | 6 | | `location_eta_serviceable` | `boolean` | true | | `location_latitude` | `number` | 12.96902 | | `location_longitude` | `number` | 77.75395 | | `location_secondary_store_ids` | `array` | 1 items | | `location_secondary_store_ids` | `array` | 1 items | | `location_serviceable` | `boolean` | true | | `location_store_id` | `string` | b4dc8d65-ed2e-4142-81b6-373982b13500 | | `location_store_ids` | `array` | 2 items | | `location_store_ids` | `array` | 2 items | | `results` | `array` | 3 items | | `results` | `array` | 3 items | ## Execution behavior A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job. ## Related documentation - [Authentication](https://docs.upscrape.com/docs/api/authentication) - [Jobs and results](https://docs.upscrape.com/docs/api/jobs) - [Errors and retries](https://docs.upscrape.com/docs/api/errors) - [Idempotency](https://docs.upscrape.com/docs/api/idempotency)