Using the Details Page API - Full Access
Altmetric Details Page API - Full Access includes the 'fetch' call, which provides more detailed information about the mentions, including URLs to the mentions themselves.
There are two exceptions to the "fetch" call: X, and certain news sources that fall under UK licensing restrictions. We're not able to display the full body of X posts or detailed information about individual posts or users - more information is available here. We're also not permitted to surface information related to certain news sources - more on why here.
For the full technical documentation - query parameters and the fields returned - see the Fetch endpoint documentation.
When should I use the Altmetric Details Page API - Full Access?
The Full Access API is optimized for specific queries about single research outputs. You'll need some programming knowledge to use it. Third-party wrappers exist in several languages, including PyAltmetric (Python), rAltmetric (R), and an equivalent for Ruby - these aren't maintained by Altmetric, so check each package's own repository for support.
Do I need an API key to access the Altmetric Details Page API?
You'll need an API key for all API endpoints you plan to use. If you're a scientometric researcher and would like a key for a specific project, learn more about how to get access here.
Before using our API data, please read our usage restrictions here.
