# arXiv API
> Search the entire arXiv scholarly-preprint corpus as an API — millions of papers across physics, mathematics, computer science, quantitative biology and finance, statistics, electrical engineering and economics. Query by free text, title, author and/or subject category (e.g. q=transformer&category=cs.AI), with paging and sort by relevance, submission or last-update date, or pull full metadata for any paper by its arXiv id (e.g. 1706.03762 → "Attention Is All You Need"). Every result carries the title, full author list, abstract, primary and cross-list categories, DOI, journal reference, comments and a direct PDF link. Ideal for literature-review and research tools, citation managers, ML/AI paper trackers, academic search and discovery, and science newsletters.

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

## Pricing
- **Free** (Free) — 3,900 calls/Mo, 2 req/s
- **Starter** ($6/Mo) — 58,000 calls/Mo, 8 req/s
- **Pro** ($14/Mo) — 290,000 calls/Mo, 20 req/s
- **Mega** ($38/Mo) — 1,450,000 calls/Mo, 50 req/s

## Endpoints

### Papers

#### `GET /v1/paper` — Full metadata for one or more papers by arXiv id

**Parameters:**
- `id` (query, required, string) — arXiv id(s), comma-separated up to 20, e.g. 1706.03762 Example: `1706.03762`

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

**Response:**
```json
{
    "data": {
        "paper": {
            "id": "1706.03762v7",
            "doi": null,
            "title": "Attention Is All You Need",
            "authors": [
                "Ashish Vaswani",
                "Noam Shazeer",
                "Niki Parmar",
                "Jakob Uszkoreit",
                "Llion Jones",
                "Aidan N. Gomez",
                "Lukasz Kaiser",
                "Illia Polosukhin"
            ],
            "comment": "15 pages, 5 figures",
            "pdf_url": "https://arxiv.org/pdf/1706.03762v7",
            "summary": "The dominant sequence transduction models are based on complex recurrent or convolutional neural networks in an encoder-decoder configuration. The best performing models also connect the encoder and decoder through an attention mechanism. We propose a new simple network architecture, the Transformer, based solely on attention mechanisms, dispensing with recurrence and convolutions entirely. Experiments on two machine translation tasks show these models to be superior in quality while being more parallelizable and requiring significantly less time to train. Our model achieves 28.4 BLEU on the WMT 2014 English-to-German translation task, improving over the existing best results, including ensembles by over 2 BLEU. On the WMT 2014 English-to-French translation task, our model establishes a new single-model state-of-the-art BLEU score of 41.8 after training for 3.5 days on eight GPUs, a small fraction of the tr
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search` — Search the arXiv corpus

**Parameters:**
- `q` (query, optional, string) — Free-text query (all fields), e.g. transformer Example: `transformer`
- `category` (query, optional, string) — Subject category, e.g. cs.AI, math.CO, stat.ML Example: `cs.AI`
- `author` (query, optional, string) — Author name, e.g. Hinton
- `title` (query, optional, string) — Title term
- `sort` (query, optional, string) — relevance | submitted | updated (default relevance) Example: `submitted`
- `start` (query, optional, string) — Pagination offset (0-30000) Example: `0`
- `max_results` (query, optional, string) — Results per page (1-100, default 10) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/arxiv-api/v1/search?q=transformer&category=cs.AI&sort=submitted&start=0&max_results=10"
```

**Response:**
```json
{
    "data": {
        "sort": "submitted",
        "count": 10,
        "query": "all:transformer AND cat:cs.AI",
        "start": 0,
        "total": 20611,
        "papers": [
            {
                "id": "2605.31590v1",
                "doi": null,
                "title": "TunerDiT: Training-free Progressive Steering of Diffusion Transformer for Multi-Event Video Generation",
                "authors": [
                    "Ruotong Liao",
                    "Guowen Huang",
                    "Qing Cheng",
                    "Guangyao Zhai",
                    "Lei Zhang",
                    "Xun Xiao",
                    "Thomas Seidl",
                    "Daniel Cremers",
                    "Volker Tresp"
                ],
                "comment": "17 pages, 13 figures",
                "pdf_url": "https://arxiv.org/pdf/2605.31590v1",
                "summary": "Text-to-video (T2V) generation faces challenging questions when generating videos with long horizons containing multiple events. Inspired by the intrinsics of the diffusion process, we probe video diffusion transformers (DiTs) and uncover intrinsic turning points in the DiT denoising trajectory where conditioning text affects generation from global layout to fine-grained details. Building on this finding, we present TunerDiT, a simple yet effective progressive steering method that requires no additional training for multi-event generation. TunerDiT comprises two steering handles: (1) Event-Pa
…(truncated, see openapi.json for full schema)
```

### Reference

#### `GET /v1/categories` — The arXiv subject taxonomy

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

**Response:**
```json
{
    "data": {
        "note": "Use a top-level id (e.g. cs) or a sub-category (e.g. cs.AI, math.CO, stat.ML) as the category= filter on /v1/search.",
        "count": 20,
        "categories": [
            {
                "id": "cs",
                "name": "Computer Science"
            },
            {
                "id": "math",
                "name": "Mathematics"
            },
            {
                "id": "physics",
                "name": "Physics (general)"
            },
            {
                "id": "astro-ph",
                "name": "Astrophysics"
            },
            {
                "id": "cond-mat",
                "name": "Condensed Matter"
            },
            {
                "id": "gr-qc",
                "name": "General Relativity & Quantum Cosmology"
            },
            {
                "id": "hep-ex",
                "name": "High Energy Physics — Experiment"
            },
            {
                "id": "hep-lat",
                "name": "High Energy Physics — Lattice"
            },
            {
                "id": "hep-ph",
                "name": "High Energy Physics — Phenomenology"
            },
            {
                "id": "hep-th",
                "name": "High Energy Physics — Theory"
            },
            {
                "id": "math-ph",
                "name": "Mathematical Physics"
            },
            {
                "id": "nlin",
                "name": "Nonl
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Source & usage notes

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

**Response:**
```json
{
    "data": {
        "note": "Scholarly preprints. /v1/search = search by q (all fields), title, author and/or category, with start/max_results paging and sort=relevance|submitted|updated (e.g. q=transformer&category=cs.AI); /v1/paper = full metadata for one or more arXiv ids (e.g. id=1706.03762, comma-separate up to 20); /v1/categories = the arXiv taxonomy. Each paper carries title, authors, abstract, categories, DOI, journal ref and a PDF link. Please respect arXiv's terms; data courtesy of arXiv.org.",
        "source": "arXiv API (export.arxiv.org)",
        "endpoints": [
            "/v1/search",
            "/v1/paper",
            "/v1/categories",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T00:04:40.837Z",
        "request_id": "3269f376-7bad-4dc8-80ed-925d7cb8a8ef"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


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