Zepto Categories
zepto.categories
Choose a delivery area to see its categories and subcategories, with the IDs your analyst needs to collect their products.
At a glance
- Endpoint ID
zepto.categories- Price
- 3 credits per call; failed calls are free
- Runs for up to
- 180 seconds
Request
Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.
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 '{ "capability": "zepto.categories", "input": { "latitude": 12.96902, "longitude": 77.75395 }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "zepto.categories", "input": { "latitude": 12.96902, "longitude": 77.75395 }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "zepto.categories", "input": { "latitude": 12.96902, "longitude": 77.75395 }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
Input
- For one place's categories, send a store ID, a six-digit pincode, or latitude and longitude together; not a pincode and coordinates at once. Without a location the default one is used, so send one when you compare.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
latitude |
number | one of | Latitude for location-based store resolution. From -90 to 90. | 12.96902 |
longitude |
number | one of | Longitude for location-based store resolution. From -180 to 180. | 77.75395 |
pincode |
string | one of | 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. |
Response
A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.
This is results[0].data from a real run:
results[0].data
{ "captured_at": "2026-10-04T11:57:43.82092299Z", "count": 188, "location_eta_in_minutes": 5, "location_eta_serviceable": true, "location_latitude": 12.96902, "location_longitude": 77.75395, "location_serviceable": true, "location_store_id": "b4dc8d65-ed2e-4142-81b6-373982b13500", "location": { "eta_minutes": 5, "eta_serviceable": true, "latitude": 12.96902, "longitude": 77.75395, "serviceable": true, "store_id": "b4dc8d65-ed2e-4142-81b6-373982b13500", "secondary_store_ids": [ "0059ff6a-7eb0-477a-a7f5-69256f2c444b" ], "store_ids": [ "b4dc8d65-ed2e-4142-81b6-373982b13500", "0059ff6a-7eb0-477a-a7f5-69256f2c444b" ] }, "context": { "source": "resolved_location", "store_id": "b4dc8d65-ed2e-4142-81b6-373982b13500" }, "categories": [ { "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": 1, "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_id": "2f7190d0-7c40-458b-b450-9a1006db3d95", "category_name": "Atta, Rice, Oil & Dals", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/inventory/IMAGE/c332e12f-acca-4b2b-802d-8b7579bdafb1-Frame_10…", "rank": 2, "subcategories": [ { "category_url": "https://www.zepto.com/cn/atta-rice-oil-dals/oil/cid/2f7190d0-7c40-458b-b450-9a1006db3d95/scid/2b5e863c-9497-46ae-a7e9-85f6ef7380da", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/sub_category/19.png", "rank": 1, "subcategory_id": "2b5e863c-9497-46ae-a7e9-85f6ef7380da", "subcategory_name": "Oil" }, { "category_url": "https://www.zepto.com/cn/atta-rice-oil-dals/atta/cid/2f7190d0-7c40-458b-b450-9a1006db3d95/scid/15644eea-d781-4cdd-8d85-e63bd9706b96", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/sub_category/30388500-f133-4f7f-8e15-2b2c5ec804a7.png", "rank": 2, "subcategory_id": "15644eea-d781-4cdd-8d85-e63bd9706b96", "subcategory_name": "Atta" } ] } ], "location_secondary_store_ids": [ "0059ff6a-7eb0-477a-a7f5-69256f2c444b" ], "location_store_ids": [ "b4dc8d65-ed2e-4142-81b6-373982b13500", "0059ff6a-7eb0-477a-a7f5-69256f2c444b" ], "results": [ { "category_id": "4b938e02-7bde-4479-bc0a-2b54cb6bd5f5", "category_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", "category_name": "Dairy, Bread & Eggs", "category_priority": 1, "category_url": "https://www.zepto.com/cn/dairy-bread-eggs/milk/cid/4b938e02-7bde-4479-bc0a-2b54cb6bd5f5/scid/22964a2b-0439-4236-9950-0d71b532b243", "display_secondary_image": true, "facebook_subcategory": "food & beverages > beverages > milk", "google_subcategory": "Food, Beverages & Tobacco", "rank": 1, "subcategory_id": "22964a2b-0439-4236-9950-0d71b532b243", "subcategory_image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/inventory/subcategory/5b1c5be7-ca68-48e9-b589-3cc1d94df128-Un…", "subcategory_image_v2_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/sub_category/87.png", "subcategory_name": "Milk", "subcategory_priority": 10 }, { "category_id": "4b938e02-7bde-4479-bc0a-2b54cb6bd5f5", "category_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", "category_name": "Dairy, Bread & Eggs", "category_priority": 1, "category_url": "https://www.zepto.com/cn/dairy-bread-eggs/breads-buns/cid/4b938e02-7bde-4479-bc0a-2b54cb6bd5f5/scid/30566884-bbd7-49fa-8c3f-43c90a571c9e", "discount_applicable": true, "display_secondary_image": true, "facebook_subcategory": "food & beverages > food > bakery & bread", "google_subcategory": "Food, Beverages & Tobacco", "rank": 2, "subcategory_id": "30566884-bbd7-49fa-8c3f-43c90a571c9e", "subcategory_image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/inventory/subcategory/1eacb3af-616e-442f-8b69-260442c6105c-im…", "subcategory_image_v2_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/sub_category/85.png", "subcategory_name": "Breads & Buns", "subcategory_priority": 20 } ]}
Fields
| Field | Type | What it is | Example |
|---|---|---|---|
results[].category_name |
string | Parent category name in the local directory. | Dairy, Bread & Eggs |
results[].category_id |
string | Parent category identity. | 4b938e02-7bde-4479-bc0a-2b54cb6bd5f5 |
results[].category_image_url |
string | Link to the category image. | https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-tr… |
results[].category_priority |
integer | The category's order on Zepto. | 1 |
results[].category_url |
string | Link to the category on Zepto. | https://www.zepto.com/cn/dairy-bread-eggs/milk/cid/4b938e02-7bd… |
results[].display_secondary_image |
boolean | Whether Zepto shows a second image for the category. | true |
results[].facebook_subcategory |
string | The category in Facebook's product taxonomy. | food & beverages > beverages > milk |
results[].google_subcategory |
string | The category in Google's product taxonomy. | Food, Beverages & Tobacco |
results[].rank |
integer | Position in the list. | 1 |
results[].subcategory_id |
string | Zepto's ID for the subcategory. | 22964a2b-0439-4236-9950-0d71b532b243 |
results[].subcategory_image_url |
string | Link to the subcategory image. | https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-tr… |
results[].subcategory_image_v2_url |
string | Link to the newer subcategory image. | https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-tr… |
results[].subcategory_name |
string | The subcategory name. | Milk |
results[].subcategory_priority |
integer | The subcategory's order on Zepto. | 10 |
location |
object | The location the results were read for. | 8 fields |
location.eta_minutes |
integer | Zepto's delivery estimate in minutes, when it gives one. | 5 |
location.eta_serviceable |
boolean | Whether Zepto delivers to this location. | true |
location.latitude |
number | Latitude of the resolved or requested delivery point. | 12.97 |
location.longitude |
number | Longitude of the resolved or requested delivery point. | 77.75 |
location.secondary_store_ids |
array | Backup stores serving the location. | 0059ff6a-7eb0-477a-a7f5-69256f2c444b |
location.serviceable |
boolean | The endpoint’s serviceability signal; location coverage and delivery-estimate availability are separate checks. | true |
location.store_id |
string | Store attached to this product or delivery context. | b4dc8d65-ed2e-4142-81b6-373982b13500 |
location.store_ids |
array | Zepto stores serving the location. | b4dc8d65-ed2e-4142-81b6-373982b13500, 0059ff6a-7eb0-477a-a7f5-6… |
captured_at |
string | When this result was collected. | 2026-10-04T11:57:43.82092299Z |
categories |
array | Zepto's categories. | 19 records |
categories[].category_id |
string | Parent category identity. | 4b938e02-7bde-4479-bc0a-2b54cb6bd5f5 |
categories[].category_name |
string | Parent category name in the local directory. | Dairy, Bread & Eggs |
categories[].image_url |
string | Image URL published with the placement. | https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-tr… |
categories[].rank |
integer | Position in the list. | 1 |
categories[].subcategories |
array | The subcategories inside a category. | 12 records |
categories[].subcategories[].category_url |
string | https://www.zepto.com/cn/dairy-bread-eggs/milk/cid/4b938e02-7bd… | |
categories[].subcategories[].image_url |
string | https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-tr… | |
categories[].subcategories[].rank |
integer | 1 | |
categories[].subcategories[].subcategory_id |
string | 22964a2b-0439-4236-9950-0d71b532b243 | |
categories[].subcategories[].subcategory_name |
string | Milk | |
context |
object | How the location was set for these results. | 2 fields |
context.source |
string | How the location was found. | resolved_location |
context.store_id |
string | Store attached to this product or delivery context. | b4dc8d65-ed2e-4142-81b6-373982b13500 |
count |
integer | Number of products returned for this delivery context. | 188 |
location_eta_in_minutes |
integer | Estimated delivery time at the location, in minutes. | 5 |
location_eta_serviceable |
boolean | Whether Zepto delivers to the location. | true |
location_latitude |
number | Latitude of the location. | 12.97 |
location_longitude |
number | Longitude of the location. | 77.75 |
location_secondary_store_ids |
array | Backup stores serving the location. | 0059ff6a-7eb0-477a-a7f5-69256f2c444b |
location_serviceable |
boolean | Whether the resolved location is served by Zepto. | true |
location_store_id |
string | The serving store found by the location lookup or the access check. | b4dc8d65-ed2e-4142-81b6-373982b13500 |
location_store_ids |
array | Zepto stores serving the location. | b4dc8d65-ed2e-4142-81b6-373982b13500, 0059ff6a-7eb0-477a-a7f5-6… |
results |
array | The results returned. | 188 records |
What to know
- 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 the returned category and subcategory IDs for category product requests at the same place. Categories can differ by store.
If a call fails
A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.
Other Zepto endpoints
zepto.adsAdszepto.catalogStore catalogzepto.catalog.multi_locationMulti-location catalogzepto.category.productsCategory productszepto.etaETAzepto.healthHealth checkzepto.locationResolve locationzepto.place.autocompletePlace autocompletezepto.place.detailsPlace detailszepto.place.resolveResolve placezepto.productProductzepto.searchProducts searchzepto.search.facetsSummarize search facetszepto.search.multi_locationMulti-location search
Something missing or unclear? Ask the team that builds the Zepto endpoints.