Swiggy Instamart Suggest Locations
swiggy-instamart.location.suggest
Search by area, city or pincode and get place IDs you can resolve to coordinates.
At a glance
- Endpoint ID
swiggy-instamart.location.suggest- Price
- 1.5 credits per call; failed calls are free
- Runs for up to
- 120 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": "swiggy-instamart.location.suggest", "input": { "query": "560034" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "swiggy-instamart.location.suggest", "input": { "query": "560034" }}''')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": "swiggy-instamart.location.suggest", "input": { "query": "560034" }}),});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 of up to 200 characters. Use the returned place ID with location resolve.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
query |
string | yes | Search query. | 560034 |
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:
{ "places": [ { "description": "Bengaluru, Karnataka 560034, India", "place_id": "ChIJ9WX-XWcUrjsRcBEghxBKU1o" }, { "description": "560034, 2nd Cross Road, Koramangala 3 Block, Koramangala, Bengaluru, Karnataka, India", "place_id": "ChIJjZnUL1kUrjsRouLcBOiEhJU" } ]}
Fields
| Field | Type | What it is | Example |
|---|---|---|---|
places[].description |
string | Location suggestion description. | Bengaluru, Karnataka 560034, India |
places[].place_id |
string | Place identifier to pass to location.resolve. | ChIJ9WX-XWcUrjsRcBEghxBKU1o |
places |
array | Places matching what you typed. | 5 records |
What to know
- A suggestion is a candidate location, not proof that Instamart delivers there. Resolve it, then check location.serviceability at its coordinates.
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 Swiggy Instamart endpoints
swiggy-instamart.categories.listCategoriesswiggy-instamart.category.products.listCategory productsswiggy-instamart.collection.products.listCollection productsswiggy-instamart.etaDelivery ETAswiggy-instamart.home.listHome productsswiggy-instamart.location.resolveResolve locationswiggy-instamart.location.serviceabilityResolve serviceabilityswiggy-instamart.product.getProductswiggy-instamart.products.searchProducts searchswiggy-instamart.search.suggestionsSuggestions search
Something missing or unclear? Ask the team that builds the Swiggy Instamart endpoints.