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.

alternate_titles

List: A list of alternate titles for this publisher.

alternate_titles: [
  "Elsevier",
  "elsevier.com",
  "Elsevier Science",
  "Uitg. Elsevier",
"السفیر",  
"السویر",  
"انتشارات الزویر",  
"لودویک السفیر",  
  "爱思唯尔"
]

cited_by_count

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

List: The countries where the publisher is primarily located, as an ISO two-letter country code.

country_codes: ["DE"]

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 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
]

created_date

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

created_date: "2017-08-08"

display_name

String: The primary name of the publisher.

display_name: "Elsevier BV"

hierarchy_level

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

id

String: The OpenAlex ID for this publisher.

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

ids

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

• openalex String: this publishers's OpenAlex ID

• ror String: this publisher's ROR ID

• wikidata String: this publisher's Wikidata ID

ids: {
  openalex: "https://openalex.org/P4310320990",
  ror: "https://ror.org/02scfj030",
  wikidata: "https://www.wikidata.org/entity/Q746413"
},

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/MIT%20Press%20logo.svg&width=300"

image_url

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"

lineage

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"
]

parent_publisher

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"

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,
    }
]

sources_api_url

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"

summary_stats

Object: Citation metrics for this publisher

• 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 publisher.

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

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
}

updated_date

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"

works_count

Integer: The number of works published by this publisher.

works_count: 13789818