Skip to main content
GET
/
authors
List authors
curl --request GET \
  --url 'https://api.openalex.org/authors?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/A5023888391",
      "orcid": "<string>",
      "display_name": "<string>",
      "display_name_alternatives": [
        "<string>"
      ],
      "works_count": 123,
      "cited_by_count": 123,
      "summary_stats": {
        "2yr_mean_citedness": 123,
        "h_index": 123,
        "i10_index": 123
      },
      "affiliations": [
        {
          "institution": {
            "id": "<string>",
            "display_name": "<string>",
            "ror": "<string>",
            "country_code": "<string>",
            "type": "<string>",
            "lineage": [
              "<string>"
            ]
          },
          "years": [
            123
          ]
        }
      ],
      "last_known_institutions": [
        {
          "id": "<string>",
          "display_name": "<string>",
          "ror": "<string>",
          "country_code": "<string>",
          "type": "<string>",
          "lineage": [
            "<string>"
          ]
        }
      ],
      "topics": [
        {
          "id": "<string>",
          "display_name": "<string>",
          "count": 123
        }
      ],
      "counts_by_year": [
        {
          "year": 123,
          "works_count": 123,
          "cited_by_count": 123
        }
      ],
      "ids": {
        "openalex": "<string>",
        "orcid": "<string>",
        "scopus": "<string>"
      },
      "works_api_url": "<string>",
      "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 authors. Examples: has_orcid:true, last_known_institutions.id:I27837315, works_count:>100, affiliations.institution.country_code:US See all Author fields.

​
sort
string

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

​
group_by
string

Group by: last_known_institutions.country_code, last_known_institutions.type, has_orcid See all Author 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[]