# BioStudies API
> BioStudies as an API, powered by EMBL-EBI — the database that holds the descriptions of biological studies and links their data together across EBI resources, including imaging (BioImage Archive), functional genomics (ArrayExpress), proteomics, and the literature (Europe PMC). Each study has an accession, a title and abstract, the collection it belongs to and links to its underlying data and publications. /v1/search?query=covid searches the studies and returns each match's accession (e.g. S-EPMC8017430), title, author, study type, release date and link/file counts. /v1/study?id=S-EPMC8017430 returns a study's metadata — its accession, the collection it belongs to (such as EuropePMC, ArrayExpress or BioImages), title, abstract, release date, authors and the number of linked resources. Accessions look like S-EPMC8017430 or S-BSST123; get one from the search endpoint. Ideal for research-data discovery, linking literature to its underlying datasets, systematic reviews and reproducibility tooling. Data from EMBL-EBI BioStudies (public). This is a studies and datasets metadata index — distinct from the sequence (UniProt, ENA), structure (PDB, EMDB), variant (ClinVar) and ontology databases.
## 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/biostudies-api/..."
```
## Pricing
- **Free** (Free) — 2,150 calls/Mo, 2 req/s
- **Starter** ($6/Mo) — 47,000 calls/Mo, 5 req/s
- **Pro** ($19/Mo) — 212,000 calls/Mo, 12 req/s
- **Mega** ($52/Mo) — 775,000 calls/Mo, 35 req/s
## Endpoints
### Studies
#### `GET /v1/search` — Search biological studies
**Parameters:**
- `q` (query, required, string) — Search text, e.g. covid Example: `covid`
- `limit` (query, optional, string) — Max results (1-100)
**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
"https://api.oanor.com/biostudies-api/v1/search?q=covid"
```
**Response:**
```json
{
"data": {
"count": 20,
"query": "covid",
"total": 1372,
"studies": [
{
"url": "https://www.ebi.ac.uk/biostudies/studies/S-EPMC8017430",
"type": "study",
"files": 1,
"links": 3,
"title": "Comparison of Psychological Morbidity of Health Care Workers Posted in COVID and Non COVID Labour Rooms.",
"author": "Mishra A Marwah S Arora R Yadav A Anand N Mushahary D",
"accession": "S-EPMC8017430",
"release_date": "2021-01-01"
},
{
"url": "https://www.ebi.ac.uk/biostudies/studies/S-EPMC10621843",
"type": "study",
"files": 2,
"links": 3,
"title": "Long COVID in the United States.",
"author": "Blanchflower DG Bryson A",
"accession": "S-EPMC10621843",
"release_date": "2023-01-01"
},
{
"url": "https://www.ebi.ac.uk/biostudies/studies/S-EPMC9046008",
"type": "study",
"files": 1,
"links": 3,
"title": "Long COVID Citizen Scientists: Developing a Needs-Based Research Agenda by Persons Affected by Long COVID.",
"author": "Ziegler S Raineri A Nittas V Rangelov N Vollrath F Britt C Puhan MA",
"accession": "S-EPMC9046008",
"r
…(truncated, see openapi.json for full schema)
```
#### `GET /v1/study` — A study metadata
**Parameters:**
- `id` (query, required, string) — BioStudies accession (from /v1/search), e.g. S-EPMC8017430 Example: `S-EPMC8017430`
**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
"https://api.oanor.com/biostudies-api/v1/study?id=S-EPMC8017430"
```
**Response:**
```json
{
"data": {
"study": {
"url": "https://www.ebi.ac.uk/biostudies/studies/S-EPMC8017430",
"type": "submission",
"title": "Comparison of Psychological Morbidity of Health Care Workers Posted in COVID and Non COVID Labour Rooms.",
"authors": [
"Mishra A",
"Marwah S",
"Arora R",
"Yadav A",
"Anand N",
"Mushahary D"
],
"abstract": "Background
The COVID-19 pandemic had not only burdened healthcare systems all over the world but had also affected mental health of frontline Health Care Workers.Purpose
Purpose of our study was to compare the psychological morbidity of health care workers posted in Covid labour room with their counter parts in Non Covid labour room.Material and methods
Present study was a cross-sectional study conducted on HCW of Covid and Non Covid labour in a span of 6 months.Results
Insomnia in Covid labour room was found to be in 57% HCW as compared to none in non Covid labour room (mean score 7.47 ± 2.74 vs 1.82 ± 1.25, P Value < .0001). Depression was prevalent in 92% of participants in Covid labour room as compared to 12.5% in Non Covid labour room; however, severe depression was found in 6% participants (mean score 17.32 ± 4.88 vs 2.12 ± 1.65, P Value < .0001). Prevalence of anxiety in present study was 90% in Covid labour room and 6% in
…(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/biostudies-api/v1/meta"
```
**Response:**
```json
{
"data": {
"note": "BioStudies is EMBL-EBI's database that holds descriptions of biological studies and links their data together across EBI resources (imaging, functional genomics, proteomics, literature and more). /v1/search?q=covid = search the studies, returning each match's accession (e.g. S-EPMC8017430), title, author, type, release date and link/file counts; /v1/study?id=S-EPMC8017430 = a study's metadata — accession, collection, title, abstract, release date, authors and the number of linked resources. Accessions look like S-EPMC8017430 or S-BSST123; get one from /v1/search. Data from EMBL-EBI BioStudies (public). This is a studies / datasets metadata index — distinct from sequence, structure, variant and ontology databases. Ideal for research-data discovery, literature-to-data linking and reproducibility tooling.",
"source": "EMBL-EBI BioStudies (ebi.ac.uk/biostudies)",
"endpoints": [
"/v1/search",
"/v1/study",
"/v1/meta"
]
},
"meta": {
"timestamp": "2026-06-01T16:23:18.796Z",
"request_id": "a5525c76-b8b5-4bd7-90e9-aef5e31f1b54"
},
"status": "ok",
"message": "Meta retrieved",
"success": true
}
```
---
Marketplace page: https://www.oanor.com/api/biostudies-api
OpenAPI spec: https://www.oanor.com/api/biostudies-api/openapi.json