118 lines
3.8 KiB
Markdown
118 lines
3.8 KiB
Markdown
---
|
|
title: "medRxiv API"
|
|
task: ""
|
|
lineage_type: import
|
|
upstream_source: https://github.com/K-Dense-AI/scientific-agent-skills/blob/9c9bd2e9/skills/paper-lookup/references/medrxiv.md
|
|
upstream_sha: 9c9bd2e9
|
|
imported_at: 2026-06-27
|
|
prompt_class: prompt
|
|
upstream_changes: accepted
|
|
author: upstream
|
|
validated: false
|
|
---
|
|
|
|
# medRxiv API
|
|
|
|
medRxiv is a preprint server for health sciences. The API is identical to bioRxiv's API -- same endpoints, same response format -- just use `medrxiv` as the server parameter.
|
|
|
|
**Important:** Like bioRxiv, there is **no keyword search**. Use Semantic Scholar, OpenAlex, or PubMed for keyword searches of medRxiv content.
|
|
|
|
## Base URL
|
|
|
|
```
|
|
https://api.biorxiv.org
|
|
```
|
|
|
|
(Same base URL as bioRxiv -- the server is specified in the path.)
|
|
|
|
## Authentication
|
|
|
|
None required. Fully public API.
|
|
|
|
## Key Endpoints
|
|
|
|
### 1. Content Detail -- Browse by date range
|
|
|
|
```
|
|
GET /details/medrxiv/{interval}/{cursor}/{format}
|
|
```
|
|
|
|
| Parameter | Values | Description |
|
|
|-----------|--------|-------------|
|
|
| `interval` | `YYYY-MM-DD/YYYY-MM-DD` | Date range (inclusive) |
|
|
| | `N` (integer) | N most recent preprints |
|
|
| | `Nd` (integer + "d") | Last N days |
|
|
| `cursor` | Integer (default `0`) | Pagination offset (100 per page) |
|
|
| `format` | `json` (default), `xml` | Response format |
|
|
|
|
Optional: `?category=cardiovascular%20medicine` (use URL-encoding for spaces)
|
|
|
|
**Examples:**
|
|
```
|
|
https://api.biorxiv.org/details/medrxiv/2024-01-01/2024-01-31/0
|
|
https://api.biorxiv.org/details/medrxiv/5
|
|
https://api.biorxiv.org/details/medrxiv/10d
|
|
```
|
|
|
|
### 2. Content Detail -- DOI lookup
|
|
|
|
```
|
|
GET /details/medrxiv/{doi}/na/{format}
|
|
```
|
|
|
|
**Example:**
|
|
```
|
|
https://api.biorxiv.org/details/medrxiv/10.1101/2021.04.29.21256344/na/json
|
|
```
|
|
|
|
### 3. Published Article Links
|
|
|
|
```
|
|
GET /pubs/medrxiv/{interval}/{cursor}
|
|
GET /pubs/medrxiv/{doi}/na
|
|
```
|
|
|
|
Links preprints to their published journal versions. Accepts both preprint DOI and published DOI.
|
|
|
|
## Response Format
|
|
|
|
Same as bioRxiv:
|
|
|
|
```json
|
|
{
|
|
"messages": [{
|
|
"status": "ok",
|
|
"count": 100,
|
|
"total": "502",
|
|
"cursor": 0
|
|
}],
|
|
"collection": [{
|
|
"title": "Paper title...",
|
|
"authors": "Surname, A.; Surname, B.",
|
|
"author_corresponding": "Full Name",
|
|
"author_corresponding_institution": "Institution",
|
|
"doi": "10.1101/2021.04.29.21256344",
|
|
"date": "2021-05-03",
|
|
"version": "1",
|
|
"type": "PUBLISHAHEADOFPRINT",
|
|
"license": "cc_by_nc_nd",
|
|
"category": "cardiovascular medicine",
|
|
"abstract": "Full abstract text...",
|
|
"published": "10.1371/journal.pone.0256482",
|
|
"server": "medRxiv"
|
|
}]
|
|
}
|
|
```
|
|
|
|
## Pagination
|
|
|
|
100 results per page. Use `cursor` parameter to paginate.
|
|
|
|
## Rate Limits
|
|
|
|
No documented rate limits. No authentication required.
|
|
|
|
## Categories
|
|
|
|
`addiction-medicine`, `allergy-and-immunology`, `anesthesia`, `cardiovascular-medicine`, `dentistry-and-oral-medicine`, `dermatology`, `emergency-medicine`, `endocrinology`, `epidemiology`, `forensic-medicine`, `gastroenterology`, `genetic-and-genomic-medicine`, `geriatric-medicine`, `health-economics`, `health-informatics`, `health-policy`, `health-systems-and-quality-improvement`, `hematology`, `hiv-aids`, `infectious-diseases`, `intensive-care-and-critical-care-medicine`, `medical-education`, `medical-ethics`, `nephrology`, `neurology`, `nursing`, `nutrition`, `obstetrics-and-gynecology`, `occupational-and-environmental-health`, `oncology`, `ophthalmology`, `orthopedics`, `otolaryngology`, `pain-medicine`, `palliative-medicine`, `pathology`, `pediatrics`, `pharmacology-and-therapeutics`, `primary-care-research`, `psychiatry-and-clinical-psychology`, `public-and-global-health`, `radiology-and-imaging`, `rehabilitation-medicine-and-physical-therapy`, `respiratory-medicine`, `rheumatology`, `sexual-and-reproductive-health`, `sports-medicine`, `surgery`, `toxicology`, `transplantation`, `urology`
|