Contributor roles

Eg:contributor-roles/softwareCount:14Links:works, authorships

A contributor role says what part an author played on a work: who came up with the idea, who wrote the software, who wrote the first draft. OpenAlex uses the 14 roles of CRediT, the Contributor Roles Taxonomy (ANSI/NISO Z39.104-2022), and records them per author, in each authorship’s contributor_roles. Use them to see who wrote a paper’s software or curated its data. Coverage: about 3 million works, most of them published since 2022. A contributor role’s OpenAlex ID looks like https://openalex.org/contributor-roles/software; list all 14 at api.openalex.org/contributor-roles.

Contributor roles are a vocabulary: OpenAlex records only the roles stated for each author and infers none.

About

Where the values come from

Only where a role is stated for a named author; never guessed from the byline. OpenAlex reads them from three places:

  • Crossref deposits. Publishers can attach CRediT roles to each author in the metadata they send Crossref. OpenAlex reads every deposit that does.
  • PubMed Central article XML. Many publishers tag each author’s CRediT roles in the article XML they send PubMed Central. OpenAlex reads them for every article in the PMC Open Access subset.
  • The article’s own text. Many articles print an “Author contributions” statement. OpenAlex reads it only when it uses CRediT’s own terms (“Conceptualization, J.Z. and Y.H.; Software, Y.H.”) and every name or set of initials matches exactly one author on the byline; anything ambiguous is skipped.

When more than one source has roles for a work, Crossref wins, then PubMed Central, then the article’s text. Each source author is matched to the work’s byline by position, checked against the author’s family name; an author whose family name doesn’t match the name at that byline position gets no roles (fewer than 1 in 100).

OpenAlex never guesses roles from the byline, and it doesn’t read statements written in free text (“J.Z. designed the study”). Roles appear as they were stated: to add or fix them, ask the publisher to deposit CRediT roles with Crossref.

How much of the index has them

CRediT dates from 2014 and many journals print it, but few publishers send it author by author in a form machines can read, so coverage is thin and recent. At launch about 3 million works carry roles: about 900,000 from Crossref deposits and PubMed Central, and about 2.2 million more from statements in the articles’ own text. Coverage grows as more publishers deposit roles.

The works that gained roles at launch got a new updated_date, so a copy of OpenAlex kept current by updated_date (or the next snapshot) receives them.

What no value means

An empty contributor_roles list means no roles reached OpenAlex for that author, not that the author had none.

Roles describe authors, not works

Roles sit on each authorship. To see who had a role on a work, read the work’s authorships. There is no works filter on a role by itself.

Values

IDDisplay nameDefinition (CRediT)
conceptualizationConceptualizationIdeas, formulation or evolution of overarching research goals and aims.
data-curationData curationManagement activities to annotate (produce metadata), scrub data and maintain research data (including software code, where it is necessary for interpreting the data itself) for initial use and later re-use.
formal-analysisFormal analysisApplication of statistical, mathematical, computational, or other formal techniques to analyze or synthesize study data.
funding-acquisitionFunding acquisitionAcquisition of the financial support for the project leading to this publication.
investigationInvestigationConducting a research and investigation process, specifically performing the experiments, or data/evidence collection.
methodologyMethodologyDevelopment or design of methodology; creation of models.
project-administrationProject administrationManagement and coordination responsibility for the research activity planning and execution.
resourcesResourcesProvision of study materials, reagents, materials, patients, laboratory samples, animals, instrumentation, computing resources, or other analysis tools.
softwareSoftwareProgramming, software development; designing computer programs; implementation of the computer code and supporting algorithms; testing of existing code components.
supervisionSupervisionOversight and leadership responsibility for the research activity planning and execution, including mentorship external to the core team.
validationValidationVerification, whether as a part of the activity or separate, of the overall replication/reproducibility of results/experiments and other research outputs.
visualizationVisualizationPreparation, creation and/or presentation of the published work, specifically visualization/data presentation.
writing-original-draftWriting – original draftPreparation, creation and/or presentation of the published work, specifically writing the initial draft (including substantive translation).
writing-review-editingWriting – review & editingPreparation, creation and/or presentation of the published work by those from the original research group, specifically critical review, commentary or revision – including pre- or post-publication stages.

The IDs are the last part of each role’s CRediT URL (https://credit.niso.org/contributor-roles/software/). Display names and definitions are CRediT’s own, used under its CC BY 4.0 license. CRediT’s optional degree of contribution (lead, equal, supporting) is not recorded: almost no source carries it.

Attributes

The top-level fields on a contributor role 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 role, e.g. https://openalex.org/contributor-roles/software.

display_name

String. CRediT’s name for the role, e.g. Software.

description

String. CRediT’s definition of the role (the definitions in Values).

ids

Object. The role’s IDs: openalex (its OpenAlex ID) and credit (its CRediT URL, e.g. https://credit.niso.org/contributor-roles/software/).

works_count

Integer. How many works have at least one author with this role. See Common attributes.

cited_by_count

Integer. The total citations of the works counted in works_count.

created_date

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

updated_date

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

In the API

The Contributor roles endpoint is at api.openalex.org/contributor-roles. Fetch one by ID, /contributor-roles/software, or list all 14.

Contributor roles show up on works: every authorship carries a contributor_roles list. See the endpoints index for every endpoint.

# All 14 contributor roles
https://api.openalex.org/contributor-roles

# A work whose authors have roles (each authorship lists its own)
https://api.openalex.org/works?filter=doi:10.3390/met16111246

On openalex.org, a work’s page shows each author’s roles next to their name.

Last updated

View as Markdown