Source lists

Eg:source-lists/doyensCount:71Links:sources, works

A source list is an externally maintained list of journals that a source can appear on: the Directory of Open Access Journals, the CWTS Core sources list, a national list of recommended health journals. Source lists are a vocabulary: consistent handles on lists that exist outside OpenAlex, maintained by someone else. Each source carries a listed_in array of the lists it is on, and the dehydrated source inside every work location carries the same array, so works can be filtered by the lists their journal is on. A source list’s OpenAlex ID looks like https://openalex.org/source-lists/doyens; fetch one at api.openalex.org/source-lists/doyens.

Membership is all OpenAlex records. A list’s page says who maintains it, what it covers and which edition is loaded; it never says the list is right, and OpenAlex does not endorse any list. See Allow lists for why we prefer this over deny lists.

About

OpenAlex prefers allow lists to deny lists: they are transparent, easy to maintain and a sound basis for retrieval. The oldest ones arrived as booleans (is_in_doaj, is_core); listed_in and this entity are the general form, and the booleans are kept for compatibility.

A source list is not an index. An index records which external registries list a given work (indexed_in); a source list records which lists a journal is on. DOAJ appears in both, because DOAJ keeps both.

DOAJ: journal list and article index

The Directory of Open Access Journals (DOAJ) keeps two things: a journal list (the journals it has accepted) and an article index (records of single articles, which publishers send to DOAJ). OpenAlex has one attribute for each:

  • Journal level: is the journal on DOAJ’s journal list? is_in_doaj on the source, which is the same as doaj in its listed_in (source lists). To filter works by it, go through the work’s source: filter=primary_location.source.is_in_doaj:true.
  • Article level: does DOAJ’s article index hold a record of this work? doaj in the work’s indexed_in (indexes): filter=indexed_in:doaj.

The two answers can differ. A work in a DOAJ journal lacks indexed_in:doaj when DOAJ’s article index holds no record of that article. Publishers choose whether to send article records to DOAJ, and about 3,800 of the 23,700 DOAJ journals have sent none. About 10 million works are in a DOAJ journal without a DOAJ article record. So use the journal-level attribute for “published in a DOAJ journal”, and the article-level one only for “DOAJ lists this article”.

Lists are matched to sources by ISSN, and only a list’s current members count: a journal its maintainer has withdrawn is not listed_in. Each list is loaded from the maintainer’s published file, so membership is as current as the loaded edition (list_version). Spotted a newer edition, or know an open, ISSN-keyed list we should add? Tell us.

Values

We keep adding lists, so this page doesn’t name them. See every list OpenAlex carries at openalex.org/source-lists, or in the API at api.openalex.org/source-lists. Each list’s page gives its maintainer, what it covers, the loaded edition and how many sources and works are on it.

Where a maintainer ranks journals in levels, each level is its own list, named with the maintainer’s own label: norway-2, jufo-3, abdc-a-star, poland-200. Those frameworks exist to get away from the in-or-out binary, so OpenAlex keeps the levels rather than flattening them. A journal is on one level of a given register; to get “any level”, filter on all of them (listed_in:jufo-1|jufo-2|jufo-3). Directions differ between maintainers (for some the highest number is the top tier, for others level 1 or grade A is), so each list’s description says which tier is the top. A few maintainers nest one list inside another (ANVUR’s Class A journals are all on its list of scientific journals too), so a journal can carry two ids from one maintainer. States that aren’t a level (not yet evaluated, pending, level 0) are not lists.

Attributes

The top-level fields on a source list object. Attributes shared with other entities (id, display_name, works_count, cited_by_count, created_date, updated_date) are documented once on Common attributes.

id

String. The OpenAlex ID for this list, e.g. https://openalex.org/source-lists/doyens. The last segment is the value that appears in listed_in.

display_name

String. The list’s name as its maintainer publishes it, e.g. Liste de revues recommandables (CDD / CNU Santé).

description

String. What the list covers, in a sentence.

maintainer

String. The organisation that maintains the list.

url

String. Where the maintainer publishes the list.

list_version

String. The edition currently loaded, as a date (YYYY-MM-DD); null for lists derived continuously from another feed (DOAJ’s journal list, CWTS Core).

sources_count

Integer. How many OpenAlex sources are on this list.

works_count

Integer. How many works have their primary location in a source on this list. See Common attributes.

cited_by_count

Integer. Total citations across those works. See Common attributes.

sources_api_url

String. A ready-made Sources API URL for every source on this list (filter=listed_in:<ID>).

works_api_url

String. A ready-made Works API URL for every work whose primary location is on this list (filter=primary_location.source.listed_in:<ID>).

created_date

String. When the list was added to OpenAlex (YYYY-MM-DDTHH:MM:SS, an ISO 8601 date and time). See Common attributes.

updated_date

String. When the list record last changed. See Common attributes.

In the API

The Source lists endpoint is at api.openalex.org/source-lists. Fetch one by ID, /source-lists/doyens, or list them all.

Source lists are most useful as a filter. On sources, filter=listed_in:doyens returns the journals on the list and group_by=listed_in splits a result set across lists. On works, filter=primary_location.source.listed_in:doyens returns works published in those journals; locations.source.listed_in and best_oa_location.source.listed_in do the same for any location and the best OA location. See Filtering for the syntax and the endpoints index for every endpoint.

On openalex.org, the same thing is the listed in filter on sources (example) and source listed in on works (example).

Last updated

View as Markdown