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.

Files for arxiv-cli, version 0.1.6
Filename, size File type Python version Upload date Hashes
Filename, size arxiv-cli-0.1.6.tar.gz (4.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page