v2

latestOpenAPI 3.1.0CC02026-07-264460181.4 KB
Works

List works

Get a list of scholarly works with optional filtering, searching, sorting, and pagination. Works include journal articles, books, datasets, theses, and more.

get/works

Query parameters

filterstring

Filter works. Examples: publication_year:2023, type:article, open_access.is_oa:true, author.id:A5023888391, institutions.id:I27837315, cited_by_count:>100 See all Work fields.

sortstring

Sort by: cited_by_count, publication_date, relevance_score (with search). Prefix with - for descending. See all Work fields.

group_bystring

Group by: publication_year, type, open_access.is_oa, authorships.institutions.country_code See all Work fields.

searchstring

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

per_pageinteger

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

pageinteger

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

cursorstring

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

sampleinteger

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

selectstring

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

api_keystring required

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

Response

Successful response

Example response

{
  "results": [
    {
      "id": "https://openalex.org/W2741809807",
      "doi": "https://doi.org/10.7717/peerj.4375"
    }
  ]
}
All 44 operations