v2

OpenAPI 3.1.0CC02026-07-264460181.4 KB
Subfields

Get a single subfield

Retrieve a single subfield by its ID.

get/subfields/{id}

Path parameters

idstring required

Subfield ID (e.g., 1702 for Artificial Intelligence)

Query parameters

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

idstring

The OpenAlex ID for this subfield.

display_namestring

The English-language label of the subfield.

descriptionstring

A description of this subfield.

display_name_alternativesstring[]

Alternate names for this subfield.

works_countinteger

The number of works tagged with topics in this subfield.

cited_by_countinteger

Total citations to works in this subfield.

works_api_urlstring

A URL that returns all works tagged with this subfield.

created_datestring date

When this subfield was added to OpenAlex (ISO 8601 date).

updated_datestring date-time

When this subfield was last updated (ISO 8601 datetime).

Example response

{
  "id": "https://openalex.org/subfields/1702"
}