openFDA API

Research & science · v1.2.0 · openfda

$0.0004 / report

$0.40 / 1K · pay per delivered report

An openFDA API reads the FDA's FAERS adverse-event reporting system and returns one row per safety report: the report id, whether it was flagged serious and why, the drugs named, the reactions as MedDRA terms, the patient's reported sex and age, the country and the received date. Pass a drug name, or openFDA's own field:value query syntax, and it stays keyless.

By Aldo Morese, founder of QuanticData · Published Aug 21, 2026 · Updated Sep 3, 2026

Run in dashboard See the request

$0.0004 per delivered report · $2 free every month · Failed runs never billed

What it does

What an openFDA API does

A FAERS report is deeply nested — it holds an array of drugs, each its own sub-record, and an array of reactions coded to MedDRA. This pulls the medicinal product names and the reaction terms up to the top level as plain arrays, so a report reads as one flat row rather than a tree you traverse per drug and per reaction.

The seriousness flag and its reasons — death, hospitalization, life-threatening — are what most safety analysis keys on, and openFDA spreads them across separate boolean columns. Here they collapse into a single serious flag plus a reasons array, so a corpus can be filtered down to serious events without decoding each individual marker.

Inputs

The whole request. Anything you leave out falls back to the default shown in the catalog.

Input	Type	Required	What it does
`query`	string	yes	A drug name, or an openFDA field:value query.
`max_results`	integer	no	How many reports to deliver at most (1–500). You pay only for delivered reports.

Outputs — 22 fields, one row per report

What one report looks like

Every delivered report carries these fields. Nullable means the source did not publish it — the field stays empty instead of being guessed.

Field	Type	What it holds
`rank`	integer	1-based position.
`report_id`	string	FAERS safety report id.
`serious`	boolean	Whether the report is flagged serious.
`serious_reasons`	string[]	Death, hospitalization, life-threatening…
`drugs`	string[]	Reported medicinal products.
`reactions`	string[]	Reactions (MedDRA terms).
`patient_sex`	string · nullable	male/female when reported.
`patient_age`	string · nullable	Patient age as reported.
`country`	string · nullable	Country of occurrence.
`received_date`	string · nullable	Received date (ISO).
`report_type`	string · nullable	Report type code.
`suspect_drugs`	string[]	Drugs the reporter held responsible.
`drug_roles`	string[]	Roles present in the report: suspect, concomitant, interacting.
`generic_names`	string[]	Generic names of the reported drugs.
`brand_names`	string[]	Brand names of the reported drugs.
`indications`	string[]	What the drugs were taken for.
`reaction_outcomes`	string[]	Outcomes of the reactions (recovered, fatal…).
`patient_age_years`	number · nullable	Patient age in years, when reported in years.
`patient_weight_kg`	number · nullable	Patient weight, kg.
`latest_update`	string · nullable	Date of the latest information on the report.
`reporter`	string · nullable	Who reported: physician, pharmacist, consumer…
`manufacturer_report_id`	string · nullable	Manufacturer's own report number.

Integration

One POST, typed rows

Base URL https://api.quanticdata.io/v1, Bearer auth, the same key as every other Data API. Endpoint: POST /v1/scraper/collectors/openfda/run.

curl -X POST https://api.quanticdata.io/v1/scraper/collectors/openfda/run \
  -H "Authorization: Bearer $QD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"ibuprofen","max_results":50}'

import requests

r = requests.post(
    "https://api.quanticdata.io/v1/scraper/collectors/openfda/run",
    headers={"Authorization": f"Bearer {QD_API_KEY}"},
    json={
        "query": "ibuprofen",
        "max_results": 50
    },
    timeout=120,
)
for row in r.json()["payload"]["results"]:
    print(row)

const res = await fetch(
  "https://api.quanticdata.io/v1/scraper/collectors/openfda/run",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.QD_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"query":"ibuprofen","max_results":50}),
  },
);
const { payload } = await res.json();
console.table(payload.results);

claude mcp add quanticdata \
  -e QUANTICDATA_API_KEY=qd_live_your_key_here \
  -- npx -y quanticdata-mcp

# then, in the chat:
> run the openfda collector with query="ibuprofen" and max_results=50

Example response

POST /v1/scraper/collectors/openfda/run

$ curl $QD/openfda/run \
    -H "Authorization: Bearer $QD_API_KEY" \
    -d '{"query": "ibuprofen", "max_results": 50}'
{ "status": "done", "count": 50,
  "results": [
    {
      "report_id": "…",
      "serious": false,
      "serious_reasons": […],
      "drugs": […] } ],
  "cost": 0.02 }
# 50 reports × $0.0004 · nothing delivered, nothing charged

Try it

FDA adverse events (openFDA), running now

Change the input and run it against the live collector — nothing to install, no sign-up.

Run it from your own code, on your own inputs

Same collector, same rows — $2 of free API credit every month, no card.

Get my free API key

openFDA API: from query, QuanticData reads the openFDA reports and returns one row per report with serious, patient_sex and patient_age, at $0.0004 per delivered report. — You send query and max_results; the run reads the source and comes back as reports with rank, report_id and serious — 22 fields on every row — and you are billed $0.0004 for each report actually delivered, nothing for a run that delivers none.

$0.0004 / report5,000 reports on the free $2 every month

Semantic inputquery, max_results — no URL lists

Up to 500reports per run, pagination handled for you

No browserread over HTTP/TLS — cheaper and faster than rendering

Pricing

openFDA API pricing

$0.0004 per delivered report. A run that delivers nothing costs nothing: blocked pages, challenges and retries are on us, and the $2 monthly allowance covers about 5,000 reports before you spend anything.

$0.0004per delivered report$0.4 per 1,000 delivered reports

5,000 reportson the free allowance$2 every month, no card

Zero rowszero chargeblocks, captchas and retries are on us

−30%on volume tiersthe catalog returns your key's price

Pay as you go

$0/mo

$2 free credit / month
60 requests / min
List unit prices

Starter

$19/mo

$15 free credit / month
300 requests / min
10% off unit prices

Growth

$79/mo

$50 free credit / month
600 requests / min
20% off unit prices

Scale

$299/mo

$250 free credit / month
1,200 requests / min
30% off unit prices

Same wallet, same key and same $2 monthly allowance as every other Data API. Prices are launch pricing read live from the billing config — GET /v1/scraper/collectors returns the price your key actually pays.

What people build with the openFDA API

Three shapes of work this endpoint was designed around.

Pharmacovigilance datasets

Pull every report naming a drug and each arrives with its reactions and seriousness already extracted, building a signal table instead of a stack of nested reports.

Reaction frequency analysis

The MedDRA reactions array lets you count which adverse events recur for a product, sliced by patient sex, age or country from the same row.

Drug safety monitoring

Query a medicinal product on a schedule and watch new serious reports enter the feed, each one carrying the reason it was flagged.

openFDA API versus rolling your own

The differences that actually cost time when you build this in-house.

	DIY scraper	This collector
Report shape	Drugs and reactions in per-item nested arrays	Products and MedDRA terms as top-level arrays
Seriousness	Separate boolean columns to decode	One serious flag plus a reasons array
Query	Build the field:value string by hand	A plain drug name, or the field syntax when you want it

What people search for

Live autocomplete demand around FDA adverse events (openFDA), pulled with our own Keyword ideas collector.

openFDA API: the POST to the openfda collector, 50 reports delivered and the bill, 50 × $0.0004 = $0.02 in usage.cost_usd; zero reports would cost $0. — The same call you would paste into a terminal: a Bearer key, query in the body, and back the envelope every QuanticData endpoint returns — type, message, payload — where count is how many reports arrived and usage.cost_usd is $0.02, which is 50 × $0.0004. A run that delivers nothing costs nothing. The key is good for 60 req/min on the free tier.

Sources and standards

The platform documentation and standards this collector is built against — check any claim on this page against the primary source:

FAQ

Questions we get about the openFDA API.

Something else? Ask us

Do I need a key for openFDA?

No. This reads openFDA keyless, so you send a drug name or a field query and get FAERS rows back without registering an API key first.

Can I use openFDA's field:value query syntax?

Yes. Pass a plain drug name for the common case, or a query like patient.reaction.reactionmeddrapt:headache when you want to search a specific FAERS field directly.

What does the serious flag mean?

It is the report's own seriousness marker; when it is true, the serious_reasons array says why — death, hospitalization, life-threatening and so on — so a dataset can be filtered to serious events while keeping the reason.

Is there a free openFDA API?

Every account gets $2 of credit every month with no card, which is about 5,000 delivered reports on this endpoint at $0.0004 each. It renews monthly, and a run that delivers nothing is never billed — so a failed or blocked attempt does not eat the allowance.

How much does one run cost?

Multiply the rows you actually receive by $0.0004. A run capped at 500 reports — the maximum for this collector — costs $0.2 if every row comes back, and less when the source has fewer. Volume tiers take up to 30% off, and GET /v1/scraper/collectors returns the price your key actually pays.

Run the openFDA API now

$2 of free credit every month, no card. Your key returns its own prices from GET /v1/scraper/collectors.

Run in dashboard

Illustration: three coloured zones of the page that is read (openFDA reports) turn into clean JSON with the fields serious, patient_sex and patient_age; 22 fields on every row.