Comment on page
Publisher object
Here are the fields in a publisher object. When you use the API to get a single publisher or lists of publishers, this is what's returned.
List: A list of alternate titles for this publisher.
alternate_titles: [
"Elsevier",
"elsevier.com",
"Elsevier Science",
"Uitg. Elsevier",
"السفیر",
"السویر",
"انتشارات الزویر",
"لودویک السفیر",
"爱思唯尔"
]
Integer: The number of citations to works that are linked to this publisher through journals or other sources.
For example, if a publisher publishes 27 journals and those 27 journals have 3,050 works, this number is the sum of the cited_by_count values for all of those 3,050 works.
cited_by_count: 407508754
country_codes: ["DE"]
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 publisher, and how many times any work linked to this publisher 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
]
String: The date this
Publisher object was created in the OpenAlex dataset, expressed as an ISO 8601 date string.created_date: "2017-08-08"
String: The primary name of the publisher.
display_name: "Elsevier BV"
Integer: The hierarchy level for this publisher. A publisher with hierarchy level 0 has no parent publishers. A hierarchy level 1 publisher has one parent above it, and so on.
hierarchy_level: 1
String: The OpenAlex ID for this publisher.
id: "https://openalex.org/P4310320990"
Object: All the external identifiers that we know about for this publisher. IDs are expressed as URIs whenever possible. Possible ID types:
rorString: this publisher's ROR ID
ids: {
openalex: "https://openalex.org/P4310320990",
ror: "https://ror.org/02scfj030",
wikidata: "https://www.wikidata.org/entity/Q746413"
},
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/MIT%20Press%20logo.svg&width=300"
String: URL where you can get an image representing this publisher. 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/MIT%20Press%20logo.svg"
List: OpenAlex IDs of publishers. The list will include this publisher's ID, as well as any parent publishers. If this publisher's
hierarchy_level is 0, this list will only contain its own ID.id: "https://openalex.org/P4310321285",
...
hierarchy_level: 2,
lineage: [
"https://openalex.org/P4310321285",
"https://openalex.org/P4310319900",
"https://openalex.org/P4310319965"
]
String: An OpenAlex ID linking to the direct parent of the publisher. This will be null if the publisher's
hierarchy_level is 0.parent_publisher: "https://openalex.org/P4310311775"
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,
}
]
String: An URL that will get you a list of all the sources published by this publisher.
We express this as an API URL (instead of just listing the sources themselves) because there might be thousands of sources linked to a publisher, and that's too many to fit here.
sources_api_url: "https://api.openalex.org/sources?filter=host_organization.id:P4310319965"
Object: Citation metrics for this publisher
2yr_mean_citednessFloat: 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).
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 publishers.
summary_stats: {
2yr_mean_citedness: 5.065784263815827,
h_index: 985,
i10_index: 176682
}
String: The last time anything in this publisher 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: "2021-12-25T14:04:30.578837"
Integer: The number of works published by this publisher.
works_count: 13789818
Last modified 22d ago