# PRIDE API
> The PRIDE proteomics archive as an API, powered by the EMBL-EBI PRIDE Archive — the world's largest public repository of mass-spectrometry proteomics data and a founding member of ProteomeXchange. Search the public proteomics experiments by keyword (returning each project's accession, title, organisms, diseases and instruments); read a project's full metadata including its description, keywords, organisms and organism parts, mass-spectrometry instruments, software, the protein modifications identified, sample- and data-processing protocols, submitters, affiliations and the linked publication (DOI and PubMed); list a project's data files with their category, format, size and a direct download link; and explore facets — the diseases, organisms, instruments, experiment types, software and countries represented across matching projects — for discovery. Ideal for proteomics and systems-biology research, dataset reuse and meta-analysis, bioinformatics pipelines, and tools that integrate experimental evidence. Project accessions look like PXD000001. Data from EMBL-EBI.

## 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/pride-api/..."
```

## Pricing
- **Free** (Free) — 540 calls/Mo, 2 req/s
- **Starter** ($7/Mo) — 19,500 calls/Mo, 6 req/s
- **Pro** ($20/Mo) — 88,000 calls/Mo, 15 req/s
- **Mega** ($56/Mo) — 340,000 calls/Mo, 40 req/s

## Endpoints

### Projects

#### `GET /v1/project` — A project's metadata

**Parameters:**
- `id` (query, required, string) — PRIDE accession, e.g. PXD000001 Example: `PXD000001`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pride-api/v1/project?id=PXD000001"
```

**Response:**
```json
{
    "data": {
        "project": {
            "doi": "10.6019/PXD000001",
            "tags": [
                "Prime-xs project"
            ],
            "title": "TMT spikes -  Using R and Bioconductor for proteomics data analysis",
            "license": "EBI terms of use",
            "diseases": [],
            "keywords": [
                "Spikes",
                "Tmt",
                "Eriwinia"
            ],
            "software": [],
            "accession": "PXD000001",
            "organisms": [
                "Erwinia carotovora"
            ],
            "references": [
                {
                    "doi": "10.1016/j.bbapap.2013.04.032",
                    "pubmed": null,
                    "reference": "Gatto L, Christoforou A; Using R and Bioconductor for proteomics data analysis., Biochim Biophys Acta, 2013 May 18, "
                }
            ],
            "submitters": [
                "Laurent Gatto"
            ],
            "description": "Expected reporter ion ratios: Erwinia peptides:    1:1:1:1:1:1 Enolase spike (sp|P00924|ENO1_YEAST):  10:5:2.5:1:2.5:10 BSA spike (sp|P02769|ALBU_BOVIN):  1:2.5:5:10:5:1 PhosB spike (sp|P00489|PYGM_RABIT):  2:2:2:2:1:1 Cytochrome C spike (sp|P62894|CYC_BOVIN): 1:1:1:1:1:2",
            "instruments": [
                "LTQ Orbitrap Velos"
            ],
            "affiliations": [],
            "data_protocol": "Two extra files have been added post-publication:<br><a href=\"ftp://ftp.pride.
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search` — Search proteomics projects

**Parameters:**
- `keyword` (query, required, string) — Search text, e.g. cancer Example: `cancer`
- `page` (query, optional, string) — Page (0-based)
- `limit` (query, optional, string) — Max results (1-100)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pride-api/v1/search?keyword=cancer"
```

**Response:**
```json
{
    "data": {
        "page": 0,
        "count": 20,
        "keyword": "cancer",
        "projects": [
            {
                "title": "IFN-γ-driven iNOS induction in macrophages mediates CAR T cell resistance in B cell lymphoma",
                "diseases": [],
                "accession": "PXD079073",
                "organisms": [
                    "Mus musculus (mouse)"
                ],
                "instruments": [
                    "Orbitrap Exploris 480"
                ],
                "submission_date": "2026-05-30",
                "submission_type": "COMPLETE"
            },
            {
                "title": "IFN-γ-driven iNOS induction in macrophages mediates CAR T cell resistance in B cell lymphoma: Phosphoproteomics",
                "diseases": [],
                "accession": "PXD079082",
                "organisms": [
                    "Mus musculus (mouse)"
                ],
                "instruments": [
                    "Orbitrap Exploris 480"
                ],
                "submission_date": "2026-05-30",
                "submission_type": "COMPLETE"
            },
            {
                "title": "FISH+ is a ready-to-use proximity labeling method for simultaneous RNA visualization and RNA-interacting protein identification",
                "diseases": [
                    "Disease free"
                ],
                "accession": "PXD078627",
                "organisms": [
                    "Homo sap
…(truncated, see openapi.json for full schema)
```

### Files

#### `GET /v1/files` — A project's data files

**Parameters:**
- `id` (query, required, string) — PRIDE accession Example: `PXD000001`
- `limit` (query, optional, string) — Max files (1-100)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pride-api/v1/files?id=PXD000001"
```

**Response:**
```json
{
    "data": {
        "count": 8,
        "files": [
            {
                "name": "PRIDE_Exp_Complete_Ac_22134.pride.mztab.gz",
                "format": null,
                "category": "OTHER",
                "compress": false,
                "download": "ftp://ftp.pride.ebi.ac.uk/pride/data/archive/2012/03/PXD000001/generated/PRIDE_Exp_Complete_Ac_22134.pride.mztab.gz",
                "size_bytes": 497985
            },
            {
                "name": "PRIDE_Exp_Complete_Ac_22134.pride.mgf.gz",
                "format": null,
                "category": "PEAK",
                "compress": false,
                "download": "prd_ascp@fasp.ebi.ac.uk:pride/data/archive/2012/03/PXD000001/generated/PRIDE_Exp_Complete_Ac_22134.pride.mgf.gz",
                "size_bytes": 16448103
            },
            {
                "name": "TMT_Erwinia_1uLSike_Top10HCD_isol2_45stepped_60min_01.mzXML",
                "format": null,
                "category": "PEAK",
                "compress": false,
                "download": "ftp://ftp.pride.ebi.ac.uk/pride/data/archive/2012/03/PXD000001/TMT_Erwinia_1uLSike_Top10HCD_isol2_45stepped_60min_01.mzXML",
                "size_bytes": 243031280
            },
            {
                "name": "erwinia_carotovora.fasta",
                "format": null,
                "category": "OTHER",
                "compress": false,
                "download": "ftp://ftp.pride.ebi.ac.uk/pride/data/archive/2012/03/PXD000001/e
…(truncated, see openapi.json for full schema)
```

### Discovery

#### `GET /v1/facets` — Faceted discovery counts

**Parameters:**
- `keyword` (query, optional, string) — Keyword, e.g. plasma Example: `plasma`
- `limit` (query, optional, string) — Facet size (1-50)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pride-api/v1/facets?keyword=plasma"
```

**Response:**
```json
{
    "data": {
        "facets": {
            "diseases": [
                {
                    "count": 20,
                    "value": "Malignant neoplasm of ovary"
                },
                {
                    "count": 15,
                    "value": "Obesity"
                },
                {
                    "count": 11,
                    "value": "Parkinson's disease"
                },
                {
                    "count": 36,
                    "value": "Covid-19"
                },
                {
                    "count": 8,
                    "value": "Severe acute respiratory syndrome"
                },
                {
                    "count": 45,
                    "value": "Cardiovascular system disease"
                },
                {
                    "count": 39,
                    "value": "Multiple myeloma"
                },
                {
                    "count": 13,
                    "value": "Melanoma"
                },
                {
                    "count": 12,
                    "value": "Acute leukemia"
                },
                {
                    "count": 52,
                    "value": "Breast cancer"
                }
            ],
            "keywords": [
                {
                    "count": 283,
                    "value": "Human"
                },
                {
                    "count": 62,
                    "value": "Lc-ms"
         
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Usage notes

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pride-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "Proteomics mass-spectrometry datasets. /v1/search?keyword=cancer = search public proteomics projects (accession, title, organisms, diseases, instruments); /v1/project?id=PXD000001 = a project's full metadata (description, keywords, organisms, instruments, software, identified modifications, sample & data protocols, submitters, publication DOI/PubMed); /v1/files?id=PXD000001 = the project's data files with category, format, size and a download link; /v1/facets?keyword=plasma = faceted counts for discovery (diseases, organisms, instruments, experiment types, software, countries). Project accessions are PXD/PRD followed by digits. PRIDE is the world's largest proteomics data repository, part of ProteomeXchange. Data from EMBL-EBI. For protein sequences see the UniProt API; for families & domains the InterPro API.",
        "source": "EBI PRIDE Archive API (ebi.ac.uk/pride)",
        "endpoints": [
            "/v1/search",
            "/v1/project",
            "/v1/files",
            "/v1/facets",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T08:13:34.297Z",
        "request_id": "ae6a07c1-ff9d-49d9-8815-07d760f3741a"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


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