Skip to main content

Altmetric

Altmetric is a Python wrapper for Altmetric API v1 <http://api.altmetric.com/>.

Installation

pip install altmetric

Usage

Fetching details by identifiers

from altmetric import Altmetric
a = Altmetric()
a.id("108989")
a.doi("10.1126/science.1173146")
a.ads("2009sci...325..578w")
a.arxiv("1212.4819")
a.pmid("19644114")


a = Altmetric("you_api_key")
a.fetch("doi","10.1126/science.1173146")

Querying the database

::

from altmetric import Altmetric a = Altmetric() a.citations(‘1d’) a.citations(‘1d’, page=2)

Catching Errors

from altmetric import Altmetric
a = Altmetric()
try:
    rsp = a.doi("10.1234/foo")
    if rsp is None:
        print "DOI not found"
    else:
        print rsp['altmetric_id']
except AltmetricHTTPException, e:
    if e.status_code == 403:
        print "You aren't authorized for this call"
    elif e.status_code == 420:
        print "You are being rate limited"
    elif e.status_code == 502:
        print "The API version you are using is currently down for maintenance."
    elif e.status_code == 404:
        print "Invalid API function"
        print e.msg

API Reference

Please see http://api.altmetric.com/ for detailed reference on response object and parameters.

Release files for altmetric 1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for altmetric 1.0
File Size Uploaded
altmetric-1.0.tar.gz 3.4 kB Details

Release files / altmetric-1.0.tar.gz

Download URL altmetric-1.0.tar.gz
Size 3.4 kB
Tags Source
SHA-256 checksum
How to use checksums
a0326573b769a15220ee9b84297370aabecf7235f2af05c0801a83d2f455870c
BLAKE2b-256 checksum
How to use checksums
9318f69e9ab28e286a4882b06e578821b621683ba9c0675e45f281dd5a179b4f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

1.0 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page