Developer Documentation
Pill identification and drug reference database. Comprehensive drug information sourced from DailyMed (NLM), openFDA, RxNorm, MFDS (Korean FDA), and DDinter. Drug classes (WHO ATC), conditions, manufacturers, side effects, drug interactions, glossary terms, guides, and interactive tools in 15 languages.
- Drugs with generic names, brand names, active/inactive ingredients
- Drug types: prescription, OTC, behind-the-counter
- Dosage forms: tablet, capsule, liquid, injection, topical, inhaler, patch, suppository, drops
- Drug classes based on WHO ATC classification (hierarchical)
- Medical conditions/indications with ICD-10 codes and body systems
- Pharmaceutical manufacturers with country and website
- Side effects/adverse reactions by body system
- Drug-drug interactions with severity (major/moderate/minor) and clinical details
- Drug-side effect relationships with frequency data (very common to very rare)
- Drug-condition relationships (FDA/MFDS approved and off-label)
- External IDs: DailyMed SET ID, NDC codes, RxCUI, MFDS item sequence
- SVG pill identification cards
- Glossary terms across pharmaceutical categories
- Medication guides in thematic series
- Interactive tools (interaction checker, etc.)
Quick Start
curl -s "https://pillfyi.com/api/v1/drugs/?limit=5"
API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/drugs/ | List all drugs (paginated) |
| GET | /api/v1/drugs/{id}/ | Drug detail |
| GET | /api/v1/drug-classes/ | List ATC drug classes |
| GET | /api/v1/drug-classes/{id}/ | Drug class detail |
| GET | /api/v1/conditions/ | List medical conditions |
| GET | /api/v1/conditions/{id}/ | Condition detail |
| GET | /api/v1/manufacturers/ | List manufacturers |
| GET | /api/v1/manufacturers/{id}/ | Manufacturer detail |
| GET | /api/v1/side-effects/ | List side effects |
| GET | /api/v1/side-effects/{id}/ | Side effect detail |
| GET | /api/v1/interactions/ | Drug interactions |
| 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, conditions, side effects |
| GET | /api/v1/stats/ | Site statistics |
URL Patterns
Use these patterns to construct URLs programmatically:
/drugs/
Drug directory (paginated, filterable) (e.g. /drugs/)
/drug/{slug}/
Drug detail with clinical info, ingredients, interactions (e.g. /drug/metformin/)
/drug/{slug}/interactions/
Drug interaction list for a specific drug (e.g. /drug/metformin/interactions/)
/drug/{slug}/side-effects/
Side effects for a specific drug (e.g. /drug/metformin/side-effects/)
/classes/
WHO ATC drug classes list (e.g. /classes/)
/class/{slug}/
Drug class detail with member drugs (e.g. /class/antidiabetics/)
/conditions/
Medical conditions list (e.g. /conditions/)
/condition/{slug}/
Condition detail with approved drugs (e.g. /condition/diabetes/)
/manufacturers/
Pharmaceutical manufacturers list (e.g. /manufacturers/)
/manufacturer/{slug}/
Manufacturer profile with drugs (e.g. /manufacturer/pfizer/)
/side-effects/
Side effects list (e.g. /side-effects/)
/side-effect/{slug}/
Side effect detail (e.g. /side-effect/headache/)
/interaction/{slug_a}/{slug_b}/
Drug-drug interaction detail (e.g. /interaction/metformin/glipizide/)
/interaction-checker/
Interactive drug interaction checker tool (e.g. /interaction-checker/)
/glossary/
Pharmaceutical glossary (e.g. /glossary/)
/glossary/{slug}/
Glossary term definition (e.g. /glossary/bioavailability/)
/tools/
Interactive tools (e.g. /tools/)
/tools/{slug}/
Tool page (e.g. /tools/interaction-checker/)
/guides/
Medication guide series (e.g. /guides/)
/guides/{series_slug}/
Guide series (e.g. /guides/medication-safety/)
/guides/{series_slug}/{guide_slug}/
Guide article (e.g. /guides/medication-safety/drug-interactions/)
/timeline/
Drug approval timeline (e.g. /timeline/)
/timeline/{year}/
Timeline by year (e.g. /timeline/2024/)
/on-this-day/
On this day in pharma history (e.g. /on-this-day/)
/on-this-day/{month-day}/
On this day detail (e.g. /on-this-day/01-01/)
/rankings/
Drug rankings index (e.g. /rankings/)
/rankings/{metric}/
Drug ranking by metric (e.g. /rankings/most-prescribed/)
/search/
Search drugs, conditions, side effects (e.g. /search/?q=metformin)
/gallery/
Pill identification gallery (e.g. /gallery/)
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
.mdto 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.