JioMart Autocomplete Search API
Read JioMart autocomplete suggestions for a query to study the terms and product language shoppers see in search.
- 1 credit per call
- Failed calls are free
- Updated
- jiomart.autocomplete.search
{ "suggestions": [ { "display": "rice", "image": "https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/images/othe/egurhk/.j/pg/0000000004911738851.jpg.9f5a238d8d.jpg", "type": "product" }, { "display": "rice 26 kg", "image": "https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/images/othe/egurhk/.j/pg/0000000004942604491.jpg.1f7e111cc1.jpg", "type": "product" } ]}
| # | Suggestion | Type | Image |
|---|---|---|---|
| 1 | rice | product | https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/im… |
| 2 | rice 26 kg | product | https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/im… |
| 3 | rice bran oil | product | https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/im… |
| 4 | rice 5kg | product | https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/im… |
| 5 | rice 10kg | product | https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/im… |
| 6 | rice flour | product | https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/im… |
| 7 | rice 1kg | product | https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/im… |
| 8 | rice bran oil 1 litre | product | https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/im… |
| 9 | rice flour 1kg | product | https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/im… |
| 10 | rice bag | product | https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/im… |
What you send
The input
object of the request, with every field the endpoint accepts.
- Send a search term of at least three characters, not counting spaces at either end. A pincode, if you send one, must be a six-digit Indian PIN; the location can also carry a pincode, city and state.
- Set limit from 1 to 50 to cap how many suggestions come back.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| query | string | yes | At least three characters after trimming, as required by JioMart autocomplete. | rice |
| limit | integer | no | Maximum number of results to return. From 1 to 50. | |
| location | object | no | ||
| pincode | string | no | Postal code (PIN) that sets the delivery location. |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| suggestions[].display | string | Autocomplete suggestion text returned by JioMart. | rice |
| suggestions[].type | string | The kind of record or suggestion, where JioMart gives one. | product |
| suggestions[].image | string | Link to the suggestion's image. | https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/im… |
| suggestions | array | Search suggestions for what you typed. | 15 records |
What this endpoint covers
- Suggestions are what JioMart offers as a shopper types. They are not search results, search volumes or proof of stock.
- To get the products, send a suggestion as the search term to Search JioMart products.
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": "jiomart.autocomplete.search", "input": { "query": "rice" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "jiomart.autocomplete.search", "input": { "query": "rice" }}''')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": "jiomart.autocomplete.search", "input": { "query": "rice" }}),});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
Show JioMart autocomplete suggestions for rice and group the suggestions by their returned type.
More from the JioMart API
- JioMart Products Search API1 credit
- JioMart Products API1 credit
- JioMart Collection Products API1 credit
- JioMart Product Detail API1 credit
- JioMart Product Fulfillment API1 credit
- JioMart Multi-location Product Availability API1 credit
- JioMart Sponsored Products Ads API1 credit
- JioMart Brands API1 credit
- JioMart Categories API1 credit
- JioMart Category Filters API1 credit
- JioMart Collections API1 credit
- JioMart Departments API1 credit
- JioMart Home Listing API1 credit
- JioMart Pincode Location API1 credit
- JioMart Logistics Countries API1 credit
- JioMart Navigations API1 credit
- JioMart Pages API1 credit
JioMart Autocomplete Search API FAQ
The short answers. The docs have the long ones.
How much does the JioMart Autocomplete 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 JioMart login?
No. It reads public JioMart data; nothing runs on your account.
Can my AI agent call it?
Yes, over MCP: the agent finds jiomart.autocomplete.search, checks its price and runs it with the same credits as the REST API.
Your first JioMart call is free.
Up to 100 free credits to start, no card needed.