PubMed Central is a free full-text archive of biomedical and life sciences journal literature at the U.S. National Institutes of Health's National Library of Medicine. PubMed Central usage stats are available to publishers of these journal articles. The usage stats are available as individual XML files for a given journal, month and year.
Required configuration fields
- DB url: local CouchDB database to store usage stats, e.g.
http://localhost:5984/pmc/
- Feed url: PubMed Central URL to fetch monthly article stats, defaults to http://www.pubmedcentral.nih.gov/utils/publisher/pmcstat/pmcstat.cgi?year=%{year}&month=%{month}&jrid=%{journal}&user=%{username}&password=%{password}`.
- Events url: PubMed Central URL for further information about article, defaults to
http://www.ncbi.nlm.nih.gov/pmc/articles/PMC%{pmcid}
. - Journals: List of journals for which we need usage stats, using PMC names and separated by space, e.g.
plosbiol plosmed ploscomp
. - Username: PMC user account that has permissions to download usage stats
- Password: Password for that PMC user account
The rake task rake pmc:update
fetches the usage stats XML file, parses it, and stores the information as JSON for every article in CouchDB. The pmc source therefore only needs to be updated once a month.
When installing the source, the CouchDB database for PMC has to be created with curl -X PUT database_url
, where database_url
is the URL stored in the configuration.
ALM Name | pmc |
ALM Configuration | default |
ALM Core Attributes | id (as doi, pmid and pmcid) | ALM Other Attributes | none |
Protocol | HTTP |
Format | XML |
Rate-limiting | unknown |
Authentication | yes |
Restriction by IP Address | no |
API URL | http://www.pubmedcentral.nih.gov/utils/publisher/pmcstat/pmcstat.cgi?year=YEAR&month=MONTH&jrid=JOURNAL&user=USERNAME&password=PASSWORD |
Example (excerpt)
<pmc-web-stat>
<request year="2013" month="10" jrid="plosbiol" issn="1544-9173" eissn="1545-7885"></request>
<response status="0" collection="PLoS Biol"></response>
<articles>
<article id="PMC1043859">
<meta-data doi="10.1371/journal.pbio.0030060" pmcid="PMC1043859" pubmed-id="15736975" pub-year="2005" volume="3" issue="4" first-page="e60"/>
<usage unique-ip="3" full-text="1" pdf="1" abstract="0" scanned-summary="0" scanned-page-browse="0" figure="4" supp-data="0" cited-by="0"/>
</article>
<article id="PMC1043860">
<meta-data doi="10.1371/journal.pbio.0030085" pmcid="PMC1043860" pubmed-id="15723116" pub-year="2005" volume="3" issue="3" first-page="e85"/>
<usage unique-ip="118" full-text="128" pdf="90" abstract="2" scanned-summary="0" scanned-page-browse="0" figure="13" supp-data="0" cited-by="1"/>
</article>
<article id="PMC1043861">
<meta-data doi="10.1371/journal.pbio.0030114" pmcid="PMC1043861" pubmed-id="0" pub-year="2005" volume="3" issue="3" first-page="e114"/>
<usage unique-ip="4" full-text="4" pdf="0" abstract="0" scanned-summary="0" scanned-page-browse="0" figure="0" supp-data="0" cited-by="0"/>
</article>
<article id="PMC1043862">
<meta-data doi="10.1371/journal.pbio.0030122" pmcid="PMC1043862" pubmed-id="15736988" pub-year="2005" volume="3" issue="4" first-page="e122"/>
<usage unique-ip="1" full-text="1" pdf="1" abstract="0" scanned-summary="0" scanned-page-browse="0" figure="0" supp-data="0" cited-by="0"/>
</article>
<article id="PMC1044830">
<meta-data doi="10.1371/journal.pbio.0030063" pmcid="PMC1044830" pubmed-id="15736976" pub-year="2005" volume="3" issue="3" first-page="e63"/>
<usage unique-ip="29" full-text="25" pdf="6" abstract="7" scanned-summary="0" scanned-page-browse="0" figure="0" supp-data="0" cited-by="0"/>
</article>
<article id="PMC1044831">
<meta-data doi="10.1371/journal.pbio.0030064" pmcid="PMC1044831" pubmed-id="15736977" pub-year="2005" volume="3" issue="3" first-page="e64"/>
<usage unique-ip="10" full-text="10" pdf="2" abstract="0" scanned-summary="0" scanned-page-browse="0" figure="0" supp-data="0" cited-by="0"/>
</article>
<article id="PMC1044832">
<meta-data doi="10.1371/journal.pbio.0030071" pmcid="PMC1044832" pubmed-id="15736978" pub-year="2005" volume="3" issue="3" first-page="e71"/>
<usage unique-ip="8" full-text="10" pdf="1" abstract="0" scanned-summary="0" scanned-page-browse="0" figure="0" supp-data="0" cited-by="0"/>
</article>
</articles>
</pmc-web-stat>
Source Code
The source code is available here.