Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Developer API service description and example client code
Branch: master
Failed to load latest commit information.
.gitignore README: andycasey/ads -> adsabs/ads export: stub out export docs metrics: remove outdated info search: remove bigquery


ADS Developer API description.

For bugs, feature requests or even random questions feel free to use the issues section.

Table of Contents

Mailing List

Announcements and discussion related to the Developer API are available via the Google Group, adsabs-dev-api. We encourage all API users to subscribe, as the functionality of the API, will likely be improving and changing rapidly.


The unofficial python client for the API can be found here:

(Note that this is a temporary fork of andycasey's client; please install from the git repo and not pypi if you use this fork)


Access to the ADS data holdings is regulated by the the ADS terms of use, as described in the ADS Terms of Use.

To obtain access to the ADS Developer API you must do two things:

  1. Create an account and log in to the latest version of the ADS.
  2. Push the "Generate a new key" button under the user profile

All API requests must pass your token in an Authorization: Bearer <token> HTTP header.

Access Settings

Each endpoint is individually rate-limited. API Responses advertise these limits in their response headers:

X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
X-RateLimit-Reset: 1435190400

To increase rate limits, please contact us directly at

Something went wrong with that request. Please try again.