Indexes

Eg:indexes/doajCount:5Links:works, sources

An index is an external bibliographic index or registry that a work can be listed in — Crossref, PubMed, DataCite, DOAJ, arXiv. Indexes are a vocabulary: they’re not native, judgment-call IDs, just consistent handles on crisply-existing external lists. A single work can appear in several indexes at once, so each work carries an indexed_in list, and a source records which of these indexes cover it. An index’s OpenAlex ID looks like https://openalex.org/indexes/doaj; fetch one at api.openalex.org/indexes/doaj.

About

The list is the set of external indexes and registries OpenAlex tracks as sources of works: DOI-registration agencies (Crossref, DataCite), curated indexes (DOAJ, PubMed), and a preprint repository (arXiv). We record which of them lists each work; a work can be in more than one. There are 5 indexes.

Indexes are about works. For lists of journals (CWTS Core, DOAJ’s journal list, national lists of health journals and so on), see Source lists.

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

Values

The complete list of all 5 indexes:

IDDisplay nameWhat it indexes
crossrefCrossrefThe largest DOI-registration agency: journal articles, books, conference proceedings
pubmedPubMedThe National Library of Medicine’s biomedical and life-sciences literature
dataciteDataCiteA DOI-registration agency focused on research data and other non-traditional outputs
doajDOAJThe article index of the Directory of Open Access Journals: articles DOAJ holds a record of. Not the same as the journal being in DOAJ (see above)
arxivarXivThe open-access preprint repository for physics, math, CS, and related fields

The live list is at api.openalex.org/indexes.

Attributes

The top-level fields on an index 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 index, e.g. https://openalex.org/indexes/doaj. See Common attributes.

display_name

String. The index’s name, e.g. DOAJ. See Common attributes.

description

String. A short one-line description of the index and what it covers.

works_count

Integer. How many works are listed in this index. See Common attributes.

cited_by_count

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

works_api_url

String. A ready-made Works API URL for every work in this index (filter=indexed_in:<ID>).

created_date

String. When the index record was added to OpenAlex (YYYY-MM-DDTHH:MM:SS; only the day is recorded, so the time is always 00:00:00). See Common attributes.

updated_date

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

In the API

The Indexes endpoint is at api.openalex.org/indexes. Fetch one by ID — /indexes/doaj — or list all five.

Indexes are most useful as a filter on works: filter=indexed_in:doaj returns works that DOAJ’s article index holds a record of (not every work in a DOAJ journal: see DOAJ: journal list and article index), filter=indexed_in:crossref those with a Crossref record, and group_by=indexed_in breaks a result set down by index. On sources, the same information appears as which indexes cover the source. See Filtering for the full syntax and the endpoints index for every endpoint.

Last updated

View as Markdown