JioMart API · Endpoint
JioMart Categories API
Read the JioMart category tree and the department each category belongs to.
- 1 credit per call
- Failed calls are free
- Updated
- jiomart.categories.list
Response
completed
{ "raw": { "data": [ { "department": "electronics", "items": [ { "name": "Personal Care", "priority": 5, "slug": "personal-care", "uid": 133, "action": { "type": "page", "page": { "type": "products", "query": { "category": [ "personal-care" ], "department": [ "electronics" ] } } }, "banners": { "landscape": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/GEbTawJ0I7-eyAL5fyLu-landscape.png" }, "portrait": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/cI68xnzP3fS-tFgNNHB5C-banner.png" } }, "logo": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jiomart-fynd/jio-pd/original/products/pictures/item/free/original/zzOUJEM_wL-personal-care-20240620.png" }, "childs": [ { "name": "Trimmers", "priority": 201866, "slug": "trimmers-l2", "uid": 1745, "action": { "type": "page", "page": { "type": "products", "query": { "category": [ "trimmers-l2" ], "department": [ "electronics" ] } } }, "banners": { "landscape": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/7wv80XyoqR-landsc.jpeg" }, "portrait": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/zNE8Pg3a9H-por.jpeg" } }, "logo": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jiomart-fynd/jio-pd/original/products/pictures/item/free/original/a-hgUCs60lP-trimmers-20240531.png" }, "childs": [ { "name": "Trimmers", "priority": 343, "slug": "trimmers", "uid": 11120, "action": { "type": "page", "page": { "type": "products", "query": { "category": [ "trimmers" ], "department": [ "electronics" ] } } }, "banners": { "landscape": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/Cso7HAmk-T-ECjYOXAWSd-BizbZdLqn-lo…" }, "portrait": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/Cso7HAmk-T-ECjYOXAWSd-BizbZdLqn-lo…" } }, "logo": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/Cso7HAmk-T-ECjYOXAWSd-BizbZdLqn-lo…" }, "childs": [] } ] } ] }, { "name": "Mobiles & Tablets", "priority": 2001, "slug": "mobiles-tablets", "uid": 55, "action": { "type": "page", "page": { "type": "products", "query": { "category": [ "mobiles-tablets" ], "department": [ "electronics" ] } } }, "banners": { "landscape": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/g0slk1ne9Pz-lmYZPrpR82-BizbZdLqn-l…" }, "portrait": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/g0slk1ne9Pz-lmYZPrpR82-BizbZdLqn-l…" } }, "logo": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jiomart-fynd/jio-pd/original/products/pictures/item/free/original/fN_YQM-ic_1-mobiles-tablets-20221212.png" }, "childs": [ { "name": "Regular Tablets", "priority": 200244, "slug": "regular-tablets", "uid": 492, "action": { "type": "page", "page": { "type": "products", "query": { "category": [ "regular-tablets" ], "department": [ "electronics" ] } } }, "banners": { "landscape": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/bYViDC_yLJ-lmYZPrpR82-BizbZdLqn-lo…" }, "portrait": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/bYViDC_yLJ-lmYZPrpR82-BizbZdLqn-lo…" } }, "logo": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jiomart-fynd/jio-pd/original/products/pictures/item/free/original/EiEQH4zS0F-regular-tablets-20221212.png" }, "childs": [ { "name": "Regular Tablets", "priority": 395, "slug": "regular-tablets-l3", "uid": 12491, "action": { "type": "page", "page": { "type": "products", "query": { "category": [ "regular-tablets-l3" ], "department": [ "electronics" ] } } }, "banners": { "landscape": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/thaix4_MK8-kcIcKHDdSl-BizbZdLqn-lo…" }, "portrait": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/thaix4_MK8-kcIcKHDdSl-BizbZdLqn-lo…" } }, "logo": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/thaix4_MK8-kcIcKHDdSl-BizbZdLqn-lo…" }, "childs": [] } ] } ] } ] }, { "department": "jewellery", "items": [ { "name": "Fine Jewellery", "priority": 3001, "slug": "fine-jewellery-l1", "uid": 9711, "action": { "type": "page", "page": { "type": "products", "query": { "category": [ "fine-jewellery-l1" ], "department": [ "jewellery" ] } } }, "banners": { "landscape": { "type": "image" }, "portrait": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/izT1euCI_4-P_fiY4SmHg-xxENfkqXO-ba…" } }, "logo": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jiomart-fynd/jio-pd/original/products/pictures/item/free/original/qX5aiFE8ais-fine-jewellery-20241128.png" }, "childs": [ { "name": "Silver Jewellery", "priority": 200323, "slug": "silver-jewellery", "uid": 691, "action": { "type": "page", "page": { "type": "products", "query": { "category": [ "silver-jewellery" ], "department": [ "jewellery" ] } } }, "banners": { "landscape": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/kgS-INJpwZ-yAh6TbECGx-BizbZdLqn-lo…" }, "portrait": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/kgS-INJpwZ-yAh6TbECGx-BizbZdLqn-lo…" } }, "logo": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jiomart-fynd/jio-pd/original/products/pictures/item/free/original/ITv6F9kbgt-silver-jewellery-20241128.png" }, "childs": [ { "name": "Silver Necklaces & Chains", "priority": 502, "slug": "silver-necklaces-chains", "uid": 11802, "action": { "type": "page", "page": { "type": "products", "query": { "category": [ "silver-necklaces-chains" ], "department": [ "jewellery" ] } } }, "banners": { "landscape": { "type": "image" }, "portrait": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/yC9sqvPmFz-D0FmUcd-Gk-xxENfkqXO-ba…" } }, "logo": { "type": "image" }, "childs": [] }, { "name": "Silver Rings & Toe Rings", "priority": 504, "slug": "silver-rings-toe-rings", "uid": 11805, "action": { "type": "page", "page": { "type": "products", "query": { "category": [ "silver-rings-toe-rings" ], "department": [ "jewellery" ] } } }, "banners": { "landscape": { "type": "image" }, "portrait": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/yC9sqvPmFz-D0FmUcd-Gk-xxENfkqXO-ba…" } }, "logo": { "type": "image" }, "childs": [] } ] }, { "name": "Gold Coins & Bars", "priority": 201260, "slug": "gold-coins-and-bars-l2", "uid": 1061, "action": { "type": "page", "page": { "type": "products", "query": { "category": [ "gold-coins-and-bars-l2" ], "department": [ "jewellery" ] } } }, "banners": { "landscape": { "type": "image" }, "portrait": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/ZG1s2NKn3pn-P_fiY4SmHg-xxENfkqXO-b…" } }, "logo": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jiomart-fynd/jio-pd/original/products/pictures/item/free/original/GI2Da5WYj5-gold-coins-bars-20241128.png" }, "childs": [ { "name": "Gold Coins", "priority": 352, "slug": "gold-coins", "uid": 11763, "action": { "type": "page", "page": { "type": "products", "query": { "category": [ "gold-coins" ], "department": [ "jewellery" ] } } }, "banners": { "landscape": { "type": "image" }, "portrait": { "type": "image", "url": "https://cdn1.jiomartjcp.com/v2/jio-mart-2/MOluAr/original/jiomarty0/products/pictures/item/free/original/yC9sqvPmFz-D0FmUcd-Gk-xxENfkqXO-ba…" } }, "logo": { "type": "image" }, "childs": [] } ] } ] } ] } ], "departments": [ { "slug": "electronics", "uid": 4 }, { "slug": "jewellery", "uid": 11 } ] }, "departments": [ { "slug": "electronics", "uid": 4 }, { "slug": "jewellery", "uid": 11 } ]}
| # | Slug | Uid |
|---|---|---|
| 1 | electronics | 4 |
| 2 | jewellery | 11 |
| 3 | fashion | 2 |
Input
What you send
The input
object of the request, with every field the endpoint accepts.
- Send nothing for every category, or a department to narrow the list to that JioMart department.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| department | string | no |
Response
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| departments[].slug | string | Product, brand or collection slug returned by JioMart for the sampled record. | electronics |
| departments[].uid | integer | Brand or collection identifier returned by JioMart for directory records. | 4 |
| departments | array | JioMart's departments. | 3 records |
| raw | object | JioMart's own response, as it came back. | 2 fields |
| raw.data | array | Categories grouped by department. | 3 records |
| raw.data[].department | string | The department, such as electronics. | electronics |
| raw.data[].items | array | The department's categories. | 3 records |
| raw.departments | array | JioMart's departments. | 3 records |
| raw.departments[].slug | string | The department's name as used in JioMart links. | electronics |
| raw.departments[].uid | integer | JioMart's ID for the department. | 4 |
Know before you build
What this endpoint covers
- Use the returned department and category IDs to browse the catalogue.
- A category being listed does not show which products are stocked at a PIN.
REST API · MCP server
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.categories.list", "input": {}}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "jiomart.categories.list", "input": {}}''')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.categories.list", "input": {}}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
In your AI agent
Claude · Cursor · any MCP client
1Add the Upscrape MCP server
2Ask for the data in plain words
The agent finds the endpoint, shows you the price, and runs it with your credits.
https://data.upscrape.com/mcp
With Upscrape, get the JioMart categories. Tell me what it costs before you run it, then show the results as a table.
JioMart
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 Autocomplete Search API1 credit
- JioMart Sponsored Products Ads API1 credit
- JioMart Brands 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
Same data, other platforms
The same data from other platforms
Aldi UKCategories
AsdaCategories
BlinkitCategories
Flipkart CommerceSearch categories
Flipkart MinutesDiscover categories
IcelandCategories
Questions
JioMart Categories API FAQ
The short answers. The docs have the long ones.
Still have a question?
Talk to the people who build the endpoints.
How much does the JioMart Categories API cost?
1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.
What do I send?
Every input is optional; the input fields below list what each one does.
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.categories.list, checks its price and runs it with the same credits as the REST API.
Get started
Your first JioMart call is free.
Up to 100 free credits to start, no card needed.