Therapeutic Alternatives Implementation Guide
What are therapeutic alternatives?
When we think of using a drug, the first thing that likely pops to mind is to cure or treat an underlying health condition. Drugs that are used in treatments are categorized as therapeutic drugs. A drug's intended therapeutic purpose to treat a particular condition may work for one person, but this does not mean it will for everyone. Having the ability to find alternatives to a drug would help in circumstances where a particular drug isn't suitable, and this is where DrugBank's therapeutic alternative endpoints come in.
How does the Therapeutic Alternatives search work?
ATTENTION: To access DrugBank's therapeutic alternatives endpoints, you will have to first understand how to obtain a Product Concept ID via the medication search.
Grabbing the Product Concept ID will be the starting point to obtaining therapeutic alternatives.
Let's take a look at a scenario where an alternative therapeutic drug may be needed:
Robert goes to visit his family doctor and complains of some pain that he's started to experience due to a prior surgery. After reviewing his case, his doctor wants to recommend treatment with Acetaminophen 500mg oral tablet to help ease the pain, but they see in Robert's medical history that he has had a prior adverse drug reaction when taking acetaminophen. Using DrugBank's therapeutic alternatives search, Robert's doctor is able to effectively search up alternative drugs under the same therapeutic category as acetaminophen.
Using the story above, first get the Product Concept ID of Acetaminophen 500mg oral tablet using the Medication Search, this would be DBPC0012414:
https://api.drugbank.com/v1/product_concepts/DBPC0012414Copy to clipboard
After grabbing the Product Concept ID, add “/therapeutic_alternatives” to the end of the call:
https://api.drugbank.com/v1/product_concepts/DBPC0012414/therapeutic_alternativesCopy to clipboard
NOTE: When you are searching the therapeutic alternatives of a product concept in question, the API is looking for alternatives at a product concept's ingredient level. In our example, the drug we are looking for therapeutic alternatives for is simply acetaminophen. Therapeutic alternatives are always shown as drug alternatives that belong to the same therapeutic category.
You can see from the return, acetaminophen falls under the therapeutic category that has been categorized as therapeutic (line 17). The therapeutic category is termed Analgesics (line 8) and there are 5 possible drug alternatives for acetaminophen: Floctafenine (line 32), Methoxyflurane (line 36), Capsaicin (line 40), Zucapsaicin (line 44), and Methyl salicylate (line 48).
TIP: We can see that the therapeutic category: Analgesics is connected to the drugbank_id: DBCAT000041 in line 7. External IDs such as ATC and MeSH IDs are also mapped whenever possible. In the Analgesics category, this is mapped to mesh_id: D000700 (line 9) and atc_code: N02 (line 14). This is beneficial for customers who already have an existing system with these external IDs, which will allow for easier integration.
NOTE: In this case we used a Product Concept ID, but you can also find therapeutic alternatives for a drug or a drug product:
From drug ingredients:
https://api.drugbank.com/v1/drugs/DB00316/therapeutic_alternativesCopy to clipboard
From local product codes:
https://api.drugbank.com/v1/products/73057-0376/therapeutic_alternativesCopy to clipboard
Important fields for Therapeutic Alternatives
The therapeutic alternatives endpoints connect to internal and external IDs. For clinicians, it's often helpful to have the alternative DrugBank identifiers to see what alternative drugs could be used for treatment. Whereas for a patient-facing app, you may decide to hide this information to prevent patients from self-medicating. DrugBank's categorization goes beyond what some of the external identifiers offer, which is why some categories do not have external IDs mapped.
|drugbank_id||The DrugBank id of the active ingredient of the product code|
|name||Name of the active ingredient|
|categories→ drugbank_id||DrugBank assigned category id|
|categories→ name||The assigned therapeutic category name|
|mesh_id||Unique mesh id Code of the category, useful for mapping to external ids|
|atc_code||ATC Code of the category, for mapping to external ids|
|description||Brief description of the drug's therapeutic category|
|Drugs→ drugbank_id||DrugBank assigned id for the alternative active ingredient|
|Drugs→ name||The name of the alternative active ingredient|