GET /authors

openalex.org:openalex-api

Summary: List and search researchers
Operation ID: listAuthors
Auth: unknown
Description

Search and filter through researcher profiles with support for full-text search, filtering by institution, citation metrics, and more.

Parameters (9)

cursor (string, query, optional)

Cursor token for deep pagination (start with 'cursor=*')

filter (string, query, optional)

Filter constraints using field:value syntax. Multiple filters can be combined with commas (AND). Supports OR with pipe (|) and NOT with !. Examples: publication_year:2024, authorships.author.id:A5023888391, is_oa:true

group_by (string, query, optional)

Group results by a field (e.g., publication_year)

page (integer, query, optional, default: 1)

Page number for pagination (capped at 10,000 results total; use cursor for deeper pagination)

Constraints: {'minimum': 1}

per_page (integer, query, optional, default: 25)

Number of results per page (default: 25, max: 100)

Constraints: {'minimum': 1, 'maximum': 100}

sample (integer, query, optional)

Return a random sample of N results (max: 10000)

Constraints: {'minimum': 1, 'maximum': 10000}

search (string, query, optional)

Full-text search query

select (string, query, optional)

Return only specified fields (comma-separated)

sort (string, query, optional)

Sort order using field:direction syntax. Direction can be 'asc' or 'desc'. Example: cited_by_count:desc

Examples (6)

TitleTypeURLAction
Search authors by name curl https://api.openalex.org/authors?search=albert+einstein
Filter authors by institution country curl https://api.openalex.org/authors?filter=last_known_institution.country_code:US&per_page=10
Paginated author search with page parameter curl https://api.openalex.org/authors?search=machine+learning&page=2&per_page=50
Search authors by name doc_extracted https://api.openalex.org/authors?search=Albert+Einstein
Search for author Heather Piwowar doc_extracted https://api.openalex.org/authors?search=Heather+Piwowar
List authors probe-gate https://api.openalex.org/authors?per_page=25

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-03-23 11:14:24.317603 200 3563ms
2026-03-23 10:31:06.112074 400 210ms
2026-03-23 10:19:18.337014 200 286ms
2026-03-22 21:11:17.546370 200 468ms
2026-03-22 21:01:11.179915 200 999ms
2026-03-22 21:00:09.486023 200 1038ms

Response Changes

WhenOldNew
2026-03-22 21:01:11.179915 86745f83807c a61b73c2628d
2026-03-22 21:11:17.546370 a61b73c2628d 5c94232b212f
2026-03-23 10:19:18.337014 5c94232b212f 307982b11bb3
2026-03-23 10:31:06.112074 307982b11bb3 8a2978db8bc4
2026-03-23 11:14:24.317603 8a2978db8bc4 0e5d63a543c6