Swiggy Instamart Suggestions Search API
See autocomplete suggestions for a query at a pincode.
- 1 credit per call
- Failed calls are free
- Updated
- swiggy-instamart.search.suggestions
{ "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" } ]}
| # | Suggestion | Highlight | Type | Link |
|---|---|---|---|---|
| 1 | Milk | {{Milk}} | SUGGESTION_TYPE_INSTAMART_CATEGORY | swiggy://stores/instamart/search?query=Milk&metadata=%7B%22type… |
| 2 | Nandini milk | Nandini {{milk}} | SUGGESTION_TYPE_INSTAMART_HYBRID | swiggy://stores/instamart/search?query=Nandini%20milk&metadata=… |
| 3 | Organic Milk | Organic {{Milk}} | SUGGESTION_TYPE_INSTAMART_HYBRID | swiggy://stores/instamart/search?query=Organic%20Milk&metadata=… |
| 4 | Tetra Milk | Tetra {{Milk}} | SUGGESTION_TYPE_INSTAMART_CATEGORY | swiggy://stores/instamart/search?query=Tetra%20Milk&metadata=%7… |
| 5 | Amul milk | Amul {{milk}} | SUGGESTION_TYPE_INSTAMART_HYBRID | swiggy://stores/instamart/search?query=Amul%20milk&metadata=%7B… |
| 6 | ₹9 Everyday! | {{₹9 Everyday!}} | SUGGESTION_TYPE_INSTAMART_CATEGORY_HOME | swiggy://stores/instamart/campaign-collection/mxn?layoutId=2424… |
| 7 | Dairy Milk | Dairy {{Milk}} | SUGGESTION_TYPE_INSTAMART_HYBRID | swiggy://stores/instamart/search?query=Dairy%20Milk&metadata=%7… |
| 8 | Coconut Milk Powder | Coconut {{Milk}} Powder | SUGGESTION_TYPE_INSTAMART_HYBRID | swiggy://stores/instamart/search?query=Coconut%20Milk%20Powder&… |
| 9 | Milk Bikis | {{Milk}} Bikis | SUGGESTION_TYPE_INSTAMART_HYBRID | swiggy://stores/instamart/search?query=Milk%20Bikis&metadata=%7… |
What you send
The input
object of the request, with every field the endpoint accepts.
- 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.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| query | string | yes | Search query. | milk |
| pincode | string | one of | Postal code (PIN) that sets the delivery location. | 560034 |
| store_id | string | one of | Store identifier. | |
| primary_store_id | string | no | Primary store identifier. | |
| tracking_id | string | no | Tracking identifier. |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| 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 this endpoint covers
- Suggestions are autocomplete choices, not a product-stock response. Use products.search to collect matching product packs and product.get to confirm availability.
Call it from your code, or ask your agent
Set UPSCRAPE_API_KEY to your key and copy a working request.
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" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "swiggy-instamart.search.suggestions", "input": { "pincode": "560034", "query": "milk" }}''')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.search.suggestions", "input": { "pincode": "560034", "query": "milk" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
https://data.upscrape.com/mcp
With Upscrape, get the Swiggy Instamart suggestions search for pincode "560034" and query "milk". Tell me what it costs before you run it, then show the results as a table.
More from the Swiggy Instamart API
- Swiggy Instamart Products Search API1 credit
- Swiggy Instamart Product API1 credit
- Swiggy Instamart Categories API1 credit
- Swiggy Instamart Category Products API1 credit
- Swiggy Instamart Home Products API1 credit
- Swiggy Instamart Suggest Locations API1 credit
- Swiggy Instamart Resolve Location API1 credit
- Swiggy Instamart Resolve Serviceability API1 credit
- Swiggy Instamart Delivery ETA API1 credit
The same data from other platforms
Swiggy Instamart Suggestions Search API FAQ
The short answers. The docs have the long ones.
How much does the Swiggy Instamart Suggestions Search API cost?
1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.
What do I send?
Send query. The input fields below list every option with its type and limits.
Do I need a Swiggy Instamart login?
No. It reads public Swiggy Instamart data; nothing runs on your account.
Can my AI agent call it?
Yes, over MCP: the agent finds swiggy-instamart.search.suggestions, checks its price and runs it with the same credits as the REST API.
Your first Swiggy Instamart call is free.
Up to 100 free credits to start, no card needed.