GET /work-types

openalex.org:openalex-api

Summary: List work types
Operation ID: listWorkTypes
Auth: unknown
Description

Get a list of work types (article, book, dataset, etc.).

Parameters (10)

api_key (string, query, required)

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

cursor (string, query, optional)

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

filter (string, query, optional)

Filter work types. Examples: `id:article`, `works_count:>1000000`

group_by (string, query, optional)

Group results by a field and return counts. Available fields vary by entity type.

page (integer, query, optional)

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

Constraints: {'minimum': 1}

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

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

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

sample (integer, query, optional)

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

Constraints: {'maximum': 10000}

search (string, query, optional)

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

select (string, query, optional)

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

sort (string, query, optional)

Sort by: `works_count`, `cited_by_count`. Prefix with `-` for descending.

Examples (3)

TitleTypeURLAction
List all work types with pagination curl https://api.openalex.org/work-types?per_page=50&page=1
Filter work types with high work counts curl https://api.openalex.org/work-types?filter=works_count:>1000000&sort=works_count&per_page=25
Search work types and select specific fields curl https://api.openalex.org/work-types?search=article&select=id,display_name,works_count&per_page=10

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-03-23 11:08:16.011808 200 1064ms
2026-03-23 10:37:58.418137 200 1648ms
2026-03-22 21:10:13.948120 200 339ms

Response Changes

WhenOldNew
2026-03-23 10:37:58.418137 69b6d30a9607 fc475446bbe7
2026-03-23 11:08:16.011808 fc475446bbe7 e9019964faa4