Skip to main content

A Python wrapper for the arXiv API.

Project description


A Python wrapper for the arXiv API.


$ pip install arxiv-cli


You can use arXiv-CLI as a CLI to navigate arXiv or as a library to query its API.


Currently arXiv-CLI implements three subcommands:

$ arxiv download [-t/--timeout seconds] IDS
$ arxiv fetch [-t/--timeout seconds] IDS
$ arxiv find [-i/--ids, -t/--timeout seconds] QUERY

The first two commands accept a list of arXiv ids and, respectively, download the corresponding PDFs or display their metadata in JSON format.

The third command runs a query against arXiv and prints the metadata in JSON format of the records that match. Adding the -i/--ids flag will return only their ids.

Adding the -t/--timeout seconds option will sleep for that amount of seconds between successive requests to the arXiv API.

Note that the previous commands can be chained, therefore running

$ arxiv download $(arxiv find --ids QUERY)

will download all papers that match QUERY, while

$ arxiv fetch $(arxiv find --ids QUERY)

will fetch all their metadata.


The previous CLI is built on top of a Python library that can be used on its own to query arXiv’s API. For example:

>>> from arxiv_cli import Client
>>> client = Client()

will achieve the same effect as

$ arxiv download IDS


Jacopo Notarstefano (@Jaconotar)



Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
arxiv-cli-0.1.6.tar.gz (4.5 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page