API

/api/pubs

List publications, including data about each one.

Optional query parameters:

/api/pubs/{pmid}

Get data on a specific publication. Example: /api/pubs/23456789

/api/pubs?pmids={pmid1,pmid2...}

Get data on multiple specific publications.
Example: /api/pubs?pmids=23456789,27599104
Example: /api/pubs?pmids=23456789,27599104

Code Examples

Get the data for a specific PMID by visiting /api/pubs/23456789:

Response
{
    pmid:	                23456789
    year:	                2013
    title:	                "Hospital volume is associated with survival but not multimodality therapy in Medicare patients with advanced head and neck cancer."
    authors:                    "Arun Sharma, Stephen M Schwartz, Eduardo Méndez"
    journal:	                "Cancer"
    is_research_article:	"Yes"
    relative_citation_ratio:    1.73
    nih_percentile:	        70.3
    human:	                1
    animal: 	                0
    molecular_cellular:	        0
    apt:	                0.75
    is_clinical:	        "No"
    citation_count:	        26
    citations_per_year:	        4.33333333333333
    expected_citations_per_year:2.50953735885351
    field_citation_rate:	4.87055203724375
    provisional:	        "No"
    x_coord:	                0
    y_coord:	                1
    cited_by_clin:              []
    cited_by:	                […]
    references:	                […]
    doi:	                "10.1002/cncr.27976"
}
R
# If iCiteR is not installed,
# install it with: install.packages("iCiteR")

library(iCiteR)
papers = get_metrics(c(23456789,27599104))
print(papers)








        
Python
import requests


response = requests.get(
    "/".join([
        "https://icite.od.nih.gov/api",
        "pubs",
        "23456789",
    ]),
)
pub = response.json()
print(pub)


        
JavaScript
var request = new XMLHttpRequest();
request.open(
    "GET",
    [
        "https://icite.od.nih.gov/api",
        "pubs",
        "23456789",
    ].join("/")
);
request.responseType = "json";
request.onload = function () {
    console.log(request.response);
};
request.send();
        

Content Type

By default, responses are JSON. CSV responses are supported as well and can be requested via Accept: text/csv.

Feedback

Please send any feedback to iCite@mail.nih.gov.