Netmeds API reference

Netmeds Substitutes

netmeds.product.substitutes

List Netmeds products in the same generic-plus-dosage group, with prices, so cheaper same-salt alternatives are visible.

Netmeds Substitutes API: overview and live sample

At a glance

Endpoint ID: netmeds.product.substitutes
Price: 1 credit per call; failed calls are free
Runs for up to: 60 seconds
Request: POST /execute; Run an endpoint
MCP tool when pinned: netmeds__product__substitutes; Pin tools
OpenAPI: openapi.json; Download

Request

Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.

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.product.substitutes",  "input": {    "page_size": 3,    "product": "dolo-650-tablet-15s-lui1wb-8231049"  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "netmeds.product.substitutes",  "input": {    "page_size": 3,    "product": "dolo-650-tablet-15s-lui1wb-8231049"  }}''')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.product.substitutes",  "input": {    "page_size": 3,    "product": "dolo-650-tablet-15s-lui1wb-8231049"  }}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));

Input

Field	Type	Required	What it does	Example
`generic_dosage_id`	string	one of	The catalogue's generic-plus-dosage id, from a record's generic_dosage_id. Skips the product lookup.
`product`	string	one of	Product address, path or slug. Its substitution group is looked up automatically.	dolo-650-tablet-15s-lui1wb-8231049
`limit`	integer	no	Alias for page_size (1 to 20). From 1 to 20.
`page`	integer	no	1-based page to read. One call reads only this page; pass next_page from the answer to continue. At least 1. Default: `1`.
`page_size`	integer	no	Records in this one page, 1 to 20 (default 20). From 1 to 20. Default: `20`.	3
`sort`	string	no	Sort order for returned results. Allowed values: `popular`, `price_asc`, `price_dsc`, `discount_asc`, `discount_dsc`, `relevance`. Default: `popular`.	popular · price_asc · price_dsc · discount_asc …

Response

A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.

This is results[0].data from a real run:

results[0].data

{  "name": "Dolo 650 Tablet 15's",  "composition": "PARACETAMOL(ACETAMINOPHEN) 650MG",  "generic_dosage_id": "31553",  "has_more": true,  "next_page": 2,  "page": 1,  "product_id": "8231049",  "sort": "popular",  "total_count": 47,  "items": [    {      "name": "P 650 Tablet 10'S",      "price": 19.16,      "mrp": 21.53,      "availability_status": "A",      "brand": "P 650",      "composition": "Paracetamol 650 mg",      "country_of_origin": "India",      "currency": "INR",      "description": "categoryNameLevel3-Fever-Ana; genericName-Paracetamol; brandFilter-; marketerName-Apex Laboratories Pvt Ltd; categoryNameLevel2-Analgesics …",      "discount_label": "11% OFF",      "discount_percent": 11,      "generic_dosage_id": "31553",      "generic_name": "Paracetamol",      "hsn_code": "30049069",      "id": "8358924",      "image_url": "https://gdn.pixelbin.io/v2/plain-cake-860195/netmed/wrkr/products/assets/item/free/original/Oi7xhiLt6Q-p_650_tablet_10s_0_2.jpg",      "in_stock": true,      "item_code": "45278",      "item_type": "standard",      "manufacturer": "Accent Pharma",      "marketer": "Apex Laboratories Pvt Ltd",      "net_quantity": "1",      "pack_size": "10 Tablet(s) in a Strip",      "rx_required": false,      "schedule": "NP",      "slug": "p-650-tablet-10s-lui7t8-8358924",      "stock_quantity": 258,      "url": "https://www.netmeds.com/product/p-650-tablet-10s-lui7t8-8358924",      "categories": [        "Fever-Ana"      ],      "images": [        "https://gdn.pixelbin.io/v2/plain-cake-860195/netmed/wrkr/products/assets/item/free/original/Oi7xhiLt6Q-p_650_tablet_10s_0_2.jpg",        "https://gdn.pixelbin.io/v2/plain-cake-860195/netmed/wrkr/products/assets/item/free/original/yksLfezQM6-p_650_tablet_10s_1_1.jpg"      ],      "sizes": [        "10"      ]    },    {      "name": "CALPOL 650 + Tablet 15's",      "price": 25.79,      "mrp": 32.24,      "availability_status": "A",      "brand": "Calpol 650 +",      "composition": "Paracetamol 650 mg",      "country_of_origin": "India",      "currency": "INR",      "description": "categoryNameLevel3-Fever-Ana; genericName-Paracetamol; brandFilter-; marketerName-Glaxosmithkline Pharmaceuticals Ltd; categoryNameLevel2-A…",      "discount_label": "20% OFF",      "discount_percent": 20,      "generic_dosage_id": "31553",      "generic_name": "Paracetamol",      "hsn_code": "30049069",      "id": "8277408",      "in_stock": true,      "item_code": "1105570",      "item_type": "standard",      "manufacturer": "Glaxosmithkline Pharmaceuticals Ltd",      "marketer": "Glaxosmithkline Pharmaceuticals Ltd",      "net_quantity": "1",      "pack_size": "15 Tablet(s) in a Strip",      "rx_required": false,      "schedule": "NP",      "slug": "calpol-650-tablet-15s-lui43a-8277408",      "stock_quantity": 869,      "url": "https://www.netmeds.com/product/calpol-650-tablet-15s-lui43a-8277408",      "categories": [        "Fever-Ana"      ],      "images": [],      "sizes": [        "15"      ]    }  ]}

Fields

Field	Type	Example
`items[].name`	string	P 650 Tablet 10'S
`items[].price`	number	19.16
`items[].mrp`	number	21.53
`items[].availability_status`	string	A
`items[].brand`	string	P 650
`items[].categories`	array	Fever-Ana
`items[].composition`	string	Paracetamol 650 mg
`items[].country_of_origin`	string	India
`items[].currency`	string	INR
`items[].description`	string	categoryNameLevel3-Fever-Ana; genericName-Paracetamol; brandFil…
`items[].discount_label`	string	11% OFF
`items[].discount_percent`	integer	11
`items[].generic_dosage_id`	string	31553
`items[].generic_name`	string	Paracetamol
`items[].hsn_code`	string	30049069
`items[].id`	string	8358924
`items[].image_url`	string	https://gdn.pixelbin.io/v2/plain-cake-860195/netmed/wrkr/produc…
`items[].images`	array	https://gdn.pixelbin.io/v2/plain-cake-860195/netmed/wrkr/produc…
`items[].in_stock`	boolean	true
`items[].item_code`	string	45278
`items[].item_type`	string	standard
`items[].manufacturer`	string	Accent Pharma
`items[].marketer`	string	Apex Laboratories Pvt Ltd
`items[].net_quantity`	string	1
`items[].pack_size`	string	10 Tablet(s) in a Strip
`items[].rx_required`	boolean	false
`items[].schedule`	string	NP
`items[].sizes`	array	10
`items[].slug`	string	p-650-tablet-10s-lui7t8-8358924
`items[].stock_quantity`	integer	258
`items[].url`	string	https://www.netmeds.com/product/p-650-tablet-10s-lui7t8-8358924
`name`	string	Dolo 650 Tablet 15's
`composition`	string	PARACETAMOL(ACETAMINOPHEN) 650MG
`generic_dosage_id`	string	31553
`has_more`	boolean	true
`items`	array	2 records
`next_page`	integer	2
`page`	integer	1
`product_id`	string	8231049
`sort`	string	popular
`total_count`	integer	47

If a call fails

A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.

Other Netmeds endpoints

Something missing or unclear? Ask the team that builds the Netmeds endpoints.