MedPlus Mart API · Endpoint

MedPlus Mart Category Products API

Q: What do I send?

Send category_id. The input fields below list every option with its type and limits.

Q: Can my AI agent call it?

Yes, over MCP: the agent finds medplus.category.products, checks its price and runs it with the same credits as the REST API.

Read a MedPlus Mart category with brand, printed-MRP and stock filters, its sort orders and one page of up to 20 per call.

1 credit per call
Failed calls are free
Updated 26 Oct 2026
medplus.category.products

Start free, 100 credits API reference

Response completed

{  "category_name": "Accessories",  "has_more": false,  "total_count": 2,  "filters": {    "exclude_out_of_stock": false,    "brands": [      "DOQTAR"    ]  },  "items": [    {      "name": "DOQTAR MEMORY FOAM TRAVEL PILLOW",      "price": 352,      "mrp": 999,      "availability": "available",      "composition": "Surgicals",      "currency": "INR",      "discount_percent": 64.76,      "image_url": "https://static2.medplusmart.com/products/_6d1c941_/DOQT0100_S.jpg",      "manufacturer": "MEDPLUS HEALTH SERVICES LIMITED",      "product_id": "DOQT0100"    },    {      "name": "DOQTAR  YOGA MAT 6MM EVA",      "price": 526.9,      "mrp": 999,      "availability": "available",      "currency": "INR",      "discount_percent": 47.26,      "image_url": "https://static2.medplusmart.com/products/_ec807b9_/DOQT0101_S.jpg",      "manufacturer": "MEDPLUS HEALTH SERVICES LIMITED",      "product_id": "DOQT0101",      "url": "https://www.medplusmart.com/product/doqtar-yoga-mat-6mm-eva_doqt0101"    }  ]}

2 rows

#	Name	Price	Mrp	Availability	Composition	Currency	Discount percent	Manufacturer	Image url	Product id
1	DOQTAR MEMORY FOAM TRAVEL PILLOW	352	999	available	Surgicals	INR	64.76	MEDPLUS HEALTH SERVICES LIMITED	https://static2.medplusmart.com/products/_6d1c941_/DOQT0100_S.j…	DOQT0100
2	DOQTAR YOGA MAT 6MM EVA	526.9	999	available		INR	47.26	MEDPLUS HEALTH SERVICES LIMITED	https://static2.medplusmart.com/products/_ec807b9_/DOQT0101_S.j…	DOQT0101

Try it live, free

Input

What you send

The input object of the request, with every field the endpoint accepts.

Field	Type	Required	What it does	Example
category_id	string	yes	Numeric MedPlus category id (20093), a MART_ prefixed id, or a public medplusmart.com category link.	20093
brands	array<string>	no	Brand names to keep, exactly as the listing publishes them (its BRAND_DATA keys).	["DOQTAR"]
exclude_out_of_stock	boolean	no	Drop records the storefront marks out of stock. Default: `false`.
limit	integer	no	Records in this call's one page, at most 20. A call reads one page; ask for the next one with page. From 1 to 20. Default: `20`.	2
mrp_max	number	no	Highest printed MRP in rupees. From 0 to 10000000.
mrp_min	number	no	Lowest printed MRP in rupees. The route filters on MRP, not on the selling price. From 0 to 10000000.
page	integer	no	Page of the listing, counted in records of size limit. From 1 to 10. Default: `1`.	1
parent_category_id	string	no	Parent category id. Optional; the listing route answers without it.	10110
sort	string	no	Sort order, mapped onto the storefront's own sort indexes. Allowed values: `relevance`, `discount`, `name_asc`, `name_desc`, `price_low`, `price_high`. Default: `relevance`.	price_low

Response

Fields it returns

What each record in the response holds, with the values from the sample above.

Field	Type	Example
items[].name	string	DOQTAR MEMORY FOAM TRAVEL PILLOW
items[].price	integer	352
items[].mrp	integer	999
items[].availability	string	available
items[].composition	string	Surgicals
items[].currency	string	INR
items[].discount_percent	number	64.76
items[].image_url	string	https://static2.medplusmart.com/products/_6d1c941_/DOQT0100_S.j…
items[].manufacturer	string	MEDPLUS HEALTH SERVICES LIMITED
items[].product_id	string	DOQT0100
category_name	string	Accessories
filters	object	2 fields
filters.brands	array	DOQTAR
filters.exclude_out_of_stock	boolean	false
has_more	boolean	false
items	array	2 records
total_count	integer	2

REST API · MCP server

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": "medplus.category.products",  "input": {    "brands": [      "DOQTAR"    ],    "category_id": "20093",    "limit": 2,    "page": 1,    "parent_category_id": "10110",    "sort": "price_low"  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "medplus.category.products",  "input": {    "brands": [      "DOQTAR"    ],    "category_id": "20093",    "limit": 2,    "page": 1,    "parent_category_id": "10110",    "sort": "price_low"  }}''')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": "medplus.category.products",  "input": {    "brands": [      "DOQTAR"    ],    "category_id": "20093",    "limit": 2,    "page": 1,    "parent_category_id": "10110",    "sort": "price_low"  }}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));

In your AI agent Claude · Cursor · any MCP client

1Add the Upscrape MCP server

https://data.upscrape.com/mcp

2Ask for the data in plain words

With Upscrape, get the MedPlus Mart category products for category id "20093", parent category id "10110" and sort "price_low". Tell me what it costs before you run it, then show the results as a table.

The agent finds the endpoint, shows you the price, and runs it with your credits.

MedPlus Mart