Developer Documentation

Comprehensive pharmacology encyclopedia. Active pharmaceutical ingredients with molecular properties, ADME pharmacokinetics, drug targets, drug-drug interactions, ATC classification, therapeutic areas, drug journeys (ADME narratives), drug families (SAR analysis), clinical milestones, pharmacological comparisons, side effects, glossary terms, guides, and interactive tools in 15 languages.

Active ingredients (INN) with IUPAC names, CAS numbers, UNII, PubChem CID, ChEMBL ID, DrugBank ID
Molecular properties: formula, weight, SMILES, InChI, XLogP, TPSA, H-bond donors/acceptors, Lipinski
Pharmacology: mechanism of action, pharmacodynamics, pharmacokinetics
PK parameters: half-life, bioavailability, protein binding, metabolism, excretion
ATC drug classes (hierarchical, 5 levels) with DDD (Defined Daily Dose)
Drug targets (enzymes, receptors, ion channels, transporters, kinases) with UniProt/ChEMBL IDs
Drug-target interactions with action type (inhibitor, agonist, antagonist, etc.) and binding affinity
Drug-drug interactions with severity, mechanism, clinical significance, management
Therapeutic areas with ICD-10 codes and MeSH terms
Drug journeys: ADME narrative storytelling (absorption, distribution, mechanism, metabolism, excretion)
Drug families: SAR analysis with core scaffolds, structural modifications, pharmacophore features
Clinical milestones: drug discovery, mechanism elucidation, landmark approvals, Nobel prizes
Pharmacological comparisons: head-to-head drug analysis (PK, PD, chemistry, clinical)
Side effects with MedDRA codes and System Organ Class
Glossary terms across 12 pharmacology categories
Guides in 12 series (mechanisms, PK, drug classes, interactions, clinical trials, etc.)
Interactive pharmacology tools (interaction checker, half-life calculator, Lipinski, etc.)
SVG molecular structure visualizations

Quick Start

curl -s "https://drugfyi.com/api/v1/drugs/?limit=5"

API Endpoints

Method	Endpoint	Description
GET	/api/v1/drugs/	List active ingredients (paginated)
GET	/api/v1/drugs/{id}/	Drug detail with molecular properties
GET	/api/v1/drug-classes/	ATC drug classes
GET	/api/v1/drug-classes/{id}/	Drug class detail
GET	/api/v1/drug-targets/	Drug targets
GET	/api/v1/drug-targets/{id}/	Drug target detail
GET	/api/v1/therapeutic-areas/	Therapeutic areas
GET	/api/v1/therapeutic-areas/{id}/	Therapeutic area detail
GET	/api/v1/interactions/	Drug interactions
GET	/api/v1/journeys/	Drug journeys
GET	/api/v1/journeys/{id}/	Drug journey detail
GET	/api/v1/families/	Drug families
GET	/api/v1/families/{id}/	Drug family detail
GET	/api/v1/milestones/	Clinical milestones
GET	/api/v1/milestones/{id}/	Milestone detail
GET	/api/v1/comparisons/	Pharmacological comparisons
GET	/api/v1/comparisons/{id}/	Comparison detail
GET	/api/v1/side-effects/	Side effects
GET	/api/v1/side-effects/{id}/	Side effect detail
GET	/api/v1/glossary/	Glossary terms
GET	/api/v1/glossary/{id}/	Glossary term detail
GET	/api/v1/guides/	Guide articles
GET	/api/v1/guides/{id}/	Guide detail
GET	/api/v1/tools/	Interactive tools
GET	/api/v1/faqs/	FAQs
GET	/api/v1/search/?q={query}	Search across drugs, targets, glossary
GET	/api/v1/stats/	Site statistics

URL Patterns

Use these patterns to construct URLs programmatically:

/drugs/ Drug browse (paginated, filterable) (e.g. /drugs/)

/drugs/a-z/ Drugs A-Z index (e.g. /drugs/a-z/)

/drug/{slug}/ Drug detail with molecular data, PK, targets, interactions (e.g. /drug/aspirin/)

/classes/ ATC drug classes (hierarchical) (e.g. /classes/)

/class/{atc_code}/ Drug class detail (e.g. /class/n02ba/)

/targets/ Drug targets list (e.g. /targets/)

/target/{slug}/ Drug target detail with interacting drugs (e.g. /target/cyclooxygenase-2/)

/conditions/ Therapeutic areas list (e.g. /conditions/)

/condition/{slug}/ Therapeutic area detail (e.g. /condition/cardiovascular-diseases/)

/interaction/{drug_a}/{drug_b}/ Drug-drug interaction detail (e.g. /interaction/aspirin/warfarin/)

/journeys/ Drug journey narratives (ADME) (e.g. /journeys/)

/journey/{slug}/ Drug journey detail (e.g. /journey/the-journey-of-metformin/)

/families/ Drug families (SAR analysis) (e.g. /families/)

/family/{slug}/ Drug family detail (e.g. /family/the-statin-family/)

/timeline/ Clinical milestones timeline (e.g. /timeline/)

/timeline/calendar/ Timeline calendar view (e.g. /timeline/calendar/)

/timeline/{year}/ Timeline by year (e.g. /timeline/2024/)

/timeline/{slug}/ Milestone detail (e.g. /timeline/discovery-of-penicillin/)

/on-this-day/ On this day in pharmacology (e.g. /on-this-day/)

/on-this-day/{month-day}/ On this day detail (e.g. /on-this-day/03-14/)

/comparisons/ Pharmacological comparisons (e.g. /comparisons/)

/compare/{slug}/ Head-to-head drug comparison (e.g. /compare/aspirin-vs-ibuprofen/)

/side-effects/ Side effects list (MedDRA) (e.g. /side-effects/)

/side-effect/{slug}/ Side effect detail (e.g. /side-effect/headache/)

/guide/ Pharmacology guides (e.g. /guide/)

/guide/{slug}/ Guide article (e.g. /guide/understanding-drug-metabolism/)

/glossary/ Pharmacology glossary (e.g. /glossary/)

/glossary/{slug}/ Glossary term definition (e.g. /glossary/bioavailability/)

/tools/ Interactive pharmacology tools (e.g. /tools/)

/tools/{slug}/ Tool page (e.g. /tools/interaction-checker/)

/gallery/ Molecular structure gallery (e.g. /gallery/)

/rankings/ Drug rankings index (e.g. /rankings/)

/rankings/{metric}/ Drug ranking by metric (e.g. /rankings/most-targets/)

/search/ Search drugs, targets, glossary (e.g. /search/?q=aspirin)

/statistics/ DrugFYI statistics (e.g. /statistics/)

Response Format

All endpoints return JSON with pagination:

Example JSON response

{
  "count": 636,
  "next": "https://example.com/api/v1/items/?page=2",
  "previous": null,
  "results": [
    {"slug": "example", "name": "Example Item", "...": "..."}
  ]
}

Format Support

Markdown endpoints: Append .md to any page URL for LLM-friendly markdown output.
Internationalization: Content available in 14 languages: ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id.