JioMart Collections API
Browse JioMart's collections and find the slug that lists each collection's products.
- 1 credit per call
- Failed calls are free
- Updated
- jiomart.collections.list
{ "page": { "current": 1, "has_next": true, "has_previous": false, "item_total": 28076, "total": 1404, "type": "number" }, "pagination": { "has_more": true, "total": 28076 }, "items": [ { "name": "Sound Bar and TV Speakers", "allow_facets": true, "allow_sort": true, "description": "Sound Bar and TV Speakers", "is_active": true, "is_visible": true, "priority": 1, "published": true, "slug": "sound-bar-and-tv-speakers", "sort_on": "popular", "type": "query", "uid": "6ab61ad458f6e1e3916f8d90", "action": { "type": "page", "page": { "type": "collection", "params": { "slug": [ "sound-bar-and-tv-speakers" ] } } }, "badge": { "text": "", "color": "#ffffff" }, "banners": { "landscape": { "type": "image", "url": "https://res.cloudinary.com/dwzm9bysq/image/upload/v1588857999/production/applications/app_000000000000000000000001/media/collection/landsca…" }, "portrait": { "type": "image", "url": "https://res.cloudinary.com/dwzm9bysq/image/upload/v1588858137/production/applications/app_000000000000000000000001/media/collection/portrai…" } }, "logo": { "type": "image", "url": "https://res.cloudinary.com/dwzm9bysq/image/upload/v1588857854/production/applications/app_000000000000000000000001/media/collection/logo/w9…" }, "seo": { "title": "Sound Bar and TV Speakers", "description": "Sound Bar and TV Speakers", "sitemap": { "frequency": "never", "priority": 0.5 }, "breadcrumbs": [ {} ], "meta_tags": [] }, "query": [ { "attribute": "department", "op": "in", "value": [ "electronics" ] }, { "attribute": "l1_category", "op": "in", "value": [ "tv-home-entertainment" ] } ], "tags": [], "visible_facets_keys": [] }, { "name": "PS5 and Controllers", "allow_facets": true, "allow_sort": true, "description": "PS5 and Controllers", "is_active": true, "is_visible": true, "priority": 2, "published": true, "slug": "ps5-and-controllers", "sort_on": "popular", "type": "query", "uid": "6ab61cf3cbb16c8e211f12b7", "action": { "type": "page", "page": { "type": "collection", "params": { "slug": [ "ps5-and-controllers" ] } } }, "badge": { "text": "", "color": "#ffffff" }, "banners": { "landscape": { "type": "image", "url": "https://res.cloudinary.com/dwzm9bysq/image/upload/v1588857999/production/applications/app_000000000000000000000001/media/collection/landsca…" }, "portrait": { "type": "image", "url": "https://res.cloudinary.com/dwzm9bysq/image/upload/v1588858137/production/applications/app_000000000000000000000001/media/collection/portrai…" } }, "logo": { "type": "image", "url": "https://res.cloudinary.com/dwzm9bysq/image/upload/v1588857854/production/applications/app_000000000000000000000001/media/collection/logo/w9…" }, "seo": { "title": "PS5 and Controllers", "description": "PS5 and Controllers", "sitemap": { "frequency": "never", "priority": 0.5 }, "breadcrumbs": [ {} ], "meta_tags": [] }, "query": [ { "attribute": "department", "op": "in", "value": [ "electronics" ] }, { "attribute": "l1_category", "op": "in", "value": [ "tv-home-entertainment" ] } ], "tags": [], "visible_facets_keys": [] } ]}
| # | Collection | Slug | Collection ID | Allow facets | Allow sort | Description | Is active | Is visible | Priority | Published |
|---|---|---|---|---|---|---|---|---|---|---|
| 1 | Sound Bar and TV Speakers | sound-bar-and-tv-speakers | 6ab61ad458f6e1e3916f8d90 | true | true | Sound Bar and TV Speakers | true | true | 1 | true |
| 2 | PS5 and Controllers | ps5-and-controllers | 6ab61cf3cbb16c8e211f12b7 | true | true | PS5 and Controllers | true | true | 2 | true |
| 3 | Trending Essentials | trending-essentials | 6ab3b78328b07f20881c6446 | true | true | Trending Essentials | true | true | 3 | true |
| 4 | smartwatches | smartwatches | 6ab3b6befd32bce112a50eb3 | true | true | smartwatches | true | true | 4 | true |
| 5 | shavers trimmers | shavers-trimmers | 6ab3b71138b8dab98ad573de | true | true | shavers trimmers | true | true | 5 | true |
| 6 | tablets ereaders | tablets-ereaders | 6ab3b74fe129b4beebaeada6 | true | true | tablets ereaders | true | true | 6 | true |
| 7 | charger powerbanks | charger-powerbanks | 6ab3b7c275a58556e2654f0c | true | true | charger powerbanks | true | true | 7 | true |
| 8 | juicers mixer grinders | juicers-mixer-grinders | 6ab3b863ed1a95ce1493f928 | true | true | juicers mixer grinders | true | true | 8 | true |
| 9 | Dhamakedar deals | dhamakedar-deals | 6ab0e831c548ab0d463a9c1a | true | true | Dhamakedar deals | true | true | 9 | true |
| 10 | Soft And Fresh | soft-and-fresh | 6aacc4bfc7bae495c63d942f | true | true | true | true | 10 | true |
What you send
The input
object of the request, with every field the endpoint accepts.
- Pages start at 1. The page size can be any positive number.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| page | integer | no | One-based result page to fetch. At least 1. | |
| page_size | integer | no | Number of results per page. At least 1. |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| items[].name | string | Product, brand, department, collection or content name as returned for the selected endpoint. | Sound Bar and TV Speakers |
| items[].slug | string | Product, brand or collection slug returned by JioMart for the sampled record. | sound-bar-and-tv-speakers |
| items[].uid | string | Brand or collection identifier returned by JioMart for directory records. | 6ab61ad458f6e1e3916f8d90 |
| items[].seo.title | string | The title. | Sound Bar and TV Speakers |
| items[].badge.text | string | The label's text. | |
| items[].action | object | Where the entry links to on JioMart. | 2 fields |
| items[].action.page | object | The page the entry opens, or this response's page details. | 2 fields |
| items[].action.type | string | The kind of record or suggestion, where JioMart gives one. | page |
| items[].allow_facets | boolean | true | |
| items[].allow_sort | boolean | true | |
| items[].badge | object | The label shown on the entry. | 2 fields |
| items[].badge.color | string | The label's colour. | #ffffff |
| items[].banners | object | Banner images for the entry. | 2 fields |
| items[].banners.* | object | 2 fields | |
| items[].description | string | The entry's description. | Sound Bar and TV Speakers |
| items[].is_active | boolean | Whether the entry is active. | true |
| items[].is_visible | boolean | Whether JioMart shows the entry. | true |
| items[].logo | object | The logo image. | 2 fields |
| items[].logo.type | string | The kind of record or suggestion, where JioMart gives one. | image |
| items[].logo.url | string | Link to the image. | https://res.cloudinary.com/dwzm9bysq/image/upload/v1588857854/p… |
| items[].priority | integer | The order JioMart shows it in. | 1 |
| items[].published | boolean | Whether the entry is published. | true |
| items[].query | array | 3 records | |
| items[].query[].attribute | string | department | |
| items[].query[].op | string | in | |
| items[].query[].value | array | electronics | |
| items[].seo | object | The page's search details: title, description, breadcrumbs. | 5 fields |
| items[].seo.breadcrumbs | array | Where the page sits in JioMart's site. | 1 records |
| items[].seo.description | string | The entry's description. | Sound Bar and TV Speakers |
| items[].seo.meta_tags | array | empty in this sample | |
| items[].seo.sitemap | object | 2 fields | |
| items[].sort_on | string | popular | |
| items[].tags | array | JioMart's tags for the product. | empty in this sample |
| items[].type | string | The kind of record or suggestion, where JioMart gives one. | query |
| items[].visible_facets_keys | array | empty in this sample | |
| items | array | The entries returned. | 20 records |
| page | object | The page the entry opens, or this response's page details. | 6 fields |
| page.current | integer | The current page number. | 1 |
| page.has_next | boolean | Whether another page follows. | true |
| page.has_previous | boolean | Whether a page comes before this one. | false |
| page.item_total | integer | How many entries there are in total. | 28,076 |
| page.total | integer | How many results there are in total. | 1404 |
| page.type | string | The kind of record or suggestion, where JioMart gives one. | number |
| pagination | object | Paging details for the results. | 2 fields |
| pagination.has_more | boolean | Whether more results follow. | true |
| pagination.total | integer | How many results there are in total. | 28,076 |
What this endpoint covers
- Collection records can include the slug, name, status, the search and filters behind the collection, and page details.
- Send a returned collection slug to Explore collection products. One response does not tell you how many collections there are in all.
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.collections.list", "input": {}}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "jiomart.collections.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.collections.list", "input": {}}),});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 the JioMart collections returned by the collection directory with their names, slugs and collection IDs.
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 Categories API1 credit
- JioMart Category Filters 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
The same data from other platforms
JioMart Collections API FAQ
The short answers. The docs have the long ones.
How much does the JioMart Collections 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.collections.list, 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.