---
search:
  tags:
    - Research
    - POST
seo:
  description: >-
    Query the arXiv Atom API and return a list of matching papers. Reference for
    the POST /v1/arxiv/search endpoint in the Webfold API.
sidebar:
  label: Search arXiv
  badge: POST
title: Search arXiv
type: openapi-operation
---
Query the arXiv Atom API and return a list of matching papers.

`POST /v1/arxiv/search`

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

- `q` (string, required) — arXiv search query
- `n` (integer) — Maximum number of results (1-50, default 10)
- `from` (string) — Start date in YYYY-MM-DD format
- `to` (string) — End date in YYYY-MM-DD format
- `cats` (string[]) — arXiv categories to filter by
- `sort` (string) — Sort order: \`relevance\` or \`date\`

Request body example:

```json
{
  "q": "attention is all you need",
  "n": 10,
  "from": "2020-01-01",
  "to": "2020-12-31",
  "cats": [
    "cs.AI",
    "cs.LG"
  ],
  "sort": "relevance"
}
```

**Responses**

- `200` — List of papers
- `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
[
  {
    "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"
  }
]
```