> ## 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.
# List publishers
> Query and list publishing organizations with filtering, sorting, and pagination.
Retrieves a paginated list of publishers with filtering and sorting capabilities.
### Query Parameters
Page number for pagination. Default is `1`.
Results per page. Allowed values: `10`, `25`, `50`, `100`.
Filter expression (e.g. `country_code:NL`).
Sorting parameter (e.g. `outputs_count:desc`, `cited_by_count:desc`).
### Response Fields
Pagination metadata.
Total matching records count.
Current page number.
Items per page.
Array of publisher records.
Publisher ID (`HX_P...`).
Publisher display name.
Alternative titles array.
Hierarchy depth level.
Parent publisher metadata.
Countries array.
ISO country code (e.g. `"NL"`).
Country display name.
Homepage URL.
Image logo URL.
Thumbnail logo URL.
Outputs count.
Citations count.
Aggregated impact metrics.
Two-year mean citation rate.
Calculated h-index score.
Calculated i10-index score.
External identifiers mapping.
ROR URL.
Wikidata entity URL.
Yearly outputs and citations breakdown.
Year number.
Outputs count in year.
Open Access outputs count in year.
Citations count in year.
Roles array.
Role type (`funder`, `institution`, `publisher`).
Entity ID.
Outputs count for role.
ISO update date string.
ISO creation date string.
```bash cURL theme={null}
curl -X GET "https://api.hexagraph.in/publishers?sort=outputs_count:desc&per_page=25"
```
```javascript JavaScript theme={null}
fetch("https://api.hexagraph.in/publishers?sort=outputs_count:desc&per_page=25")
.then(response => response.json())
.then(data => console.log(data));
```
```python Python theme={null}
import requests
response = requests.get("https://api.hexagraph.in/publishers", params={"sort": "outputs_count:desc", "per_page": 25})
print(response.json())
```
```json 200 OK theme={null}
{
"meta": {
"count": 10703,
"page": 1,
"per_page": 25
},
"results": [
{
"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": "Bad Request - Invalid query parameters",
"error": "Bad Request"
}
```
```json 429 Rate Limit Exceeded theme={null}
{
"statusCode": 429,
"message": "Rate limit exceeded. Maximum 30 requests per minute.",
"error": "Too Many Requests"
}
```