v2

OpenAPI 3.1.0CC02026-07-264460181.4 KB
Sources

Get a single source

Retrieve a single source by OpenAlex ID or ISSN.

get/sources/{id}

Path parameters

idstring required

OpenAlex ID (e.g., S1983995261) or ISSN

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

issn_lstring nullable

The ISSN-L (linking ISSN) for this source. This is the Canonical External ID for sources.

issnstring[] nullable

All ISSNs used by this source. Many publications have multiple ISSNs.

display_namestring

The name of the source.

type'journal' | 'repository' | 'conference' | 'ebook platform' | 'book series'

The type of source: journal, repository, conference, ebook platform, book series, metadata, or other.

host_organizationstring nullable

The host organization as an OpenAlex ID. This will be an Institution ID if the source is a repository, or a Publisher ID if it's a journal/conference.

host_organization_namestring nullable

The display_name of the host organization.

host_organization_lineagestring[]

OpenAlex IDs of parent publishers (only for publisher-hosted sources).

is_oaboolean

Whether this is currently a fully open-access source.

is_in_doajboolean

Whether this journal is listed in the Directory of Open Access Journals.

works_countinteger

The number of works this source hosts.

cited_by_countinteger

Total citations to works hosted in this source.

apc_usdinteger nullable

The source's article processing charge in USD.

homepage_urlstring nullable

The homepage URL for this source.

works_api_urlstring

A URL that will get you a list of all this source's works.

created_datestring date

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

updated_datestring date-time

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

Example response

{
  "id": "https://openalex.org/S1983995261"
}