arXiv Python API Wrapper

2.4.1 · active · verified Thu Apr 02

The `arxiv` library is a Python wrapper for the arXiv API, providing programmatic access to over a million scholarly articles in physics, mathematics, computer science, and other fields. It allows users to search, retrieve metadata, and download papers from the arXiv open-access repository. The library is actively maintained with frequent minor and patch releases.

Warnings

breaking Python 3.7 and 3.8 are no longer officially supported as of version 2.2.0. While existing code might still run, CI validation has ceased for these versions, and future compatibility is not guaranteed.
Fix: Upgrade to Python 3.9 or newer. The library officially supports Python 3.9 through 3.13.
deprecated Submodule-style imports like `import arxiv.arxiv` or `from arxiv import arxiv` were deprecated in version 2.1.0.
Fix: Use direct imports from the top-level `arxiv` package, e.g., `import arxiv` or `from arxiv import Client, Search`.
deprecated Direct download helper methods (e.g., `result.download_pdf()`, `result.download_source()`) were deprecated in version 2.3.0. While they might still function, their use is discouraged.
Fix: Implement custom download logic using `result.pdf_url` or `result.links` to fetch content, or use a dedicated download manager.
gotcha Version 2.3.1 introduced a fallback for missing titles by string matching `/pdf/`, which was reverted in 2.3.2 due to potential issues. If you encountered unexpected title parsing behavior around this version, it might have been related to this change.
Fix: Ensure you are on the latest patch release (>=2.3.2) to avoid the temporary fallback logic.
gotcha The arXiv API requests that users 'make no more than one request every three seconds'. The library's `Client` can be configured with `delay_seconds` to respect this, but excessive unthrottled requests can lead to IP blocking by arXiv.
Fix: When creating an `arxiv.Client`, consider setting `delay_seconds` (e.g., `client = arxiv.Client(delay_seconds=3.0)`) especially for scripts making many requests. Cache results where possible.

Install

pip install arxiv Install stable version

Imports

Client
```
from arxiv import Client
```
Submodule-style imports were deprecated in v2.1.0; direct import from `arxiv` is now the canonical way.
Search
```
from arxiv import Search
```
Result
```
from arxiv import Result
```
SortCriterion
```
from arxiv import SortCriterion
```
SortOrder
```
from arxiv import SortOrder
```

Quickstart

This example demonstrates how to initialize the API client, perform a search for articles, and iterate through the results to print their titles, authors, and publication dates.

import arxiv

# Construct the default API client
client = arxiv.Client()

# Search for the 10 most recent articles matching 'quantum'
search = arxiv.Search(
  query = "quantum",
  max_results = 10,
  sort_by = arxiv.SortCriterion.SubmittedDate,
  sort_order = arxiv.SortOrder.Descending
)

for result in client.results(search):
  print(f"Title: {result.title}")
  print(f"Authors: {', '.join(author.name for author in result.authors)}")
  print(f"Published: {result.published}")
  # Example: download PDF to current directory (note deprecation warning in v2.3.0)
  # result.download_pdf(dirpath='./downloads')

view raw JSON →