MedPlus Mart API · Endpoint
MedPlus Mart Categories API
List the MedPlus Mart category tree with parent ids and depth, so a caller can pick a category and walk its products.
- 1 credit per call
- Failed calls are free
- Updated
- medplus.categories.list
{ "total_count": 6, "categories": [ { "name": "Factory Direct", "category_id": "10110", "depth": 0, "image_url": "https://static2.medplusmart.com/live/bannerImage/Mart/ba83af20ac88355613892ade603455d0.jpg" }, { "name": "Accessories", "category_id": "20093", "depth": 1, "parent_id": "10110" } ]}
| # | Name | Depth | Category id | Image url | Parent id |
|---|---|---|---|---|---|
| 1 | Factory Direct | 0 | 10110 | https://static2.medplusmart.com/live/bannerImage/Mart/ba83af20a… | |
| 2 | Accessories | 1 | 20093 | 10110 | |
| 3 | Baby Care | 1 | 20094 | 10110 |
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| max_depth | integer | no | How many levels of the tree to return, counting the top level as 1. From 1 to 3. Default: 3. |
2 |
| parent_id | string | no | Return only this category's subtree: a numeric id, a MART_ prefixed id or a public medplusmart.com category link. |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | Example |
|---|---|---|
| categories[].name | string | Factory Direct |
| categories[].category_id | string | 10110 |
| categories[].depth | integer | 0 |
| categories[].image_url | string | https://static2.medplusmart.com/live/bannerImage/Mart/ba83af20a… |
| categories | array | 3 records |
| total_count | integer | 6 |
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.categories.list", "input": { "max_depth": 2 }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "medplus.categories.list", "input": { "max_depth": 2 }}''')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.categories.list", "input": { "max_depth": 2 }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
https://data.upscrape.com/mcp
With Upscrape, get the MedPlus Mart categories for max depth "2". Tell me what it costs before you run it, then show the results as a table.
More from the MedPlus Mart API
The same data from other platforms
Aldi UKCategories
Apollo PharmacyCategories
AsdaCategories
BlinkitCategories
Flipkart CommerceSearch categories
Flipkart MinutesDiscover categoriesMedPlus Mart Categories API FAQ
The short answers. The docs have the long ones.
How much does the MedPlus Mart Categories API cost?
1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.
What do I send?
Every input is optional; the input fields below list what each one does.
Do I need a MedPlus Mart login?
No. It reads public MedPlus Mart data; nothing runs on your account.
Can my AI agent call it?
Yes, over MCP: the agent finds medplus.categories.list, checks its price and runs it with the same credits as the REST API.
Your first MedPlus Mart call is free.
Up to 100 free credits to start, no card needed.