OPopenalex
Countries

Get a single country

Retrieve a single country by its ISO 3166-1 alpha-2 code.

get/countries/{id}

Request

  • Base URL
    https://api.openalex.org
  • URL
    https://api.openalex.org/countries/{id}
  • Auth
    API key in query parameter api_key

Path parameters

idstring required

ISO 3166-1 alpha-2 country code (e.g., US, GB, CN)

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 country.

display_namestring

The full name of the country.

country_codestring

ISO 3166-1 alpha-2 country code.

descriptionstring

A brief description of the country.

display_name_alternativesstring[]

Alternate names for this country.

is_global_southboolean

Whether this country is part of the Global South.

works_countinteger

The number of works with authors affiliated with institutions in this country.

cited_by_countinteger

Total citations to works from this country.

works_api_urlstring

A URL that returns all works from authors in this country.

authors_api_urlstring

A URL that returns all authors with affiliations in this country.

institutions_api_urlstring

A URL that returns all institutions in this country.

created_datestring date

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

updated_datestring date-time

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

Example response

{
  "id": "https://openalex.org/countries/US"
}

Changes

No recorded changes to this operation across all 6 revisions of this API.