Sentiment Analysis in the Details Page API

Sentiment Analysis data for social media mentions (from X and Bluesky) is available in the Altmetric Details Page API.

The Details Page API already gives you programmatic access to mention counts and full text of mentions for individual research outputs. The addition of Sentiment Analysis data means you can now also retrieve sentiment scores alongside those mentions, making it easier to perform in-depth offline analysis of how your research is being received and to integrate sentiment insights into your own reports and presentations.

Sentiment scores range from strongly negative (-3) to strongly positive (+3). For a full breakdown of what each score means, see Sentiment Analysis in Altmetric.

How to access it

Sentiment Analysis data is available via the Fetch endpoint of the Details Page API. Full technical documentation, including the response fields, is available here.

Please note: the Fetch endpoint requires a Full Access API key.

Altmetric customers with an existing Full Access subscription can start using Sentiment Analysis data immediately, or request additional API keys included in their contract via the Support team contact form.

Organizations without an existing subscription can enquire about access via the Details Page API product page (select "My organization does not have a subscription" at the bottom of the page).