Skip to content
Menu

REWALTO / DEVELOPERS / API / JIOMART

JioMart product data API

GET /v1/data/listings with retailer=jiomart returns each JioMart product Rewalto holds: title, brand, pack size, images, product link and its latest price, MRP and stock reading. For JioMart, Rewalto holds price readings: 820 pins held · 2,89,937 readings on 4 Nov 2026 (measured 4 Nov 2026), and 3,108 open dark stores in 612 cities (counted 5 Nov 2026). It needs an API key and costs 1 credit per 10 listings; the sample record below is free.

Last updated 5 Nov 2026.

Key facts

EndpointGET /v1/data/listings
App filterretailer=jiomart
Cost1 credit per 10 listingsOnly delivered records use credits
KeyAPI key needed

A real JioMart record

One record from the free samples route (GET /v1/data/samples?dataset=listings), exactly as the paid read returns it, with long lists cut to three items. Samples are at least a week old; this set holds records up to 29 Oct 2026.

{
  "id": "f115555f-e096-47df-a3c5-351332288d6d",
  "retailer": "jiomart",
  "retailerSku": "76057329",
  "title": "Optimum Nutrition Gold Standard Whey Vanilla Ice Cream Protein Powder 454 g",
  "brand": "Optimum Nutrition",
  "packSizeRaw": "454g",
  "imageUrl": "https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/images/othe/egurhk/.j/pg/0000000004923349061.jpg.d5f64bc70e.jpg",
  "images": [
    {
      "url": "https://cdn1.jiomartjcp.com/v2/catalog-cloud/jiomar/original/images/othe/egurhk/.j/pg/0000000004923349061.jpg.d5f64bc70e.jpg",
      "position": 0,
      "source": "jiomart",
      "firstSeen": "2026-10-15T17:47:04.000000Z",
      "lastSeen": "2026-10-29T18:29:58.000000Z"
    }
  ],
  "url": "optimum-nutrition-gold-standard-whey-vanilla-ice-cream-protein-powder-454-g-mnekz3-76057329",
  "productId": null,
  "firstSeen": "2026-10-15T17:47:04.000000Z",
  "lastSeen": "2026-10-29T18:29:58.000000Z",
  "observations": 4,
  "latest": {
    "state": "priced",
    "priceMinor": 234500,
    "mrpMinor": 275900,
    "currency": "INR",
    "inStock": true,
    "pincode": "400013",
    "observedAt": "2026-10-29T18:29:58.000000Z"
  }
}

Call the JioMart endpoint

Set REWALTO_API_KEY to a key from your account, then run any of these.

cURL
curl -H "Authorization: Bearer $REWALTO_API_KEY" \
  "https://api.rewalto.com/v1/data/listings?retailer=jiomart&limit=20"
Python
import os
import requests

r = requests.get(
    "https://api.rewalto.com/v1/data/listings",
    params={"retailer": "jiomart", "limit": 20},
    headers={"Authorization": f"Bearer {os.environ['REWALTO_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
for record in r.json()["data"]:
    print(record["title"], record["brand"])
Node
const res = await fetch("https://api.rewalto.com/v1/data/listings?retailer=jiomart&limit=20", {
  headers: { Authorization: `Bearer ${process.env.REWALTO_API_KEY}` },
});
if (!res.ok) throw new Error(`Rewalto API ${res.status}`);
const { data } = await res.json();
for (const record of data) console.log(record.title, record.brand);

Search JioMart products by brand

Add brand to read one brand, or retailerSku for one product. Each listing carries its latest reading, with the pin code it was read at.

Fields in each record

From API contract 0.157.0.

FieldTypeWhat it meansExample
idstringStable identifier of the listing."7c1e5f0a-2f55-4d2b-8c36-0f3f1d9c2b77"
retailerstringThe retailer key."nykaa"
retailerSkustringThe retailer own product identifier."1234567"
titlenull or stringThe product title as the retailer showed it."Maybelline Superstay Matte Ink"
brandnull or stringThe brand as the retailer attributed it."Maybelline"
packSizeRawnull or stringThe pack size exactly as printed."5 ml"
imageUrlnull or stringThe primary product image address (not the image itself): the first of images."https://images.example/lipstick-1.jpg"
imagesarray of objectEvery image address the source showed, in its order, primary first. Empty when it showed none.
urlnull or stringThe retailer product page."https://www.nykaa.com/p/1234567"
productIdnull or stringThe matched Rewalto product, when matched."0d6b4a52-4b6e-4c1a-9a7e-5b0d2f8f1a11"
firstSeenstring (date-time)When the listing was first observed."2026-08-27T08:00:00Z"
lastSeenstring (date-time)When the listing was last observed."2026-10-14T09:00:00Z"
observationsintegerHow many times the listing has been observed.37
brandTagnull or objectRewalto's model reading of the brand from the title (plan 13 T8), given only when the retailer attributed no brand. It never replaces brand. Null when the title is not tagged yet.
categoryTagnull or objectRewalto's model reading of the GS1 GPC segment and family from the title (D-1498). Null when the title is not tagged yet.
similaritynumberListing search with mode=semantic only: the cosine similarity of the listing and the query embeddings (OpenAI text-embedding-3-small, 512 dimensions), -1 to 1, higher is closer in meaning, to 6 decimal places. Absent everywhere else.0.71234
matchobjectHow this listing matched the search, only on search results. kind: exact_id (the query is the retailer product id), phrase (the name holds the words in order, next to each other), words (every word, spread out), brand (only the brand the query names), near (an approximate match, a likely misspelling). wholeWords of queryWords are whole words of the listing ("butter" in "Amul Butter", not in "Buttermilk"); allWords is true when every word is. When any listing holds every word as a whole word, the search returns only such listings.
latestobjectThe listing's newest kept reading in the last 30 days, at the pin code asked for, else at any pin. Never a guess.

Full reference

Every parameter and error code for this endpoint is in the reference.

JioMart search rank data

Rewalto records where each JioMart product ranks in the app's search, by search term, pin code and day. Read it with the search rank endpoint and retailer=jiomart; the terms, pin codes and dates covered are on the search rank data page.

Not JioMart's own API

Rewalto is not affiliated with, endorsed by or partnered with JioMart. It reads JioMart's public pages, the way a shopper sees them.

Questions people ask

Is this the official JioMart API?
No. Rewalto is not affiliated with, endorsed by or partnered with JioMart. It reads JioMart's public pages, the way a shopper sees them.
What does a read cost?
1 credit per 10 listings. Every account gets 1,000 free credits a month, and a read that delivers nothing costs nothing.
Do I need an API key?
Yes, for this endpoint. The sample on this page comes from GET /v1/data/samples, which is free and needs no key.
Does the JioMart product data include stock?
Yes. Each listing carries its latest reading, with the price, MRP and the in-stock flag JioMart showed at that pin code.
Can an AI agent read it?
AI agents can read the same records through Rewalto's MCP server, which is in preview.