↑ ↓ to move ↵ to open
Swiggy Instamart API reference

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
POST /execute
Run an endpoint
MCP tool when pinned
swiggy-instamart__location__suggest
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": "swiggy-instamart.location.suggest",  "input": {    "query": "560034"  }}'

Input

  • Send a place name of up to 200 characters. Use the returned place ID with location resolve.
FieldTypeRequiredWhat it doesExample
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:

results[0].data
{  "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

FieldTypeWhat it isExample
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

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