Skip to content

HTTPS clone URL

Subversion checkout URL

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

README.md

adsabs-dev-api

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.

Clients

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

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 adshelp@cfa.harvard.edu.

Something went wrong with that request. Please try again.