Bulk Data

Bulk data can be accessed at the iCite database snapshot repository.

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.


How to Post

It is possible to post from another site or application to iCite using an HTML form. The javascript code below demonstrates one way to do that. The example function will initiate an iCite query with the supplied PubMed IDs. Acceptable formats: a space, comma, or semi-colon delimited list of IDs. It is important that the name of the text input or area be set to 'pmid_text'.

Code Example

Javascript
    function postToiCite(pmidText) {
        let form = document.createElement("form");
        let textArea = document.createElement("textarea");
        form.action = "https://icite.od.nih.gov/analysis";
        # Optional
        form.target= "_blank";
        form.method = "post";
        textArea.name = "pmid_text";
        textArea.innerHTML = pmidText;
        form.appendChild(textArea);
        form.style.display = "none";
        document.body.appendChild(form);
        form.submit();
    }