Zepto API reference

Zepto Resolve Place

zepto.place.resolve

Send a place name to get its coordinates and Zepto’s serving-store and delivery-coverage information.

Zepto Resolve Place API: overview and live sample

At a glance

Endpoint ID: zepto.place.resolve
Price: 2 credits per call; failed calls are free
Runs for up to: 180 seconds
Request: POST /execute; Run an endpoint
MCP tool when pinned: zepto__place__resolve; Pin tools
OpenAPI: openapi.json; Download

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.place.resolve",  "input": {    "query": "Indiranagar Bengaluru"  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "zepto.place.resolve",  "input": {    "query": "Indiranagar Bengaluru"  }}''')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.place.resolve",  "input": {    "query": "Indiranagar Bengaluru"  }}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));

Input

Send a place name or address to search for, or a place ID to look up directly. Use a real place rather than a made-up ID.

Field	Type	Required	What it does	Example
`place_id`	string	one of	Google Maps place ID to resolve directly.
`query`	string	one of	Place name or address to search for.	Indiranagar Bengaluru

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

{  "city": "Bengaluru",  "captured_at": "2026-10-04T12:04:17.997012519Z",  "country": "India",  "country_code": "IN",  "district": "Bengaluru Urban",  "formatted_address": "Indiranagar, Bengaluru, Karnataka, India",  "latitude": 12.9783692,  "locality": "Indiranagar",  "location_eta_in_minutes": 10,  "location_eta_serviceable": true,  "location_latitude": 12.9783692,  "location_longitude": 77.6408356,  "location_serviceable": true,  "location_store_id": "5b1796e1-36c2-4ae9-83a0-c03c25cac05a",  "location_type": "APPROXIMATE",  "longitude": 77.6408356,  "place_id": "ChIJkQN3GKQWrjsRNhBQJrhGD7U",  "state": "Karnataka",  "state_code": "KA",  "types": "political sublocality sublocality_level_1",  "location": {    "eta_minutes": 10,    "eta_serviceable": true,    "latitude": 12.9783692,    "longitude": 77.6408356,    "serviceable": true,    "store_id": "5b1796e1-36c2-4ae9-83a0-c03c25cac05a",    "secondary_store_ids": [      "071461ac-2354-4e5e-b5f5-04ef935f591c"    ],    "store_ids": [      "5b1796e1-36c2-4ae9-83a0-c03c25cac05a",      "071461ac-2354-4e5e-b5f5-04ef935f591c"    ]  },  "place": {    "city": "Bengaluru",    "captured_at": "2026-10-04T12:04:17.147024106Z",    "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",    "state": "Karnataka",    "state_code": "KA",    "types": "political sublocality sublocality_level_1"  },  "location_secondary_store_ids": [    "071461ac-2354-4e5e-b5f5-04ef935f591c"  ],  "location_store_ids": [    "5b1796e1-36c2-4ae9-83a0-c03c25cac05a",    "071461ac-2354-4e5e-b5f5-04ef935f591c"  ]}

Fields

Field	Type	What it is	Example
`formatted_address`	string	Public locality/address label for the resolved place.	Indiranagar, Bengaluru, Karnataka, India
`latitude`	number	Latitude of the resolved or requested delivery point.	12.98
`longitude`	number	Longitude of the resolved or requested delivery point.	77.64
`location_store_id`	string	The serving store found by the location lookup or the access check.	5b1796e1-36c2-4ae9-83a0-c03c25cac05a
`location_serviceable`	boolean	Whether the resolved location is served by Zepto.	true
`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.	10
`location.eta_serviceable`	boolean	Whether Zepto delivers to this location.	true
`location.latitude`	number	Latitude of the resolved or requested delivery point.	12.98
`location.longitude`	number	Longitude of the resolved or requested delivery point.	77.64
`location.secondary_store_ids`	array	Backup stores serving the location.	071461ac-2354-4e5e-b5f5-04ef935f591c
`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.	5b1796e1-36c2-4ae9-83a0-c03c25cac05a
`location.store_ids`	array	Zepto stores serving the location.	5b1796e1-36c2-4ae9-83a0-c03c25cac05a, 071461ac-2354-4e5e-b5f5-0…
`city`	string	City of the place.	Bengaluru
`captured_at`	string	When this result was collected.	2026-10-04T12:04:17.997012519Z
`country`	string	Country of the place.	India
`country_code`	string	Country code, such as IN.	IN
`district`	string	District of the place.	Bengaluru Urban
`locality`	string	Locality of the place, such as Indiranagar.	Indiranagar
`location_eta_in_minutes`	integer	Estimated delivery time at the location, in minutes.	10
`location_eta_serviceable`	boolean	Whether Zepto delivers to the location.	true
`location_latitude`	number	Latitude of the location.	12.98
`location_longitude`	number	Longitude of the location.	77.64
`location_secondary_store_ids`	array	Backup stores serving the location.	071461ac-2354-4e5e-b5f5-04ef935f591c
`location_store_ids`	array	Zepto stores serving the location.	5b1796e1-36c2-4ae9-83a0-c03c25cac05a, 071461ac-2354-4e5e-b5f5-0…
`location_type`	string	Geometry precision label supplied with the place result.	APPROXIMATE
`place`	object	The resolved place.	14 fields
`place.captured_at`	string	When this result was collected.	2026-10-04T12:04:17.147024106Z
`place.city`	string	City of the place.	Bengaluru
`place.country`	string	Country of the place.	India
`place.country_code`	string	Country code, such as IN.	IN
`place.district`	string	District of the place.	Bengaluru Urban
`place.formatted_address`	string	Public locality/address label for the resolved place.	Indiranagar, Bengaluru, Karnataka, India
`place.latitude`	number	Latitude of the resolved or requested delivery point.	12.98
`place.locality`	string	Locality of the place, such as Indiranagar.	Indiranagar
`place.location_type`	string	Geometry precision label supplied with the place result.	APPROXIMATE
`place.longitude`	number	Longitude of the resolved or requested delivery point.	77.64
`place.place_id`	string	Identity used to request details for a selected place.	ChIJkQN3GKQWrjsRNhBQJrhGD7U
`place.state`	string	State of the place.	Karnataka
`place.state_code`	string	State code, such as KA.	KA
`place.types`	string	The kinds of place, such as locality.	political sublocality sublocality_level_1
`place_id`	string	Identity used to request details for a selected place.	ChIJkQN3GKQWrjsRNhBQJrhGD7U
`state`	string	State of the place.	Karnataka
`state_code`	string	State code, such as KA.	KA
`types`	string	The kinds of place, such as locality.	political sublocality sublocality_level_1

What to know

The response keeps the place's details apart from Zepto's delivery answer. Keep the address and coordinates separate from the serviceable and store fields.
A search with no match can answer not found. A broken place-details answer does not prove the place does not exist.

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

Something missing or unclear? Ask the team that builds the Zepto endpoints.