JioMart API reference
Search JioMart products, compare prices, browse brands and collections, and analyze catalogue and availability data through one API.
Use the JioMart API to read catalogue, product, availability, category, content and sponsored-listing data. The endpoints cover product search and browsing, product detail, delivery checks at a PIN, comparing a product across PINs, search suggestions, filters, directories, the home feed, navigation and public pages.
Keep the national catalogue and local availability apart. Product search, filtered lists and collection products can show JioMart’s standard national catalogue. To check a product at a place, use Check local availability or Compare availability across PINs, and read serviceable, listed, journey and sellable as separate answers.
Send requests through POST /execute with your Upscrape API key. Where an endpoint takes a location, use a six-digit Indian PIN. Product detail and the availability checks take one product slug, numeric product ID or jiomart.com product link (the /p/ form); the category and public-content endpoints need no PIN.
Endpoints
Open an endpoint for its input, the fields it returns and the request in cURL, Python and Node.js.
| Endpoint | What it returns | Price |
|---|---|---|
jiomart.products.search |
Search the national catalogue by keyword and get each product's IDs, name, brand and prices, page by page, for catalogue research. | 1 credit |
jiomart.products.list |
Browse JioMart product lists with supported catalogue filters for assortment, pricing and category analysis. | 1 credit |
jiomart.collection.products.list |
Read products from a JioMart collection such as groceries, with product data and location, page by page. | 1 credit |
jiomart.product.detail.get |
Look up one product by ID, canonical slug or supported JioMart URL and read product, brand, price and optional size data. | 1 credit |
jiomart.fulfillment.get |
Check one product at a PIN and tell a local quick-commerce listing apart from the national catalogue entry. | 0.5 credits |
jiomart.product.availability.scan |
Compare one product across up to 20 Indian PINs with listing, price, sellability, serving-store and delivery signals per location. | 2 credits |
jiomart.autocomplete.search |
Read JioMart autocomplete suggestions for a query to study the terms and product language shoppers see in search. | 1 credit |
jiomart.ads.sponsored.products |
Read sponsored-product decisions for a keyword or inventory context for retail-media and placement analysis. | 1–3 credits |
jiomart.brands.list |
Browse JioMart's brand directory, page by page. | 0.5 credits |
jiomart.categories.list |
Read the JioMart category tree and the department each category belongs to. | 1 credit |
jiomart.category.filters.list |
Read JioMart's filter values and category tree for a catalogue filter, with an optional location. | 1.5 credits |
jiomart.collections.list |
Browse JioMart's collections and find the slug that lists each collection's products. | 1 credit |
jiomart.departments.list |
Read JioMart's main catalogue departments and their IDs. | 1 credit |
jiomart.home.listing |
Read the JioMart home product feed for a location, page by page. | 1 credit |
jiomart.location.pincode.lookup |
Look up JioMart's place details for a six-digit Indian PIN. | 0.5 credits |
jiomart.logistics.countries |
Read the countries in JioMart's delivery directory, with their codes. | 1 credit |
jiomart.navigations.list |
Read JioMart public navigation records, menus and links. | 1 credit |
jiomart.pages.list |
Browse the details of JioMart's public pages, page by page. | 1 credit |
What to know
- Catalogue search is not local stock Product search and browse can represent the national catalogue. A PIN on the request does not by itself show that a local store stocks or delivers the product.
- Serviceable, listed and sellable are different answers Serviceable means a local JioMart store serves the PIN. Listed, journey and sellable say whether this product was found there: a quick-commerce listing belongs to the serving stores, while a standard listing is national catalogue presence, not local delivery.
- Read price fields in their context Catalogue price ranges and size-level offers answer different questions. A zero placeholder is not a free product, and a missing local price stays unknown.
- Keep product, store and ad IDs apart Catalogue product IDs, store IDs, variant IDs and sponsored-ad item IDs are different kinds of ID. Sponsored responses describe ad decisions, so don't treat an ad item as a product or infer local stock from it.
Something missing or unclear? Ask the team that builds the JioMart endpoints.