Funder object

These are the fields in a funder object. When you use the API to get a single funder or lists of funders, this is what's returned.

alternate_titles

List: A list of alternate titles for this funder.

alternate_titles: [
  "US National Institutes of Health",
  "Institutos Nacionales de la Salud",
  "NIH"
]

cited_by_count

Integer: The total number Works that cite a work linked to this funder.

cited_by_count: 7823467

country_code

String: The country where this funder is located, represented as an ISO two-letter country code.

country_code: "US"

counts_by_year

List: The values of works_count and cited_by_count for each of the last ten years, binned by year. To put it another way: for every listed year, you can see how many new works are linked to this funder, and how many times any work linked to this funder was cited.

Years with zero citations and zero works have been removed so you will need to add those back in if you need them.

counts_by_year: [
    {
        year: 2021,
        works_count: 4211,
        cited_by_count: 120939
    },
    {
        year: 2020,
        works_count: 4363,
        cited_by_count: 119531
    },
    
    // and so forth
]

created_date

String: The date this Funder object was created in the OpenAlex dataset, expressed as an ISO 8601 date string.

created_date: "2023-02-13"

description

String: A short description of this funder, taken from Wikidata.

description: "medical research organization in the United States"

display_name

String: The primary name of the funder.

display_name: "National Institutes of Health"

grants_count

Integer: The number of grants linked to this funder.

grants_count: 7109

homepage_url

String: The URL for this funder's primary homepage.

homepage_url: "http://www.nih.gov/"

id

String: The OpenAlex ID for this funder.

id: "https://openalex.org/F4320332161"

ids

Object: All the external identifiers that we know about for this funder. IDs are expressed as URIs whenever possible. Possible ID types:

• crossref String: this funder's Crossref ID

• doi String: this funder's DOI

• openalex String: this funder's OpenAlex ID

• ror String: this funder's ROR ID

• wikidata String: this funder's Wikidata ID

ids: {
    openalex: "https://openalex.org/F4320332161",
    ror: "https://ror.org/01cwqze88",
    wikidata: "https://www.wikidata.org/entity/Q390551",
    crossref: "100000002",
    doi: "https://doi.org/10.13039/100000002"
}

image_thumbnail_url

String: Same as image_url, but it's a smaller image.

This is usually a hotlink to a wikimedia image. You can change the width=300 parameter in the URL if you want a different thumbnail size.

image_thumbnail_url: "https://commons.wikimedia.org/w/index.php?title=Special:Redirect/file/NIH 2013 logo vertical.svg&width=300"

image_url

String: URL where you can get an image representing this funder. Usually this a hotlink to a Wikimedia image, and usually it's a seal or logo.

image_url: "https://commons.wikimedia.org/w/index.php?title=Special:Redirect/file/NIH 2013 logo vertical.svg"

roles

List: List of role objects, which include the role (one of institution, funder, or publisher), the id (OpenAlex ID), and the works_count.

In many cases, a single organization does not fit neatly into one role. For example, Yale University is a single organization that is a research university, funds research studies, and publishes an academic journal. The roles property links the OpenAlex entities together for a single organization, and includes counts for the works associated with each role.

The roles list of an entity (Funder, Publisher, or Institution) always includes itself. In the case where an organization only has one role, the roles will be a list of length one, with itself as the only item.

roles: [
    {
        role: "funder",
        id: "https://openalex.org/F4320308380",
        works_count: 1004,
    },
    {
        role: "publisher",
        id: "https://openalex.org/P4310315589",
        works_count: 13986,
    },
    {
        role: "institution",
        id: "https://openalex.org/I32971472",
        works_count: 250031,
    }
]

summary_stats

Object: Citation metrics for this funder

• 2yr_mean_citedness Float: The 2-year mean citedness for this source. Also known as impact factor. We use the year prior to the current year for the citations (the numerator) and the two years prior to that for the citation-receiving publications (the denominator).

• h_index Integer: The h-index for this funder.

• i10_index Integer: The i-10 index for this funder.

While the h-index and the i-10 index are normally author-level metrics and the 2-year mean citedness is normally a journal-level metric, they can be calculated for any set of papers, so we include them for funders.

summary_stats: {
    2yr_mean_citedness: 5.065784263815827,
    h_index: 985,
    i10_index: 176682
}

updated_date

String: The last time anything in this funder object changed, expressed as an ISO 8601 date string. This date is updated for any change at all, including increases in various counts.

updated_date: "2023-04-21T16:54:19.012138"

works_count

Integer: The number of works linked to this funder.

works_count: 260210