Skip to main content
GET
/
publishers
List publishers
curl --request GET \
  --url 'https://api.openalex.org/publishers?api_key='
{
  "meta": {
    "count": 123,
    "db_response_time_ms": 123,
    "page": 123,
    "per_page": 123,
    "next_cursor": "<string>",
    "groups_count": 123,
    "cost_usd": 123
  },
  "results": [
    {
      "id": "https://openalex.org/P4310319965",
      "display_name": "<string>",
      "alternate_titles": [
        "<string>"
      ],
      "country_codes": [
        "<string>"
      ],
      "hierarchy_level": 123,
      "parent_publisher": {
        "id": "<string>",
        "display_name": "<string>"
      },
      "lineage": [
        "<string>"
      ],
      "works_count": 123,
      "cited_by_count": 123,
      "sources_api_url": "<string>",
      "ids": {
        "openalex": "<string>",
        "ror": "<string>",
        "wikidata": "<string>"
      },
      "counts_by_year": [
        {
          "year": 123,
          "works_count": 123,
          "cited_by_count": 123
        }
      ],
      "created_date": "2023-12-25",
      "updated_date": "2023-11-07T05:31:56Z"
    }
  ],
  "group_by": [
    {
      "key": "<string>",
      "key_display_name": "<string>",
      "count": 123
    }
  ]
}

Authorizations

​
api_key
string
query
required

Your OpenAlex API key. Get a free key at https://openalex.org/settings/api

Query Parameters

​
filter
string

Filter publishers. Examples: country_codes:US, hierarchy_level:0, lineage:P4310319965 See all Publisher fields.

​
sort
string

Sort by: works_count, cited_by_count, summary_stats.h_index. Prefix with - for descending. See all Publisher fields.

​
group_by
string

Group by: country_codes, hierarchy_level See all Publisher fields.

​
search
string

Full-text search across titles, abstracts, and other text fields. Example: search=machine learning

​
per_page
integer
default:25

Number of results per page (1-100, default 25)

Required range: 1 <= x <= 100
​
page
integer

Page number for pagination. Use cursor for deep pagination beyond 10,000 results.

Required range: x >= 1
​
cursor
string

Cursor for deep pagination. Use cursor=* to start, then use the next_cursor from the response.

​
sample
integer

Return a random sample of N results (max 10,000). Cannot be used with sort or page.

Required range: x <= 10000
​
select
string

Comma-separated list of fields to return. Reduces response size. Example: select=id,display_name,cited_by_count

​
api_key
string
required

Your OpenAlex API key (required). Get a free key at https://openalex.org/settings/api

Response

Successful response

​
meta
object

Metadata about the query results

​
results
object[]
​
group_by
object[]