Altmetric allows altmetrics researchers to use its data for free, for noncommercial research purposes.
We kindly ask that all researchers who study our data attribute Altmetric in their presentation or publication Acknowledgements section.
Ways to access Altmetric’s data
We grant access to researchers for noncommercial research purposes. Terms of access are usually granted for 6 months. Researchers seeking access to Altmetric Explorer or high-volume Altmetric Details Page API access must apply to join the Altmetric Researcher Data Access Program by filling this form out.
Accessing data with the Altmetric Explorer
The Altmetric Explorer is a database that enables you to search and filter all of our data. You can run queries on Altmetric’s data in the Explorer in the following ways:
Journal name(s) or ISSN(s)
Output DOIs, PubMed IDs, Arxiv IDs, or other identifiers
Keyword search in output title
Publication date ranges
Mention dates (fixed to previous 24h, day, three days, month, three months, six months, one year)
Name of the outlet or social media user that has mentioned research
Search results or individual mentions can then be exported in CSV format.
Accessing data with the Altmetric API
The Altmetric Details Page API allows you to run queries based on:
Timeframe (i.e. see all outputs mentioned in the previous 24h, day, three days, month, three months, six months, or one year)
Output identifier (e.g. retrieve all metrics for mentions of a particular book by ISBN)
If you want to use the Altmetric Details Page API to pull metrics for all papers in a particular journal, or for all outputs written in a specific discipline, etc, your best approach is to use another service like Dimensions or Web of Science to create a list of outputs you’d like to retrieve data for. Then, you can write a script or use a wrapper (see Resources below) to programmatically call the Altmetric Details Page API for each output, using those outputs’ identifiers.
We rate limit free API requests, so if you are working without an API key, please limit your calls to no more than 1 per second. If you’d like to make faster API calls, please contact us to apply for the Altmetric Research Data Access Program.
If you’re interested in using Altmetric’s data to create institutional or departmental reports or dashboards, please contact us to inquire about access.