↑ ↓ to move ↵ to open
Swiggy Instamart API reference

Swiggy Instamart Suggestions Search

swiggy-instamart.search.suggestions

See autocomplete suggestions for a query at a pincode.

At a glance

Endpoint ID
swiggy-instamart.search.suggestions
Price
2 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__search__suggestions
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.search.suggestions",  "input": {    "pincode": "560034",    "query": "milk"  }}'

Input

  • Send a search term of up to 200 characters with a six-digit pincode. A store ID or coordinates alone are not enough; if you add a store ID, it must be the store serving that pincode.
FieldTypeRequiredWhat it doesExample
pincode string yes 6-digit Indian PIN code of the delivery location; Instamart suggests from the store serving it 560034
query string yes Search query. milk
primary_store_id string no Optional check: must equal the primary store serving the delivery location
store_id string no Optional check: the Instamart store you expect. Instamart picks the store from the delivery location (pincode); a different store is rejected, never substituted
tracking_id string no Tracking identifier.

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
{  "suggestions": [    {      "text": "Milk",      "highlighted_text": "{{Milk}}",      "link": "swiggy://stores/instamart/search?query=Milk&metadata=%7B%22type%22%3A%22CATEGORY%22%2C%22data%22%3A%7B%22cloudinaryId%22%3A%22NI_CATALOG%2F…",      "type": "SUGGESTION_TYPE_INSTAMART_CATEGORY"    },    {      "text": "Nandini milk",      "highlighted_text": "Nandini {{milk}}",      "link": "swiggy://stores/instamart/search?query=Nandini%20milk&metadata=%7B%22type%22%3A%22HYBRID%22%2C%22data%22%3A%7B%22cloudinaryId%22%3A%22NI_CA…",      "type": "SUGGESTION_TYPE_INSTAMART_HYBRID"    }  ]}

Fields

FieldTypeWhat it isExample
suggestions[].text string Suggestion text where supplied. Milk
suggestions[].highlighted_text string Autocomplete text as shown, with Swiggy's highlight marks. {{Milk}}
suggestions[].link string The link the suggestion opens in the Instamart app. swiggy://stores/instamart/search?query=Milk&metadata=%7B%22type…
suggestions[].type string The product types you can filter by. SUGGESTION_TYPE_INSTAMART_CATEGORY
suggestions array Search suggestions for what you typed. 9 records

What to know

  • Suggestions are autocomplete choices, not a product-stock response. Use products.search to collect matching product packs and product.get to confirm availability.

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.