Skip to content

Developer API service description and example client code

Notifications You must be signed in to change notification settings

ehenneken/adsabs-dev-api

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

58 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 is maintained by Andy Casey and can be found here:

Geert Barentsen has built an application to support the Kepler publication database which uses the ADS API to discover relevant papers:

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 (where is the key you just generated), e.g.

curl -H 'Authorization: Bearer <token>' 'https://api.adsabs.harvard.edu/v1/search/query?q=star'

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.

About

Developer API service description and example client code

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published