A Python client for the SAO/NASA Astrophysics Data System

A fast command line tool

Query for references or documents at lightening speed from a terminal.

Asynchronous coroutines for faster queries

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

Update remote ADS libraries with ease

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

Make sophisticated metrics queries

New querying tools for building complex metrics queries and visualizations.

Lots more…

There are a lot of new changes in version 1.0 of the ads module. See what’s new.


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



ads is a Python package for interacting with the Astrophysics Data System (ADS), a digital library portal for researchers in astronomy and physics, operated by the Smithsonian Astrophysical Observatory (SAO) under a NASA grant.


Basic examples

You can search by keywords for documents on ADS.

import ads

for document in ads.SearchQuery(q="stellar astrophysics"):
import ads

def main():
   async for document in ads.SearchQuery(q="stellar astrophysics"):



  • Search by author

  • Search by year

  • Search by affiliation

Command line tool

TODO: make a gif