---
search:
  tags:
    - Research
    - POST
seo:
  description: >-
    Fetch a paper by its arXiv ID, normalize it to Markdown, optionally prune
    references,… Reference for the POST /v1/arxiv/retrieve endpoint in the
    Webfold API.
sidebar:
  label: Retrieve an arXiv paper
  badge: POST
title: Retrieve an arXiv paper
type: openapi-operation
---
Fetch a paper by its arXiv ID, normalize it to Markdown, optionally prune
references, and chunk the result. The paper metadata is returned nested
under `paper` along with the extracted text and chunk list.

`POST /v1/arxiv/retrieve`

**Request body** (`application/json`, required)

- `paper_id` (string, required) — arXiv paper ID
- `prune_references` (boolean) — Drop the references/bibliography section
- `chunk_chars` (integer) — Target chunk size in characters
- `chunk_overlap` (integer) — Characters of overlap between adjacent chunks

Request body example:

```json
{
  "paper_id": "1706.03762",
  "prune_references": true,
  "chunk_chars": 4000,
  "chunk_overlap": 200
}
```

**Responses**

- `200` — Paper with extracted Markdown and chunks
- `400` — Bad request
- `401` — Missing or invalid bearer token
- `403` — Billing or plan entitlement blocked the request
- `502` — Upstream service (arXiv, YouTube, web page) failed

Response example, 200:

```json
{
  "paper": {
    "id": "1706.03762",
    "title": "Attention Is All You Need",
    "authors": [
      "Ashish Vaswani",
      "Noam Shazeer"
    ],
    "abstract_text": "The dominant sequence transduction models...",
    "categories": [
      "cs.CL",
      "cs.LG"
    ],
    "published": "2017-06-12T00:00:00Z",
    "url": "https://arxiv.org/abs/1706.03762"
  },
  "source": "html",
  "raw_markdown": "string",
  "pruned_markdown": "string",
  "chunks": [
    {
      "index": 0,
      "start_char": 0,
      "end_char": 1234,
      "text": "..."
    }
  ]
}
```