A Python client for the SAO/NASA Astrophysics Data System

Use object relational mappers for complex, easy-to-read queries

New data models for building programmatic queries.

New ways to search

Search by author email, journal title, country of affiliation, and more.

Asynchronous queries for faster results

Use asynchronous coroutines for blazingly fast queries, or make synchronous queries with improved pagination behaviour.

Libraries and notifications

Use a Pythonic API to create, update, and delete remote libraries or myADS notifications.

And much more…

There’s a lot of changes in version 1 of the ads module. Read this to find out why.


Version 1.0 of ads is only compatible with Python 3. If you haven’t upgraded from Python 2, the time to upgrade was two years ago.


ads is a community-built Python package for interacting with the Astrophysics Data System (ADS). ADS is a digital library portal for researchers in astronomy and physics, which is operated by the Smithsonian Astrophysical Observatory (SAO) under a NASA grant. The SAO/NASA ADS logo shown above is authored and owned by SAO/NASA ADS, and is displayed under a Creative Commons License with Attribution.