# PubMed API
> Search the world’s biomedical literature and retrieve clean article metadata and abstracts, powered by the U.S. National Library of Medicine’s PubMed via NCBI E-utilities. Search 35+ million citations by keyword with relevance or date sorting, look up one or more articles by PubMed id for title, authors, journal, publication date, volume/issue/pages, DOI and publication type, or fetch the full abstract text for a paper. Authoritative open data returned as tidy JSON through a fast, reliable API. Ideal for health-tech and clinical tools, pharma and life-sciences research, systematic reviews, reference managers and academic apps.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/pubmed-api/..."
```

## Pricing
- **Free** (Free) — 1,500 calls/Mo, 2 req/s
- **Basic** ($6/Mo) — 40,000 calls/Mo, 5 req/s
- **Pro** ($16/Mo) — 250,000 calls/Mo, 10 req/s
- **Mega** ($44/Mo) — 1,200,000 calls/Mo, 25 req/s

## Endpoints

### PubMed

#### `GET /v1/article` — Article metadata + abstract

**Parameters:**
- `pmid` (query, required, string) — PubMed id Example: `31295471`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pubmed-api/v1/article?pmid=31295471"
```

**Response:**
```json
{
    "data": {
        "doi": "10.1016/j.lfs.2019.116636",
        "url": "https://pubmed.ncbi.nlm.nih.gov/31295471/",
        "pmid": "31295471",
        "issue": null,
        "pages": "116636",
        "title": "CRISPR-Cas9 system: A new-fangled dawn in gene editing",
        "volume": "232",
        "authors": [
            "Gupta D",
            "Bhattacharjee O",
            "Mandal D",
            "Sen MK",
            "Dey D",
            "Dasgupta A",
            "Kazi TA",
            "Gupta R",
            "Sinharoy S",
            "Acharya K",
            "Chattopadhyay D",
            "Ravichandiran V",
            "Roy S",
            "Ghosh D"
        ],
        "journal": "Life sciences",
        "abstract": "Till date, only three techniques namely Zinc Finger Nuclease (ZFN), Transcription-Activator Like Effector Nucleases (TALEN) and Clustered Regularly Interspaced Short Palindromic Repeats-CRISPR-Associated 9 (CRISPR-Cas9) are available for targeted genome editing. CRISPR-Cas system is very efficient, fast, easy and cheap technique for achieving knock-out gene in the cell. CRISPR-Cas9 system refurbishes the targeted genome editing approach into a more expedient and competent way, thus facilitating proficient genome editing through embattled double-strand breaks in approximately any organism and cell type. The off-target effects of CRISPR Cas system has been circumnavigated by using paired nickases. Moreover, CRISPR-Cas9 has been used effectively for numerou
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search` — Search PubMed

**Parameters:**
- `query` (query, required, string) — Search terms (PubMed syntax supported) Example: `CRISPR gene editing`
- `limit` (query, optional, string) — 1-50 (default 10) Example: `10`
- `sort` (query, optional, string) — relevance | date | author Example: `relevance`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pubmed-api/v1/search?query=CRISPR+gene+editing&limit=10&sort=relevance"
```

**Response:**
```json
{
    "data": {
        "count": 10,
        "query": "CRISPR gene editing",
        "results": [
            {
                "doi": "10.1016/j.lfs.2019.116636",
                "url": "https://pubmed.ncbi.nlm.nih.gov/31295471/",
                "pmid": "31295471",
                "issue": null,
                "pages": "116636",
                "title": "CRISPR-Cas9 system: A new-fangled dawn in gene editing",
                "volume": "232",
                "authors": [
                    "Gupta D",
                    "Bhattacharjee O",
                    "Mandal D",
                    "Sen MK",
                    "Dey D",
                    "Dasgupta A",
                    "Kazi TA",
                    "Gupta R",
                    "Sinharoy S",
                    "Acharya K",
                    "Chattopadhyay D",
                    "Ravichandiran V",
                    "Roy S",
                    "Ghosh D"
                ],
                "journal": "Life sciences",
                "language": "eng",
                "pub_date": "2019 Sep 1",
                "epub_date": "2019 Jul 8",
                "pub_types": [
                    "Journal Article",
                    "Review"
                ]
            },
            {
                "doi": "10.3390/cells13100800",
                "url": "https://pubmed.ncbi.nlm.nih.gov/38786024/",
                "pmid": "38786024",
                "issue": "10",
                "pages": null,
                "
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/summary` — Article metadata by PMID

**Parameters:**
- `pmid` (query, required, string) — One or more PubMed ids (comma-separated) Example: `31295471`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pubmed-api/v1/summary?pmid=31295471"
```

**Response:**
```json
{
    "data": {
        "doi": "10.1016/j.lfs.2019.116636",
        "url": "https://pubmed.ncbi.nlm.nih.gov/31295471/",
        "pmid": "31295471",
        "issue": null,
        "pages": "116636",
        "title": "CRISPR-Cas9 system: A new-fangled dawn in gene editing",
        "volume": "232",
        "authors": [
            "Gupta D",
            "Bhattacharjee O",
            "Mandal D",
            "Sen MK",
            "Dey D",
            "Dasgupta A",
            "Kazi TA",
            "Gupta R",
            "Sinharoy S",
            "Acharya K",
            "Chattopadhyay D",
            "Ravichandiran V",
            "Roy S",
            "Ghosh D"
        ],
        "journal": "Life sciences",
        "language": "eng",
        "pub_date": "2019 Sep 1",
        "epub_date": "2019 Jul 8",
        "pub_types": [
            "Journal Article",
            "Review"
        ]
    },
    "meta": {
        "timestamp": "2026-05-30T18:16:53.676Z",
        "request_id": "e1e45618-972c-48d3-ab10-b0c648e40a02"
    },
    "status": "ok",
    "message": "Summary retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/pubmed-api
OpenAPI spec: https://www.oanor.com/api/pubmed-api/openapi.json