↑ ↓ to move ↵ to open
NPPA API reference

NPPA Brand Substitutes

nppa.brand.substitutes

List other brands of the same composition, each with its MRP and how its per-unit price compares with this pack.

At a glance

Endpoint ID
nppa.brand.substitutes
Price
1 credit per call; failed calls are free
Runs for up to
45 seconds
Request
POST /execute
Run an endpoint
MCP tool when pinned
nppa__brand__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": "nppa.brand.substitutes",  "input": {    "limit": 5,    "sku_id": "1521018101@84705@101124596@3755@101006@202166"  }}'

Input

FieldTypeRequiredWhat it doesExample
brand string one of Brand name, used when no sku_id is known.
sku_id string one of The sku_id from nppa.search.brands or nppa.formulation.brands. 1521018101@84705@101124596@3755@101006@202166
limit integer no Rows per page. From 1 to 100. Default: 20. 5
page integer no Page of matching rows to return, starting at 1. At least 1. Default: 1.
sku string no Exact sku name from a search. Required when the brand has more than one pack.

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
{  "brand": "DOLO",  "has_more": true,  "page": 1,  "sku": "DOLO 500 MG TABLET 15",  "total": 102,  "substitutes": [    {      "mrp": 188,      "brand": "PARACETAMOL (CADILA)",      "company": "CADILA PHARMACEUTICALS LTD",      "mrp_per_unit": 0.19,      "pack_size": "1000",      "price_month": "Aug-2026",      "relation": "80% cheaper"    },    {      "mrp": 209.91,      "brand": "MYPAR",      "company": "MOREPEN LABORATORIES LIMITED",      "mrp_per_unit": 0.21,      "pack_size": "1000",      "price_month": "Aug-2026",      "relation": "78% cheaper"    }  ]}

Fields

FieldTypeExample
brand string DOLO
has_more boolean true
page integer 1
sku string DOLO 500 MG TABLET 15
substitutes array 3 records
substitutes[].brand string PARACETAMOL (CADILA)
substitutes[].company string CADILA PHARMACEUTICALS LTD
substitutes[].mrp integer 188
substitutes[].mrp_per_unit number 0.19
substitutes[].pack_size string 1000
substitutes[].price_month string Aug-2026
substitutes[].relation string 80% cheaper
total integer 102

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 NPPA endpoints

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