What is the Altmetric Details Page API?
The Altmetric Details Page API is the API that powers the Altmetric details pages and the Altmetric badges. The Details Page API allows users to see the information from the Details Pages and the badges in a machine readable way. The Altmetric Details Page API has two tiers: Counts Only and Full Access.
Who can use the Altmetric Details Page API?
The Altmetric Details Page API is available free of charge for scientometric researchers, for more information about access please visit our Researcher Data Access page. For any other uses or projects using the Altmetric Details Page API please contact us.
Altmetric Details Page API - Counts Only
The Altmetric Details Page API - Counts Only provides information about individual research outputs. For example, you can query the Altmetric API by a DOI and retrieve the relevant Altmetric data. The below table lists some of the fields that are returned by the Altmetric Details Page API - Counts Only when queried. A full list of the fields returned is available here.
Fields returned in the main call
Title of the publication
Related Pubmed identifier
Related Pubmed Central identifier
URL for a captured identifier (e.g doi.org/xxx)
Internal identifier for a journal
ISSNs associated with the publication
Journal title associated with the publication
When should I use the Altmetric Details Page API - Counts Only?
The Altmetric Details Page API - Counts Only is optimized for querying for a single identifier or strictly defined search. You can see the output of the Altmetric Details Page API - Counts Only API in a browser by adding an identifier to the URL.
Altmetric Details Page API - Full Access
Altmetric Details Page API - Full Access includes the 'fetch' call (http://api.altmetric.com/docs/call_fetch.html) which provides more detailed information about the mentions.
The ‘fetch’ calls allows users to see full details of the mentions, including the URLs to the mentions themselves.
There are two exceptions with the “fetch” call, Twitter and certain news sources that fall under UK licensing restrictions. Unfortunately, due to licensing restrictions, we are not allowed to display the full body mentions of tweets and detailed information about individual tweets or tweeters — more information is available here. Additionally, we are not permitted to surface information related to certain news sources. More information about why we can’t display some news mentions is available here.
For more information about our API, query parameters you can use, and the fields it returns please visit this page to see our technical documentation.
When should I use the Altmetric Details Page API - Full Access?
The Altmetric Details Page API - Full Access is optimized for specific queries about single research outputs. To use the Full Access version of the Details Page API you will need some programming knowledge. There are various “wrappers” in different languages (e.g Python, Ruby) available on Github or you can choose to write your own software.
Do I need an API key to access the Altmetric Details Page API?
We strongly recommend using an API key, though you don’t need one to access the Altmetric Details Page API - Counts Only. Having an API key would remove the rate limits for your Altmetric Details Page - Counts Only queries.
You do need an API key for the Full Access API, as it includes the /fetch/ call.
If you’d like an API key please email firstname.lastname@example.org and we can review your use case for free access under our Researcher Data Access Program.
What are the usage restrictions associated with Altmetric data?
- Altmetric data can be made free for scientometric researchers. Please contact us to apply for our Researcher Data Access Program.
- Commercial projects must adhere to third party licensing restrictions contained in their contracts.
- Do not redistribute the data in bulk.
- If you are using Twitter data, please ensure that you are compliant with Twitter's Developer Policy and Twitter's Terms of Service.
How do I provide attribution to Altmetric data?
If you use the Altmetric Details Page API please attribute us prominently on the page where the data is displayed, guidelines for data attribution are available here. Our official branding guidelines include more information on how to credit us appropriately.