Netmeds API · Endpoint

Netmeds Categories API

Q: Can my AI agent call it?

Yes, over MCP: the agent finds netmeds.categories.list, checks its price and runs it with the same credits as the REST API.

List the full Netmeds category tree: departments, then level 1, 2 and 3 categories, each with the slug the search filter expects.

1 credit per call
Failed calls are free
Updated 26 Oct 2026
netmeds.categories.list

Start free, 100 credits API reference

Response completed

{  "departments": [    {      "name": "Beauty",      "slug": "beauty",      "categories": [        {          "name": "Hair",          "ambiguous": true,          "department": "beauty",          "id": "694",          "slug": "hair",          "children": [            {              "name": "Hair Care",              "ambiguous": true,              "department": "beauty",              "id": "720",              "slug": "hair-care",              "children": [                {                  "name": "Shampoos",                  "ambiguous": true,                  "department": "beauty",                  "id": "824",                  "slug": "shampoos"                },                {                  "name": "Hair Oils",                  "ambiguous": true,                  "department": "beauty",                  "id": "820",                  "slug": "hair-oils"                }              ]            },            {              "name": "Hair Tools & Accessories",              "ambiguous": true,              "department": "beauty",              "id": "780",              "slug": "hair-tools-accessories",              "children": [                {                  "name": "Hair Brushes",                  "department": "beauty",                  "id": "1125",                  "slug": "hair-brushes"                },                {                  "name": "Hair Combs",                  "ambiguous": true,                  "department": "beauty",                  "id": "1120",                  "slug": "hair-combs"                }              ]            }          ]        },        {          "name": "Fragrances",          "ambiguous": true,          "department": "beauty",          "id": "697",          "slug": "fragrances",          "children": [            {              "name": "Men",              "ambiguous": true,              "department": "beauty",              "id": "724",              "slug": "men",              "children": [                {                  "name": "Men Deodorants/Roll-Ons",                  "ambiguous": true,                  "department": "beauty",                  "id": "828",                  "slug": "men-deodorants-roll-ons"                },                {                  "name": "Men Perfumes (Edt/Edp)",                  "ambiguous": true,                  "department": "beauty",                  "id": "846",                  "slug": "men-perfumes-edt-edp"                }              ]            },            {              "name": "Unisex",              "ambiguous": true,              "department": "beauty",              "id": "725",              "slug": "unisex",              "children": [                {                  "name": "Deodorants/Roll-Ons",                  "ambiguous": true,                  "department": "beauty",                  "id": "829",                  "slug": "deodorants-roll-ons"                },                {                  "name": "Perfumes (Edt/Edp)",                  "ambiguous": true,                  "department": "beauty",                  "id": "876",                  "slug": "perfumes-edt-edp"                }              ]            }          ]        }      ]    },    {      "name": "Medicine",      "slug": "medicine",      "categories": [        {          "name": "Cardiovascular & Hematopoietic System",          "department": "medicine",          "id": "6",          "slug": "cardiovascular-hematopoietic-system",          "children": [            {              "name": "Anticoagulants, Antiplatelets & Fibrinolytics (Thrombolytics)",              "department": "medicine",              "id": "46",              "slug": "anticoagulants-antiplatelets-fibrinolytics-thrombolytics",              "children": [                {                  "name": "Blood Clot-Ant",                  "department": "medicine",                  "id": "236",                  "slug": "blood-clot-ant"                },                {                  "name": "Bleeding Disorders-AAF",                  "department": "medicine",                  "id": "235",                  "slug": "bleeding-disorders-aaf"                }              ]            },            {              "name": "Diuretics",              "department": "medicine",              "id": "62",              "slug": "diuretics",              "children": [                {                  "name": "Hypertension-Diu",                  "department": "medicine",                  "id": "247",                  "slug": "hypertension-diu"                },                {                  "name": "Urinary Retention-Diu",                  "department": "medicine",                  "id": "248",                  "slug": "urinary-retention-diu"                }              ]            }          ]        },        {          "name": "Endocrine & Metabolic System",          "department": "medicine",          "id": "12",          "slug": "endocrine-metabolic-system",          "children": [            {              "name": "Antidiabetic Agents",              "department": "medicine",              "id": "108",              "slug": "antidiabetic-agents",              "children": [                {                  "name": "Diabetes-Ant",                  "department": "medicine",                  "id": "454",                  "slug": "diabetes-ant"                }              ]            },            {              "name": "Agents Affecting Bone Metabolism",              "department": "medicine",              "id": "107",              "slug": "agents-affecting-bone-metabolism",              "children": [                {                  "name": "Bone Metabolism-Age",                  "department": "medicine",                  "id": "450",                  "slug": "bone-metabolism-age"                },                {                  "name": "Osteoporosis-Age",                  "department": "medicine",                  "id": "451",                  "slug": "osteoporosis-age"                }              ]            }          ]        }      ]    }  ]}

2 rows

#	Name	Slug
1	Beauty	beauty
2	Medicine	medicine

Try it live, free

Response

Fields it returns

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

Field	Type	Example
departments[].categories[].name	string	Hair
departments[].name	string	Beauty
departments[].categories	array	2 records
departments[].categories[].ambiguous	boolean	true
departments[].categories[].children	array	2 records
departments[].categories[].department	string	beauty
departments[].categories[].id	string	694
departments[].categories[].slug	string	hair
departments[].slug	string	beauty
departments	array	2 records

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": "netmeds.categories.list",  "input": {}}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "netmeds.categories.list",  "input": {}}''')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": "netmeds.categories.list",  "input": {}}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));