Skip to main content
GET
/
topics
List topics
curl --request GET \
  --url 'https://api.openalex.org/topics?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/T12419",
      "display_name": "<string>",
      "description": "<string>",
      "keywords": [
        "<string>"
      ],
      "subfield": {
        "id": "<string>",
        "display_name": "<string>"
      },
      "field": {
        "id": "<string>",
        "display_name": "<string>"
      },
      "domain": {
        "id": "<string>",
        "display_name": "<string>"
      },
      "works_count": 123,
      "cited_by_count": 123,
      "ids": {
        "openalex": "<string>",
        "wikipedia": "<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 topics. Examples: domain.id:1, field.id:17, subfield.id:1702, works_count:>1000 See all Topic fields.

​
sort
string

Sort by: works_count, cited_by_count. Prefix with - for descending. See all Topic fields.

​
group_by
string

Group by: domain.id, field.id, subfield.id See all Topic 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[]