Struct Publisher 

pub struct Publisher {

    pub id: String,
    pub display_name: Option<String>,
    pub alternate_titles: Option<Vec<String>>,
    pub hierarchy_level: Option<i32>,
    pub parent_publisher: Option<Value>,
    pub lineage: Option<Vec<Value>>,
    pub country_codes: Option<Vec<String>>,
    pub homepage_url: Option<String>,
    pub image_url: Option<String>,
    pub image_thumbnail_url: Option<String>,
    pub works_count: Option<i64>,
    pub cited_by_count: Option<i64>,
    pub summary_stats: Option<SummaryStats>,
    pub ids: Option<PublisherIds>,
    pub counts_by_year: Option<Vec<CountsByYear>>,
    pub roles: Option<Vec<Role>>,
    pub sources_api_url: Option<String>,
    pub updated_date: Option<String>,
    pub created_date: Option<String>,
}

A publishing organization (e.g. Elsevier, Springer Nature, Wiley).

Includes parent/child hierarchy, country of origin, linked sources, and citation metrics. Some publishers also act as funders or institutions (see roles).

Example

{
  "id": "https://openalex.org/P4310319965",
  "display_name": "Springer Nature",
  "hierarchy_level": 0,
  "country_codes": ["DE"],
  "works_count": 2750825,
  "cited_by_count": 75000000,
  "summary_stats": {"2yr_mean_citedness": 5.1, "h_index": 1500, ...}
}

ID formats

Publishers can only be retrieved by OpenAlex ID (P...).

Fields

id: String

OpenAlex ID URI (e.g. "https://openalex.org/P4310319965").

display_name: Option<String>

Human-readable publisher name (e.g. "Springer Nature").

alternate_titles: Option<Vec<String>>

Alternative names or name variants.

hierarchy_level: Option<i32>

Level in the publisher hierarchy. 0 = top-level publisher, 1 = subsidiary, etc.

parent_publisher: Option<Value>

Parent publisher (if this is a subsidiary). Structure varies — may be a string ID or an object.

lineage: Option<Vec<Value>>

Publisher lineage from this publisher up to the top-level parent. Elements may be string IDs or objects.

country_codes: Option<Vec<String>>

ISO 3166-1 alpha-2 country codes of the publisher’s country/countries of origin.

homepage_url: Option<String>

URL of the publisher’s homepage.

image_url: Option<String>

URL of the publisher’s logo or image.

image_thumbnail_url: Option<String>

URL of a thumbnail version of the publisher’s image.

works_count: Option<i64>

Total number of works published by this publisher.

cited_by_count: Option<i64>

Total number of citations received by works from this publisher.

summary_stats: Option<SummaryStats>

Impact metrics: h-index, i10-index, and 2-year mean citedness.

ids: Option<PublisherIds>

External identifiers (OpenAlex, ROR, Wikidata).

counts_by_year: Option<Vec<CountsByYear>>

Publication and citation counts broken down by year.

roles: Option<Vec<Role>>

Roles this organization plays in the research ecosystem (institution, funder, publisher).

sources_api_url: Option<String>

API URL to retrieve sources published by this publisher.

updated_date: Option<String>

ISO 8601 timestamp of the last update to this record.

created_date: Option<String>

ISO 8601 date when this record was first created.

Trait Implementations

impl Clone for Publisher

fn clone(&self) -> Publisher

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Publisher

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Publisher

fn deserialize<__D>( __deserializer: __D, ) -> Result<Publisher, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Publisher> for PublisherSummary

fn from(p: Publisher) -> Self

Converts to this type from the input type.

impl Serialize for Publisher

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.