> ## Documentation Index
> Fetch the complete documentation index at: https://hexagraph-docs.voyla.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Publisher

> Retrieve detailed metadata for a single publishing organization by its HX_P identifier.

Retrieves a single publishing organization (commercial publisher, university press, or society publisher) by its `HX_P` identifier.

### Path Parameters

<ParamField path="id" type="string" required>
  Unique publisher identifier (e.g. `HX_P4310319965`). Must be prefixed with `HX_P`.
</ParamField>

### Response Fields

<ResponseField name="id" type="string" required>
  Unique publisher identifier prefixed with `HX_P` (e.g. `HX_P4310320990`).
</ResponseField>

<ResponseField name="name" type="string" required>
  Publisher display name (e.g. `"Elsevier BV"`).
</ResponseField>

<ResponseField name="alternate_titles" type="array">
  Alternative publisher titles array.
</ResponseField>

<ResponseField name="hierarchy_level" type="integer">
  Hierarchy depth (`0` for top-level publisher group).
</ResponseField>

<ResponseField name="parent_publisher" type="object">
  Parent publishing group object.
</ResponseField>

<ResponseField name="countries" type="array">
  Countries array.

  <Expandable title="countries attributes">
    <ResponseField name="code" type="string">ISO country code (e.g. `"NL"`).</ResponseField>
    <ResponseField name="name" type="string">Country display name.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="homepage_url" type="string">
  Official homepage URL.
</ResponseField>

<ResponseField name="image_url" type="string">
  Publisher logo image URL.
</ResponseField>

<ResponseField name="image_thumbnail_url" type="string">
  Publisher logo thumbnail URL.
</ResponseField>

<ResponseField name="outputs_count" type="integer">
  Total number of indexed outputs published by this organization.
</ResponseField>

<ResponseField name="cited_by_count" type="integer">
  Total citation count received across all published outputs.
</ResponseField>

<ResponseField name="summary_stats" type="object">
  Aggregated impact metrics.

  <Expandable title="summary_stats attributes">
    <ResponseField name="2yr_mean_citedness" type="number">Two-year mean citation rate.</ResponseField>
    <ResponseField name="h_index" type="integer">Calculated h-index score.</ResponseField>
    <ResponseField name="i10_index" type="integer">Calculated i10-index score.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="ids" type="object">
  External identifiers mapping.

  <Expandable title="ids attributes">
    <ResponseField name="ror" type="string">ROR identifier URL.</ResponseField>
    <ResponseField name="wikidata" type="string">Wikidata entity URL.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="counts_by_year" type="array">
  Outputs, OA outputs, and citations grouped by year.

  <Expandable title="counts_by_year attributes">
    <ResponseField name="year" type="integer">Year number.</ResponseField>
    <ResponseField name="outputs_count" type="integer">Outputs published in year.</ResponseField>
    <ResponseField name="oa_outputs_count" type="integer">Open Access outputs published in year.</ResponseField>
    <ResponseField name="cited_by_count" type="integer">Citations received in year.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="roles" type="array">
  Entity roles array.

  <Expandable title="roles attributes">
    <ResponseField name="role" type="string">Role type (`funder`, `institution`, `publisher`).</ResponseField>
    <ResponseField name="id" type="string">Entity ID.</ResponseField>
    <ResponseField name="outputs_count" type="integer">Outputs count for role.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="updated_date" type="string">
  ISO last updated timestamp.
</ResponseField>

<ResponseField name="created_date" type="string">
  ISO creation date timestamp.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.hexagraph.in/publishers/HX_P4310320990"
  ```

  ```javascript JavaScript theme={null}
  fetch("https://api.hexagraph.in/publishers/HX_P4310320990")
    .then(response => response.json())
    .then(data => console.log(data));
  ```

  ```python Python theme={null}
  import requests

  response = requests.get("https://api.hexagraph.in/publishers/HX_P4310320990")
  print(response.json())
  ```

  ```go Go theme={null}
  package main

  import (
  	"fmt"
  	"io"
  	"net/http"
  )

  func main() {
  	resp, err := http.Get("https://api.hexagraph.in/publishers/HX_P4310320990")
  	if err != nil {
  		fmt.Println("Error:", err)
  		return
  	}
  	defer resp.Body.Close()
  	body, _ := io.ReadAll(resp.Body)
  	fmt.Println(string(body))
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "HX_P4310320990",
    "name": "Elsevier BV",
    "alternate_titles": [
      "Elsevier",
      "elsevier.com",
      "Elsevier Science",
      "Uitg. Elsevier",
      "السفير",
      "السوير",
      "انتشارات الزویر",
      "لودویک السفیر",
      "爱思唯尔"
    ],
    "hierarchy_level": 0,
    "parent_publisher": null,
    "countries": [
      {
        "code": "NL",
        "name": null
      }
    ],
    "homepage_url": "https://www.relx.com",
    "image_url": "https://commons.wikimedia.org/w/index.php?title=Special:Redirect/file/Elsevier.svg",
    "image_thumbnail_url": "https://commons.wikimedia.org/w/index.php?title=Special:Redirect/file/Elsevier.svg&width=300",
    "outputs_count": 24185686,
    "cited_by_count": 646480324,
    "summary_stats": {
      "2yr_mean_citedness": 4.319272176423483,
      "h_index": 2891,
      "i10_index": 10413621
    },
    "ids": {
      "ror": "https://ror.org/02scfj030",
      "wikidata": "https://www.wikidata.org/entity/Q746413"
    },
    "counts_by_year": [
      {
        "year": 2026,
        "outputs_count": 661865,
        "oa_outputs_count": 0,
        "cited_by_count": 206628
      },
      {
        "year": 2025,
        "outputs_count": 1108363,
        "oa_outputs_count": 0,
        "cited_by_count": 3367431
      },
      {
        "year": 2024,
        "outputs_count": 1019513,
        "oa_outputs_count": 0,
        "cited_by_count": 8475596
      }
    ],
    "roles": [
      {
        "role": "funder",
        "id": "HX_F4320308305",
        "outputs_count": 162
      },
      {
        "role": "institution",
        "id": "HX_I1318003438",
        "outputs_count": 7800
      },
      {
        "role": "institution",
        "id": "HX_I4210160603",
        "outputs_count": 652
      },
      {
        "role": "publisher",
        "id": "HX_P4310320990",
        "outputs_count": 24185686
      }
    ],
    "updated_date": "2026-08-05T04:01:49",
    "created_date": "2023-01-01T00:00:00"
  }
  ```

  ```json 400 Bad Request theme={null}
  {
    "statusCode": 400,
    "message": "Only HX_ prefixed IDs are allowed",
    "error": "Bad Request"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "statusCode": 404,
    "message": "Publisher with ID HX_P9999999999 not found",
    "error": "Not Found"
  }
  ```

  ```json 429 Too Many Requests theme={null}
  {
    "statusCode": 429,
    "error": "Too Many Requests",
    "message": "IP rate limit exceeded (max 30 requests per minute). Please try again in 42 seconds (at 11:40:32 UTC).",
    "reset_in_seconds": 42,
    "reset_at_utc": "2026-08-05T11:40:32.000Z"
  }
  ```
</ResponseExample>
