JioMart API reference

JioMart Home Listing

jiomart.home.listing

Read the JioMart home product feed for a location, page by page.

JioMart Home Listing API: overview and live sample

At a glance

Endpoint ID: jiomart.home.listing
Price: 1 credit per call; failed calls are free
Runs for up to: 30 seconds
Request: POST /execute; Run an endpoint
MCP tool when pinned: jiomart__home__listing; 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": "jiomart.home.listing",  "input": {    "page_size": 10,    "pincode": "400001"  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "jiomart.home.listing",  "input": {    "page_size": 10,    "pincode": "400001"  }}''')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.home.listing",  "input": {    "page_size": 10,    "pincode": "400001"  }}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));

Input

The pincode, if you send one, must be a six-digit Indian PIN. The page size can be any positive number. Follow the returned page ID for the next page.
The sort is sent to JioMart as it is; the feed may not come back fully sorted.

Field	Type	Required	What it does	Example
`page_id`	string	no	Page identifier.
`page_size`	integer	no	Number of results per page. At least 1.	10
`pincode`	string	no	Postal code (PIN) that sets the delivery location.	400001
`sort_on`	string	no	Passed unchanged to JioMart; results preserve JioMart's own order. price_asc is not guaranteed to be strictly ascending. No local page sorting.

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

{  "page": {    "has_next": true,    "has_previous": false,    "item_total": 2392812,    "type": "cursor"  },  "raw": {    "sort_on": "score desc, random_706a230e619d45fdab7e5891a9f98d59 asc",    "page": {      "has_next": true,      "has_previous": false,      "item_total": 2392812,      "type": "cursor"    },    "items": [      {        "name": "Little Angel Easy Dry Pull-up Diaper Pants with 12 hrs absorption Extra Large (XL) Size, Pack of 2,13-16 Kgs - XL (108 Pieces)",        "channel": "685945f46c8c7aee3f3af605",        "country_of_origin": "India",        "discount": "56% OFF",        "is_tryout": false,        "item_code": "RVRCB4AQDH",        "item_type": "standard",        "sellable": true,        "short_description": "",        "type": "product",        "uid": 50516055,        "price": {          "effective": {            "currency_code": "INR",            "currency_symbol": "₹",            "max": 959,            "min": 959          },          "marked": {            "currency_code": "INR",            "currency_symbol": "₹",            "max": 2198,            "min": 2198          },          "selling": {            "currency_code": "INR",            "currency_symbol": "₹",            "max": 959,            "min": 959          }        },        "action": {          "type": "page",          "page": {            "type": "product",            "params": {              "slug": []            }          }        },        "attributes": {          "available-at-1p-kirana": "false",          "available-at-3p-kirana": "false",          "available-at-3p-seller": "true",          "available-at-rrl-fc": "false",          "brand-id": "943",          "catalog-source": "INFIBEAM",          "category-l1": "Mom & Baby Care",          "category-l2": "Diapers & Wipes",          "dimensions-productheight": "22.0",          "dimensions-productlength": "39.0",          "dimensions-productweight": "3570.0",          "dimensions-productwidth": "31.0",          "is-rrl-exclusive": "false",          "is-sodexo-eligible": "false",          "l1-category": "Mom & Baby Care",          "l2-category": "Diapers & Wipes",          "l3-category": "Diapers",          "manufacturedetails-manufactureid": "977",          "primary_color_hex": null,          "qty": "2",          "search-keywords": "XL-size-baby-diaper,Extra-Large-Baby-diaper,Baby-diaper-pants,Little-angel-baby-diaper,Easy-dry-baby-diaper-pants,Diaper-Pants,baby-diaper,…",          "seller-type": "3p",          "vertical-code": "GROCERIES"        },        "brand": {          "name": "little angel",          "type": "brand",          "action": {            "type": "page",            "page": {              "type": "products",              "query": {                "brand": [                  "little-angel--943"                ]              }            }          },          "logo": {            "type": "image",            "url": "https://cdn1.jiomartjcp.com/v2/default_image.jpg"          }        },        "discount_meta": {},        "moq": {          "increment_unit": 1,          "minimum": 1        },        "net_quantity": {},        "seo": {          "title": "Little Angel Easy Dry Pull-up Diaper Pants with 12 hrs absorption Extra Large (XL) Size, Pack of 2,13-16 Kgs - XL (108 Pieces)",          "description": ""        },        "categories": [          {            "name": "Diapers",            "uid": 10225,            "action": {              "type": "page",              "page": {                "type": "products",                "query": {                  "category": [                    "diapers"                  ]                }              }            },            "logo": {              "type": "image",              "url": "https://hdn-1.fynd.com/media/banner_portrait/brand/original/540_ecba3a1af141467da8abc20500f983db.jpg"            }          }        ],        "identifiers": [          "RVRCB4AQDH"        ],        "medias": [          {            "alt": "Little Angel Easy Dry Pull-up Diaper Pants with 12 hrs absorption Extra Large (XL) Size, Pack of 2,13-16 Kgs - XL (108 Pieces)",            "type": "image",            "url": "https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/images/othe/n5qubf/.p/ng/easydrycomboxl.png.bf4c1a75f8.png"          },          {            "alt": "Little Angel Easy Dry Pull-up Diaper Pants with 12 hrs absorption Extra Large (XL) Size, Pack of 2,13-16 Kgs - XL (108 Pieces)",            "type": "image",            "url": "https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/images/othe/n5qubf/.j/pg/2.jpg.cd26358d27.jpg"          }        ],        "sizes": [          "OS"        ],        "tags": [          "NON-RX",          "seller_3p"        ],        "variants": []      },      {        "name": "Care N Made | Purple | New Design Bom Shape Tyre Air Valve Bom Caps, Funny Car Tyre Caps | Metal Air Valve Caps for Tyre | Cool Accessories…",        "channel": "685945f46c8c7aee3f3af605",        "country_of_origin": "India",        "discount": "71% OFF",        "is_tryout": false,        "item_code": "RVMJCHOFOK",        "item_type": "standard",        "sellable": true,        "short_description": "",        "type": "product",        "uid": 54886128,        "price": {          "effective": {            "currency_code": "INR",            "currency_symbol": "₹",            "max": 399,            "min": 399          },          "marked": {            "currency_code": "INR",            "currency_symbol": "₹",            "max": 1400,            "min": 1400          },          "selling": {            "currency_code": "INR",            "currency_symbol": "₹",            "max": 399,            "min": 399          }        },        "action": {          "type": "page",          "page": {            "type": "product",            "params": {              "slug": []            }          }        },        "attributes": {          "available-at-1p-kirana": "false",          "available-at-3p-kirana": "false",          "available-at-3p-seller": "true",          "available-at-rrl-fc": "false",          "brand-id": "49109",          "catalog-source": "INFIBEAM",          "category-l1": "Auto Care",          "category-l2": "Car & Bike Parts",          "dimensions-productheight": "10.0",          "dimensions-productlength": "5.0",          "dimensions-productweight": "20.0",          "dimensions-productwidth": "8.0",          "is-rrl-exclusive": "false",          "is-sodexo-eligible": "false",          "l1-category": "Auto Care",          "l2-category": "Car & Bike Parts",          "l3-category": "Car Hub Caps",          "manufacturedetails-manufactureid": "51240",          "primary_color_hex": null,          "qty": "8",          "search-keywords": "luminous car tyre valve cap,tyre valve cap light,car tyre air valve cap",          "seller-type": "3p",          "vertical-code": "HOMEIMPROVEMENT"        },        "brand": {          "name": "Care N Made",          "type": "brand",          "action": {            "type": "page",            "page": {              "type": "products",              "query": {                "brand": [                  "care-n-made--49109"                ]              }            }          },          "logo": {            "type": "image",            "url": "https://cdn1.jiomartjcp.com/v2/default_image.jpg"          }        },        "discount_meta": {},        "moq": {          "increment_unit": 1,          "minimum": 1        },        "net_quantity": {},        "seo": {          "title": "Care N Made | Purple | New Design Bom Shape Tyre Air Valve Bom Caps, Funny Car Tyre Caps | Metal Air Valve Caps for Tyre | Cool Accessories…",          "description": ""        },        "categories": [          {            "name": "Car Hub Caps",            "uid": 7653,            "action": {              "type": "page",              "page": {                "type": "products",                "query": {                  "category": [                    "car-hub-caps"                  ]                }              }            },            "logo": {              "type": "image",              "url": "https://hdn-1.fynd.com/media/banner_portrait/brand/original/540_ecba3a1af141467da8abc20500f983db.jpg"            }          }        ],        "identifiers": [          "RVMJCHOFOK"        ],        "medias": [          {            "alt": "Care N Made | Purple | New Design Bom Shape Tyre Air Valve Bom Caps, Funny Car Tyre Caps | Metal Air Valve Caps for Tyre | Cool Accessories…",            "type": "image",            "url": "https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/images/othe/zfmxjh/.j/pg/dropbox.1711653.f59189c968ee77321608a70f2c1c80d9_1.jpg"          },          {            "alt": "Care N Made | Purple | New Design Bom Shape Tyre Air Valve Bom Caps, Funny Car Tyre Caps | Metal Air Valve Caps for Tyre | Cool Accessories…",            "type": "image",            "url": "https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/images/othe/zfmxjh/.j/pg/dropbox.1711653.4d39d32127df823697cdfc7b6fd52f2d_2.jpg"          }        ],        "sizes": [          "OS"        ],        "tags": [          "seller_3p",          "NON-RX"        ],        "variants": []      }    ]  },  "items": [    {      "name": "Little Angel Easy Dry Pull-up Diaper Pants with 12 hrs absorption Extra Large (XL) Size, Pack of 2,13-16 Kgs - XL (108 Pieces)",      "channel": "685945f46c8c7aee3f3af605",      "country_of_origin": "India",      "discount": "56% OFF",      "is_tryout": false,      "item_code": "RVRCB4AQDH",      "item_type": "standard",      "sellable": true,      "short_description": "",      "type": "product",      "uid": 50516055,      "price": {        "effective": {          "currency_code": "INR",          "currency_symbol": "₹",          "max": 959,          "min": 959        },        "marked": {          "currency_code": "INR",          "currency_symbol": "₹",          "max": 2198,          "min": 2198        },        "selling": {          "currency_code": "INR",          "currency_symbol": "₹",          "max": 959,          "min": 959        }      },      "action": {        "type": "page",        "page": {          "type": "product",          "params": {            "slug": []          }        }      },      "attributes": {        "available-at-1p-kirana": "false",        "available-at-3p-kirana": "false",        "available-at-3p-seller": "true",        "available-at-rrl-fc": "false",        "brand-id": "943",        "catalog-source": "INFIBEAM",        "category-l1": "Mom & Baby Care",        "category-l2": "Diapers & Wipes",        "dimensions-productheight": "22.0",        "dimensions-productlength": "39.0",        "dimensions-productweight": "3570.0",        "dimensions-productwidth": "31.0",        "is-rrl-exclusive": "false",        "is-sodexo-eligible": "false",        "l1-category": "Mom & Baby Care",        "l2-category": "Diapers & Wipes",        "l3-category": "Diapers",        "manufacturedetails-manufactureid": "977",        "primary_color_hex": null,        "qty": "2",        "search-keywords": "XL-size-baby-diaper,Extra-Large-Baby-diaper,Baby-diaper-pants,Little-angel-baby-diaper,Easy-dry-baby-diaper-pants,Diaper-Pants,baby-diaper,…",        "seller-type": "3p",        "vertical-code": "GROCERIES"      },      "brand": {        "name": "little angel",        "type": "brand",        "action": {          "type": "page",          "page": {            "type": "products",            "query": {              "brand": [                "little-angel--943"              ]            }          }        },        "logo": {          "type": "image",          "url": "https://cdn1.jiomartjcp.com/v2/default_image.jpg"        }      },      "discount_meta": {},      "moq": {        "increment_unit": 1,        "minimum": 1      },      "net_quantity": {},      "seo": {        "title": "Little Angel Easy Dry Pull-up Diaper Pants with 12 hrs absorption Extra Large (XL) Size, Pack of 2,13-16 Kgs - XL (108 Pieces)",        "description": ""      },      "categories": [        {          "name": "Diapers",          "uid": 10225,          "action": {            "type": "page",            "page": {              "type": "products",              "query": {                "category": [                  "diapers"                ]              }            }          },          "logo": {            "type": "image",            "url": "https://hdn-1.fynd.com/media/banner_portrait/brand/original/540_ecba3a1af141467da8abc20500f983db.jpg"          }        }      ],      "identifiers": [        "RVRCB4AQDH"      ],      "medias": [        {          "alt": "Little Angel Easy Dry Pull-up Diaper Pants with 12 hrs absorption Extra Large (XL) Size, Pack of 2,13-16 Kgs - XL (108 Pieces)",          "type": "image",          "url": "https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/images/othe/n5qubf/.p/ng/easydrycomboxl.png.bf4c1a75f8.png"        },        {          "alt": "Little Angel Easy Dry Pull-up Diaper Pants with 12 hrs absorption Extra Large (XL) Size, Pack of 2,13-16 Kgs - XL (108 Pieces)",          "type": "image",          "url": "https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/images/othe/n5qubf/.j/pg/2.jpg.cd26358d27.jpg"        }      ],      "sizes": [        "OS"      ],      "tags": [        "NON-RX",        "seller_3p"      ],      "variants": []    },    {      "name": "Care N Made | Purple | New Design Bom Shape Tyre Air Valve Bom Caps, Funny Car Tyre Caps | Metal Air Valve Caps for Tyre | Cool Accessories…",      "channel": "685945f46c8c7aee3f3af605",      "country_of_origin": "India",      "discount": "71% OFF",      "is_tryout": false,      "item_code": "RVMJCHOFOK",      "item_type": "standard",      "sellable": true,      "short_description": "",      "type": "product",      "uid": 54886128,      "price": {        "effective": {          "currency_code": "INR",          "currency_symbol": "₹",          "max": 399,          "min": 399        },        "marked": {          "currency_code": "INR",          "currency_symbol": "₹",          "max": 1400,          "min": 1400        },        "selling": {          "currency_code": "INR",          "currency_symbol": "₹",          "max": 399,          "min": 399        }      },      "action": {        "type": "page",        "page": {          "type": "product",          "params": {            "slug": []          }        }      },      "attributes": {        "available-at-1p-kirana": "false",        "available-at-3p-kirana": "false",        "available-at-3p-seller": "true",        "available-at-rrl-fc": "false",        "brand-id": "49109",        "catalog-source": "INFIBEAM",        "category-l1": "Auto Care",        "category-l2": "Car & Bike Parts",        "dimensions-productheight": "10.0",        "dimensions-productlength": "5.0",        "dimensions-productweight": "20.0",        "dimensions-productwidth": "8.0",        "is-rrl-exclusive": "false",        "is-sodexo-eligible": "false",        "l1-category": "Auto Care",        "l2-category": "Car & Bike Parts",        "l3-category": "Car Hub Caps",        "manufacturedetails-manufactureid": "51240",        "primary_color_hex": null,        "qty": "8",        "search-keywords": "luminous car tyre valve cap,tyre valve cap light,car tyre air valve cap",        "seller-type": "3p",        "vertical-code": "HOMEIMPROVEMENT"      },      "brand": {        "name": "Care N Made",        "type": "brand",        "action": {          "type": "page",          "page": {            "type": "products",            "query": {              "brand": [                "care-n-made--49109"              ]            }          }        },        "logo": {          "type": "image",          "url": "https://cdn1.jiomartjcp.com/v2/default_image.jpg"        }      },      "discount_meta": {},      "moq": {        "increment_unit": 1,        "minimum": 1      },      "net_quantity": {},      "seo": {        "title": "Care N Made | Purple | New Design Bom Shape Tyre Air Valve Bom Caps, Funny Car Tyre Caps | Metal Air Valve Caps for Tyre | Cool Accessories…",        "description": ""      },      "categories": [        {          "name": "Car Hub Caps",          "uid": 7653,          "action": {            "type": "page",            "page": {              "type": "products",              "query": {                "category": [                  "car-hub-caps"                ]              }            }          },          "logo": {            "type": "image",            "url": "https://hdn-1.fynd.com/media/banner_portrait/brand/original/540_ecba3a1af141467da8abc20500f983db.jpg"          }        }      ],      "identifiers": [        "RVMJCHOFOK"      ],      "medias": [        {          "alt": "Care N Made | Purple | New Design Bom Shape Tyre Air Valve Bom Caps, Funny Car Tyre Caps | Metal Air Valve Caps for Tyre | Cool Accessories…",          "type": "image",          "url": "https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/images/othe/zfmxjh/.j/pg/dropbox.1711653.f59189c968ee77321608a70f2c1c80d9_1.jpg"        },        {          "alt": "Care N Made | Purple | New Design Bom Shape Tyre Air Valve Bom Caps, Funny Car Tyre Caps | Metal Air Valve Caps for Tyre | Cool Accessories…",          "type": "image",          "url": "https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/images/othe/zfmxjh/.j/pg/dropbox.1711653.4d39d32127df823697cdfc7b6fd52f2d_2.jpg"        }      ],      "sizes": [        "OS"      ],      "tags": [        "seller_3p",        "NON-RX"      ],      "variants": []    }  ]}

Fields

Field	Type	What it is	Example
`items[].brand.name`	string	Product, brand, department, collection or content name as returned for the selected endpoint.	little angel
`items[].categories[].name`	string		Diapers
`items[].name`	string	Product, brand, department, collection or content name as returned for the selected endpoint.	Little Angel Easy Dry Pull-up Diaper Pants with 12 hrs absorpti…
`items[].seo.title`	string	The title.	Little Angel Easy Dry Pull-up Diaper Pants with 12 hrs absorpti…
`items[].price`	object	Selling price shown from the returned effective price for the sampled catalogue row.	3 fields
`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[].attributes`	object	Product facts as JioMart lists them, by name.	23 fields
`items[].attributes.available-at-1p-kirana`	string	Whether JioMart's own partner shops have it.	false
`items[].attributes.available-at-3p-kirana`	string	Whether other partner shops have it.	false
`items[].attributes.available-at-3p-seller`	string	Whether other sellers have it.	true
`items[].attributes.available-at-rrl-fc`	string	Whether Reliance warehouses have it.	false
`items[].attributes.brand-id`	string	JioMart's ID for the brand.	943
`items[].attributes.catalog-source`	string	Where JioMart's catalogue entry came from.	INFIBEAM
`items[].attributes.category-l1`	string	Top-level category, such as Mom & Baby Care.	Mom & Baby Care
`items[].attributes.category-l2`	string	Second-level category, such as Diapers & Wipes.	Diapers & Wipes
`items[].attributes.dimensions-productheight`	string	Product height, as listed.	22.0
`items[].attributes.dimensions-productlength`	string	Product length, as listed.	39.0
`items[].attributes.dimensions-productweight`	string	Product weight, as listed.	3570.0
`items[].attributes.dimensions-productwidth`	string	Product width, as listed.	31.0
`items[].attributes.is-rrl-exclusive`	string	Whether the product is a Reliance exclusive.	false
`items[].attributes.is-sodexo-eligible`	string	Whether meal vouchers can pay for it.	false
`items[].attributes.l1-category`	string	Top-level category.	Mom & Baby Care
`items[].attributes.l2-category`	string	Second-level category.	Diapers & Wipes
`items[].attributes.l3-category`	string	Third-level category, such as Diapers.	Diapers
`items[].attributes.manufacturedetails-manufactureid`	string		977
`items[].attributes.primary_color_hex`	null		null
`items[].attributes.qty`	string	The pack count, as listed.	2
`items[].attributes.search-keywords`	string	Search words JioMart links to the product.	XL-size-baby-diaper,Extra-Large-Baby-diaper,Baby-diaper-pants,L…
`items[].attributes.seller-type`	string	The kind of seller, such as a third-party seller.	3p
`items[].attributes.vertical-code`	string	The business line, such as GROCERIES.	GROCERIES
`items[].brand`	object	Brand name shown in the sample table from JioMart’s returned brand data.	4 fields
`items[].brand.action`	object	Where the entry links to on JioMart.	2 fields
`items[].brand.logo`	object	The logo image.	2 fields
`items[].brand.type`	string	The kind of record or suggestion, where JioMart gives one.	brand
`items[].categories`	array	The product's categories.	1 records
`items[].categories[].action`	object		2 fields
`items[].categories[].logo`	object		2 fields
`items[].categories[].uid`	integer		10,225
`items[].channel`	string		685945f46c8c7aee3f3af605
`items[].country_of_origin`	string	Where the product comes from.	India
`items[].discount`	string	The discount, when there is one.	56% OFF
`items[].discount_meta`	object		0 fields
`items[].identifiers`	array	Codes that identify the product.	RVRCB4AQDH
`items[].is_tryout`	boolean	Whether the product is a trial pack.	false
`items[].item_code`	string	JioMart's product code.	RVRCB4AQDH
`items[].item_type`	string	The kind of product record, such as standard.	standard
`items[].medias`	array	The product's pictures.	3 records
`items[].medias[].alt`	string		Little Angel Easy Dry Pull-up Diaper Pants with 12 hrs absorpti…
`items[].medias[].type`	string		image
`items[].medias[].url`	string		https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/im…
`items[].moq`	object	Minimum order rules.	2 fields
`items[].moq.increment_unit`	integer	The step between quantities you can order.	1
`items[].moq.minimum`	integer	The fewest you can order.	1
`items[].net_quantity`	object		0 fields
`items[].price.*`	object		4 fields
`items[].sellable`	boolean	Whether a matching local store listing can sell it. A national catalogue entry alone does not make this a local stock signal.	true
`items[].seo`	object		2 fields
`items[].seo.description`	string

What to know

The home response holds products, page details and the sort JioMart applied. It is the feed JioMart shows for that location, not its full local catalogue.
Follow the next-page value with the same PIN, page size and sort. Low-to-high is not always strictly in order.

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 JioMart endpoints

Something missing or unclear? Ask the team that builds the JioMart endpoints.