Skip to main content
Upscrape 2.0 is here. Live platform data for agents, apps, and workflows. Upscrape 2.0 is here. REST API and MCP, one connection. Explore capabilities

JioMart API

Search JioMart products, compare prices, browse brands and collections, and analyze catalogue and availability data through one API.

Up to 100 free credits

What you can do with the JioMart API

From catalogue search and product detail to PIN-level availability and sponsored placements, these are the main JioMart workflows for commerce teams.

Search the JioMart catalogue with one request

Search for rice with PIN context and get catalogue products plus continuation. Use fulfillment or the availability scan when you need evidence about local quick-commerce availability.

Search JioMart for rice · cURL

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.products.search",
  "input": {
    "page": 1,
    "page_size": 20,
    "pincode": "400001",
    "query": "rice"
  }
}'

Search JioMart for rice · Python

import json
import os
import requests

payload = json.loads(r'''{
  "capability": "jiomart.products.search",
  "input": {
    "page": 1,
    "page_size": 20,
    "pincode": "400001",
    "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))

Search JioMart for rice · Node.js

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.products.search",
  "input": {
    "page": 1,
    "page_size": 20,
    "pincode": "400001",
    "query": "rice"
  }
}),
});

if (!response.ok) {
  throw new Error(`Upscrape request failed: ${response.status}`);
}

console.log(JSON.stringify(await response.json(), null, 2));

Explore JioMart response samples

Browse endpoint samples in a table, inspect the complete JSON, or download the attached JSON and CSV for your own analysis.

Collection products jiomart.collection.products.list

Request {"capability":"jiomart.collection.products.list","input":{"page_size":5,"pincode":"400001","slug":"groceries"}}

12 returned records.

Collection products
# Product , Product, brand, department, collection or content name as returned for the selected endpoint. Brand , Brand name shown in the sample table from JioMart’s returned brand data. Product ID , Catalogue product ID shown in the sample table from the returned product UID. Price (₹) , Selling price shown from the returned effective price for the sampled catalogue row. MRP (₹) , MRP shown from the returned marked price for the sampled catalogue row. Product slug , Product, brand or collection slug returned by JioMart for the sampled record.
1 Lemon 100 g reliance 72964579 ₹35 ₹35 lemon-100-g-mlc80c-72964579
2 Swamy's Idli Dosa Batter 1 kg Swamy's 72446064 ₹55 ₹110 swamy-s-idli-dosa-batter-1-kg-mknlyu-72446064
3 Onion (Approx. 900 g - 1000 g) reliance 7550741 ₹60 ₹60 onion-1-kg-pack-mffneb-7550741
4 Kheera Desi Pack (Approx. 490 g-500 g) reliance 7521921 ₹25 ₹25 kheera-desi-pack-approx-490-g-500-g-mffn0j-7521921
5 Tamarind 500 g Good Life 31045690 ₹119 ₹245 tamarind-500-g-milck5-31045690
6 Funfoods Veg Mayo Classic 875 g Funfoods 104032965 ₹125 ₹250 funfoods-veg-mayo-classic-875g-mpmoll-104032965
7 Modern Sandwich Supreme White Bread 400 g modern 7551751 ₹42 ₹45 modern-sandwich-supreme-white-bread-400-g-mffnet-7551751
8 Dalda Vanaspati 840 g Dalda 7517662 ₹169 ₹215 dalda-vanaspati-1-l-mffmym-7517662
9 Amulspray Infant Milk Food 500 g amul 7525913 ₹255 ₹255 amulspray-infant-milk-food-500-g-mffn2f-7525913
10 Nature's Choice Arabian Dates 500 g Nature's Choice 31044755 ₹119 ₹200 natures-choice-arabian-dates-500-g-milcjv-31044755
11 Nutraj Pumpkin Seeds 100 g NUTRAJ 7550935 ₹149 ₹149 nutraj-pumpkin-seeds-100-g-mffnee-7550935
12 Good Life White Till 500 g Good Life 31044916 ₹131 ₹240 good-life-white-till-500-g-milcjx-31044916

Product listings jiomart.products.list

Request {"capability":"jiomart.products.list","input":{}}

12 returned records.

Product listings
# Product , Product, brand, department, collection or content name as returned for the selected endpoint. Brand , Brand name shown in the sample table from JioMart’s returned brand data. Product ID , Catalogue product ID shown in the sample table from the returned product UID. Price (₹) , Selling price shown from the returned effective price for the sampled catalogue row. MRP (₹) , MRP shown from the returned marked price for the sampled catalogue row. Product slug , Product, brand or collection slug returned by JioMart for the sampled record.
1 Lemon 100 g reliance 72964579 ₹35 ₹35 lemon-100-g-mlc80c-72964579
2 Swamy's Idli Dosa Batter 1 kg Swamy's 72446064 ₹55 ₹110 swamy-s-idli-dosa-batter-1-kg-mknlyu-72446064
3 Onion (Approx. 900 g - 1000 g) reliance 7550741 ₹60 ₹60 onion-1-kg-pack-mffneb-7550741
4 Kheera Desi Pack (Approx. 490 g-500 g) reliance 7521921 ₹25 ₹25 kheera-desi-pack-approx-490-g-500-g-mffn0j-7521921
5 Tamarind 500 g Good Life 31045690 ₹119 ₹245 tamarind-500-g-milck5-31045690
6 Funfoods Veg Mayo Classic 875 g Funfoods 104032965 ₹125 ₹250 funfoods-veg-mayo-classic-875g-mpmoll-104032965
7 Modern Sandwich Supreme White Bread 400 g modern 7551751 ₹42 ₹45 modern-sandwich-supreme-white-bread-400-g-mffnet-7551751
8 Kaltron 8 Socket Extension Boards (White, 2.5 m) KALTRON 50930842 ₹129 ₹599 kaltron-8-socket-extension-boards-mj78rj-50930842
9 Dalda Vanaspati 840 g Dalda 7517662 ₹169 ₹215 dalda-vanaspati-1-l-mffmym-7517662
10 Amulspray Infant Milk Food 500 g amul 7525913 ₹255 ₹255 amulspray-infant-milk-food-500-g-mffn2f-7525913
11 Nature's Choice Arabian Dates 500 g Nature's Choice 31044755 ₹119 ₹200 natures-choice-arabian-dates-500-g-milcjv-31044755
12 Nutraj Pumpkin Seeds 100 g NUTRAJ 7550935 ₹149 ₹149 nutraj-pumpkin-seeds-100-g-mffnee-7550935

Brands jiomart.brands.list

Request {"capability":"jiomart.brands.list","input":{}}

20 returned records.

Brands
# Brand , Product, brand, department, collection or content name as returned for the selected endpoint. Slug , Product, brand or collection slug returned by JioMart for the sampled record. Brand ID , Brand or collection identifier returned by JioMart for directory records.
1 vega vega 173
2 BAJAJ bajaj 354
3 STELLAR HOME stellar-home 379
4 Philips philips 409
5 Prestige prestige 605
6 Rasna rasna 804
7 WIPRO wipro 874
8 Bombay Shaving Company bombay-shaving-company 884
9 Lyf lyf 1642
10 BPL bpl 2065
11 LG lg 2448
12 APPLE apple 2871
13 Maharaja maharaja 3251
14 HP hp 3478
15 Faber faber 3756
16 Reliance Jewels reliance-jewels 3957
17 Samsung samsung 4601
18 Lenovo lenovo 4611
19 Usha usha 4613
20 IFB ifb 4616

Collections jiomart.collections.list

Request {"capability":"jiomart.collections.list","input":{}}

20 returned records.

Collections
# Collection , Product, brand, department, collection or content name as returned for the selected endpoint. Slug , Product, brand or collection slug returned by JioMart for the sampled record. Collection ID , Brand or collection identifier returned by JioMart for directory records.
1 Sound Bar and TV Speakers sound-bar-and-tv-speakers 6ab61ad458f6e1e3916f8d90
2 PS5 and Controllers ps5-and-controllers 6ab61cf3cbb16c8e211f12b7
3 Trending Essentials trending-essentials 6ab3b78328b07f20881c6446
4 smartwatches smartwatches 6ab3b6befd32bce112a50eb3
5 shavers trimmers shavers-trimmers 6ab3b71138b8dab98ad573de
6 tablets ereaders tablets-ereaders 6ab3b74fe129b4beebaeada6
7 charger powerbanks charger-powerbanks 6ab3b7c275a58556e2654f0c
8 juicers mixer grinders juicers-mixer-grinders 6ab3b863ed1a95ce1493f928
9 Dhamakedar deals dhamakedar-deals 6ab0e831c548ab0d463a9c1a
10 Soft And Fresh soft-and-fresh 6aacc4bfc7bae495c63d942f
11 Iron Dry Steam Garment iron-dry-steam-garment 6aa92f349ce15df0b2448f46
12 Sandwich Maker sandwich-maker 6aab6926655c3207f78c3c09
13 mobiles mobiles 6ab3bc9231cfbf554fc72ddc
14 Electronics electronics 6ab3bc149c7fd083bf919b0b
15 bluetooth smart speakers bluetooth-smart-speakers 6ab3bbdd7358f119800f1563
16 TCL TV Range tcl-tv-range 6aa3f3de47d0ee3f570e5779
17 smart home devices and more smart-home-devices-and-more 6ab3ba9e475994895a9fed11
18 Voltas Beko Washing Machine voltas-beko-washing-machine 6aa3e9ff92bcc5f8b2c16eee
19 Fully Automatic Top Load Washing Machine fully-automatic-top-load-washing-machine 6aa3ebf6ce801fa58b611ed2
20 Foxsky Washing Machine foxsky-washing-machine 6aa3eacf303f3f311c988b4c

Suggestions jiomart.autocomplete.search

Request {"capability":"jiomart.autocomplete.search","input":{"query":"rice"}}

15 returned records.

Suggestions
# Suggestion , Autocomplete suggestion text returned by JioMart. Type , Upstream record or suggestion type where the endpoint exposes one.
1 rice product
2 rice 26 kg product
3 rice bran oil product
4 rice 5kg product
5 rice 10kg product
6 rice flour product
7 rice 1kg product
8 rice bran oil 1 litre product
9 rice flour 1kg product
10 rice bag product
11 rice loose product
12 rice rava product
13 rice bag 26kg product
14 rice basmati product
15 rice atta product

Image data


        

Rules that keep JioMart analysis accurate

JioMart exposes broad catalogue data and separate local-fulfillment signals. Keep those layers distinct when you compare products, prices or availability.

  • Catalogue search is not local stock

    Product search and browse can represent the national catalogue. A PIN on the request does not by itself prove that a local quick-commerce store stocks or delivers the product.

  • Serviceable and available answer different questions

    serviceable means a local JioMart store serves the PIN. Use listed, journey and sellable to understand whether the specific product was found in that local context.

  • Read the journey before reporting availability

    A quickcommerce listing is scoped to resolved serving stores. A standard listing is national-catalogue presence and should not be reported as local delivery confirmation.

  • Treat price fields in their source context

    Catalogue price ranges and size-level offers answer different questions. Raw zero placeholders are not proof of a free product, and a missing local price should stay unknown.

  • Keep product and ad identities separate

    Catalogue UIDs, store IDs, variant identifiers and sponsored-ad item IDs are different namespaces. Join them only when the response or a verified workflow establishes the mapping.

  • Keep continuation bound to the request

    For product search, lists and collections, reuse the returned continuation with the same query or filter, PIN, sort and page size. Numeric page selects a native JioMart page.

  • price_asc is JioMart’s order, not a guarantee

    The API passes price_asc through and preserves the returned order. Do not describe a page or multi-page result as globally low-to-high unless you sort the observations yourself.

  • Sponsored decisions are their own dataset

    Sponsored-product responses describe ad decisions for the requested inventory context. Do not treat an ad item ID as a product UID or infer local stock from the ad response.

Give your AI agent JioMart catalogue and availability tasks

Connect Upscrape through MCP so an agent can search the catalogue, resolve product identity, compare selected PINs, map taxonomy and inspect sponsored placements with the right data scope.

Prompt

Show products in JioMart’s groceries collection for PIN 400001, including brand, product ID, selling price, MRP and product slug.

Prompt

Show a snapshot of JioMart product listings and summarize the brands and price ranges in the returned products.

Prompt

List the JioMart brands returned by the brand directory with their names, slugs and brand IDs.

Prompt

Show the JioMart collections returned by the collection directory with their names, slugs and collection IDs.

Prompt

Show JioMart autocomplete suggestions for rice and group the suggestions by their returned type.

Setup guides

Use the SKILL.md file to teach an agent when to use national catalogue endpoints, when to switch to fulfillment, and how to interpret product, price, PIN, paging and sponsored-placement fields.

What teams can do with JioMart data

Workflows for commerce analytics, pricing, assortment, retail media and catalogue teams that need a clear line between catalogue data and local availability.

Monitor national catalogue assortment

Track which products, brands and price ranges appear for important searches, departments or collection slices.

Compare product and size offers

Inspect product detail and returned size data to compare selling-price and MRP fields without treating placeholder ranges as final offers.

Compare availability across selected PINs

Scan one product across up to 20 PINs and compare serviceability, listing context, price, sellability, serving stores and ETA signals.

Separate local listing from national presence

Use fulfillment checks to distinguish quick-commerce store listings from standard national-catalogue fallback for tracked products.

Map JioMart taxonomy

Build department, category, brand and collection maps for catalogue normalization and browse analysis.

Track collection and home-feed changes

Save repeated collection or home-listing observations to see how returned product sets and prices change over time.

Study autocomplete language

Collect query suggestions for selected terms and locations as a separate search-input signal, then use product search for the resulting catalogue queries.

Inspect sponsored placements

Review sponsored-product decisions by keyword or inventory context while keeping ad identifiers separate from catalogue product identity.

JioMart API questions

Practical answers on catalogue scope, PIN checks, prices, pagination, product identity, Python, MCP and request pricing.

What data can I get from the JioMart API?

You can search and browse the JioMart catalogue, read product detail, check fulfillment for a product at a PIN, compare one product across multiple PINs, inspect autocomplete and sponsored-product decisions, and read categories, departments, brands, collections, navigation, public pages and logistics metadata. JioMart API reference

Does JioMart product search show local stock for my PIN?

No. Product search is a national-catalogue workflow. A PIN can be part of the request context, but the result is not proof that a local quick-commerce store stocks or delivers the product. Use fulfillment or the multi-PIN availability scan for that question. JioMart API reference

How do I check whether one product is available at a PIN?

Use jiomart.fulfillment.get with one product identifier and the PIN you want to check. Read serviceable, listed, journey and sellable together instead of reducing the response to one availability flag. JioMart API reference

What does serviceable mean?

serviceable means that at least one JioMart local store serves the requested PIN. It does not by itself mean the requested product is listed or sellable there. JioMart API reference

Can I compare the same product across several PINs?

Yes. jiomart.product.availability.scan accepts one numeric product ID and 1 to 20 Indian PIN locations. Each row keeps serviceability, listing context, nullable price, sellability, serving stores and delivery fields for that PIN. JioMart API reference

How should I interpret JioMart prices?

Keep the price in the context that produced it. Catalogue price ranges, size-level offers and PIN-level availability prices are different observations. Missing values should stay unknown, and a zero placeholder range should not be reported as a free product. JioMart API reference

Does price_asc guarantee globally ascending prices?

No. The option is passed through to JioMart and the API preserves JioMart’s returned order. It is not guaranteed to be strictly ascending within or across pages. JioMart API reference

How does JioMart pagination work?

Product search, filtered lists and collection products use native pages plus returned continuation. Reuse pagination.next_cursor or page.next_id with the same query or filter, PIN, sort and page size. Other directory endpoints use their own numbered-page contract, and the home listing uses its own cursor. JioMart API reference

Can I look up a product from a JioMart URL?

Yes, for the supported canonical JioMart /p/ product URL form. Product detail and fulfillment also accept a canonical slug or numeric product ID; provide exactly one identifier. JioMart API reference

Can I get JioMart categories, brands and collections?

Yes. Separate capabilities expose categories, departments, brand records, collections, catalogue filters and public navigation so you can build your own taxonomy and browse workflows. JioMart API reference

Can I get sponsored-product data?

Yes. jiomart.ads.sponsored.products returns sponsored-product decisions for the requested inventory context. Keep ad identifiers separate from catalogue product IDs unless a verified mapping is available. JioMart API reference

Can I call the JioMart API from Python?

Yes. Send the capability and input JSON to POST /execute with your Upscrape API key. The same request contract works from Python, cURL, Node.js or another HTTP client. JioMart API reference

Can an AI agent use JioMart data?

Yes. Connect Upscrape through MCP and give the agent a JioMart task. The downloadable skill on this page teaches the agent when to use catalogue search, fulfillment, multi-PIN scans, taxonomy or sponsored-product capabilities. JioMart API reference

How do free credits and request pricing work?

Eligible verified accounts receive up to 100 free credits once. The current endpoint card shows the credit price for each capability. JioMart API reference

Can I place JioMart orders through these endpoints?

No. The capabilities on this page are for reading catalogue, availability, taxonomy, public content and sponsored-placement data. They do not create carts, place orders or process payments. JioMart API reference

Try the JioMart API

Search the catalogue or compare one product across the PINs you care about. Eligible verified accounts receive up to 100 free credits once.