pyaltmetric

Python Altmetric API v1 wrapper

License: MIT License

Author: Will Earp

Altmetric, altmetric, altmetrics, api, wrapper

Classifiers

Development Status: 5 - Production/Stable
Intended Audience: Developers
License: OSI Approved :: MIT License
Natural Language: English
Operating System: OS Independent
Programming Language: Python
Topic: Software Development :: Libraries :: Python Modules

Project Description

pyAltmetric is a python wrapper for Altmetric API v1. It provides an API for downloading and reading citations both individually and in bulk.

Installation

pip install pyaltmetric

Usage

Fetching by individual citations by identifiers:

from pyaltmetric import Altmetric

a = Altmetric()

a.id("241939")
a.doi("10.1038/news.2011.490")
a.pmid("21148220")
a.rxiv("1108.2455")
a.ads("2012apphl.100y3104b")

a = Altmetric("api_key_goes_here")

Querying the Altmetric.com database:

a.citations("1w", page=1, nlmid="0410462")

Reading a citation:

>>> from pyaltmetric import Altmetric, Citation
>>>
>>> b = a.id("241939")
>>> c = Citation(b)
>>> print c.title
u'Rebuilding Global Fisheries'
>>>
>>> c   # provides a snapshot of a citation's coverage across platforms.
Altmetrics on: "Rebuilding Global Fisheries" with doi 10.1126/science.1173146
published in Science.

All Posts      14
Tweets          6
Facebook        1
Google+         0
Reddit          0
Blogs           2

>>>