openFDA Human Drug Skill
Query structured SPL (Structured Product Labeling) data from the FDA. No API key needed (≤1 000 req/day).
Input → Detection
| Input Example |
Routed To |
"ASPIRIN" or ["METFORMIN","LISINOPRIL"] |
search_drug — brand/generic name lookup |
"hypertension" or ["diabetes","migraine"] |
search_by_indication — indication text search |
| (no input) |
count_by_route — top administration routes |
All search functions accept a single string or a list of strings.
API
| Function |
Input |
Returns |
search_drug(query, limit) |
str | list[str], int |
{term: [label_dicts]} |
search_by_indication(query, limit) |
str | list[str], int |
{condition: [label_dicts]} |
count_by_route(top_n) |
int |
[{term, count}] |
summarize(results) |
dict from above |
compact multi-line text |
Each label_dict contains: brand_name, generic_name, manufacturer, route, substance_name, product_type, indications, contraindications, warnings, dosage, adverse_reactions.
Usage
See if __name__ == "__main__" block in 05_openFDA_Human_Drug.py for runnable examples covering: single drug, batch drugs, single indication, batch indications, route counts, and raw JSON output.
Notes
- Long text fields (
indications, warnings, etc.) are truncated to keep payloads concise.
- On HTTP/query errors the result dict contains an
error key for that term.
- Endpoint:
https://api.fda.gov/drug/label.json
1---2name: openfda-human-drug3description: Query FDA drug labeling data via openFDA. Use whenever the user asks about drug prescribing information — indications, warnings, dosage, adverse reactions, contraindications, or administration routes. Supports single or batch lookup by brand/generic name or by indication/condition.4---5
6# openFDA Human Drug Skill
7
8Query structured SPL (Structured Product Labeling) data from the FDA. No API key needed (≤1 000 req/day).
9
10## Input → Detection
11
12| Input Example | Routed To |
13|---|---|
14| `"ASPIRIN"` or `["METFORMIN","LISINOPRIL"]` | `search_drug` — brand/generic name lookup |
15| `"hypertension"` or `["diabetes","migraine"]` | `search_by_indication` — indication text search |
16| *(no input)* | `count_by_route` — top administration routes |
17
18All search functions accept **a single string or a list of strings**.
19
20## API
21
22| Function | Input | Returns |
23|---|---|---|
24| `search_drug(query, limit)` | str \| list[str], int | `{term: [label_dicts]}` |
25| `search_by_indication(query, limit)` | str \| list[str], int | `{condition: [label_dicts]}` |
26| `count_by_route(top_n)` | int | `[{term, count}]` |
27| `summarize(results)` | dict from above | compact multi-line text |
28
29Each `label_dict` contains: `brand_name`, `generic_name`, `manufacturer`, `route`, `substance_name`, `product_type`, `indications`, `contraindications`, `warnings`, `dosage`, `adverse_reactions`.
30
31## Usage
32
33See `if __name__ == "__main__"` block in `05_openFDA_Human_Drug.py` for runnable examples covering: single drug, batch drugs, single indication, batch indications, route counts, and raw JSON output.
34
35## Notes
36
37- Long text fields (`indications`, `warnings`, etc.) are truncated to keep payloads concise.
38- On HTTP/query errors the result dict contains an `error` key for that term.
39- Endpoint: `https://api.fda.gov/drug/label.json`
gabrielmoreira