OpenAlex technical documentation
  • Overview
  • Quickstart tutorial
  • API Entities
    • Entities overview
    • 📄Works
      • Work object
        • Authorship object
        • Location object
      • Get a single work
      • Get lists of works
      • Filter works
      • Search works
      • Group works
      • Get N-grams
    • 👩Authors
      • Author object
      • Get a single author
      • Get lists of authors
      • Filter authors
      • Search authors
      • Group authors
      • Limitations
      • Author disambiguation
    • 📚Sources
      • Source object
      • Get a single source
      • Get lists of sources
      • Filter sources
      • Search sources
      • Group sources
    • 🏫Institutions
      • Institution object
      • Get a single institution
      • Get lists of institutions
      • Filter institutions
      • Search institutions
      • Group institutions
    • 💡Topics
      • Topic object
      • Get a single topic
      • Get lists of topics
      • Filter topics
      • Search topics
      • Group topics
    • 🗝️Keywords
    • 🏢Publishers
      • Publisher object
      • Get a single publisher
      • Get lists of publishers
      • Filter publishers
      • Search publishers
      • Group publishers
    • 💰Funders
      • Funder object
      • Get a single funder
      • Get lists of funders
      • Filter funders
      • Search funders
      • Group funders
    • 🌎Geo
      • Continents
      • Regions
    • Concepts
      • Concept object
      • Get a single concept
      • Get lists of concepts
      • Filter concepts
      • Search concepts
      • Group concepts
    • Aboutness endpoint (/text)
  • How to use the API
    • API Overview
    • Get single entities
      • Random result
      • Select fields
    • Get lists of entities
      • Paging
      • Filter entity lists
      • Search entities
      • Sort entity lists
      • Select fields
      • Sample entity lists
      • Autocomplete entities
    • Get groups of entities
    • Rate limits and authentication
  • Download all data
    • OpenAlex snapshot
    • Snapshot data format
    • Download to your machine
    • Upload to your database
      • Load to a data warehouse
      • Load to a relational database
        • Postgres schema diagram
  • Additional Help
    • Tutorials
    • Report bugs
    • FAQ
Powered by GitBook
On this page
  • ancestors
  • cited_by_count
  • counts_by_year
  • created_date
  • description
  • display_name
  • id
  • ids
  • image_thumbnail_url
  • image_url
  • international
  • level
  • related_concepts
  • summary_stats
  • updated_date
  • wikidata
  • works_api_url
  • works_count
  • The DehydratedConcept object
Export as PDF
  1. API Entities
  2. Concepts

Concept object

PreviousConceptsNextGet a single concept

Last updated 1 year ago

These are the original OpenAlex Concepts, which are being deprecated in favor of . We will continue to provide these Concepts for Works, but we will not be actively maintaining, updating, or providing support for these concepts. Unless you have a good reason to be relying on them, we encourage you to look into instead.

These are the fields in a concept object. When you use the API to get a or , this is what's returned.

ancestors

List: List of concepts that this concept descends from, as objects. See the for more details on how the different layers of concepts work together.

ancestors: [
    {
        id: "https://openalex.org/C2522767166",
        wikidata: "https://www.wikidata.org/wiki/Q2374463",
        display_name: "Data science",
        level: 1
    },
    {
        id: "https://openalex.org/C161191863",
        wikidata: "https://www.wikidata.org/wiki/Q199655",
        display_name: "Library science",
        level: 1
    },
    
    // and so forth
]

cited_by_count

Integer: The number citations to works that have been tagged with this concept. Or less formally: the number of citations to this concept.

For example, if there are just two works tagged with this concept and one of them has been cited 10 times, and the other has been cited 1 time, cited_by_count for this concept would be 11.

cited_by_count: 20248 

counts_by_year

Years with zero citations and zero works have been removed so you will need to add those back in if you need them.

counts_by_year: [
    {
        year: 2021,
        works_count: 4211,
        cited_by_count: 120939
    },
    {
        year: 2020,
        works_count: 4363,
        cited_by_count: 119531
    },
    
    // and so forth
]

created_date

created_date: "2017-08-08"

description

String: A brief description of this concept.

description: "study of alternative metrics for analyzing and informing scholarship"

display_name

String: The English-language label of the concept.

display_name: "Altmetrics"

id

String: The OpenAlex ID for this concept.

id: "https://openalex.org/C2778407487"

ids

Object: All the external identifiers that we know about for this concept. IDs are expressed as URIs whenever possible. Possible ID types:

  • wikipedia (String: this concept's Wikipedia page URL)

Many concepts are missing one or more ID types (either because we don't know the ID, or because it was never assigned). Keys for null IDs are not displayed..

ids: {
    openalex: "https://openalex.org/C2778407487",
    wikidata: "https://www.wikidata.org/wiki/Q14565201",
    wikipedia: "https://en.wikipedia.org/wiki/Altmetrics",
    mag: 2778407487
}

image_thumbnail_url

image_thumbnail_url: "https://upload.wikimedia.org/wikipedia/commons/thumb/f/f1/Altmetrics.svg/100px-Altmetrics.svg.png"

image_url

String: URL where you can get an image representing this concept, where available. Usually this is hosted on Wikipedia.

image_url: "https://upload.wikimedia.org/wikipedia/commons/f/f1/Altmetrics.svg"

international

  • display_name (Object)

    • value (String): display_name in the given language

international: {
    display_name: {
        ca: "Altmetrics",
        ...
    }
}

level

level: 2

related_concepts

  • score (Float): The strength of association between this concept and the listed concept, on a scale of 0-100.

related_concepts: [
    {
        id: "https://openalex.org/C2778793908",
        wikidata: null,
        display_name: "Citation impact",
        level: 3,
        score: 4.56749
    },
    {
        id: "https://openalex.org/C2779455604",
        wikidata: null,
        display_name: "Impact factor",
        level: 2,
        score: 4.46396
    }
    
    // and so forth
]

summary_stats

Object: Citation metrics for this concept

While the h-index and the i-10 index are normally author-level metrics and the 2-year mean citedness is normally a journal-level metric, they can be calculated for any set of papers, so we include them for concepts.

summary_stats: {
    2yr_mean_citedness: 1.5295340589458237,
    h_index: 105,
    i10_index: 5045
}

updated_date

updated_date: "2021-12-25T14:04:30.578837"

wikidata

All OpenAlex concepts have a Wikidata ID, because all OpenAlex concepts are also Wikidata concepts.

wikidata: "https://www.wikidata.org/wiki/Q14565201"

works_api_url

String: An URL that will get you a list of all the works tagged with this concept.

We express this as an API URL (instead of just listing the works themselves) because there might be millions of works tagged with this concept, and that's too many to fit here.

works_api_url: "https://api.openalex.org/works?filter=concept.id:C2778407487"

works_count

Integer: The number of works tagged with this concept.

works_count: 3078 

The DehydratedConcept object

  • [`display_name`](concept-object.md#display\_name)

  • [`id`](concept-object.md#id)

  • [`level`](concept-object.md#level)

  • [`wikidata`](concept-object.md#wikidata)

List: The values of and for each of the last ten years, binned by year. To put it another way: for every listed year, you can see how many new works were tagged with this concept, and how many times any work tagged with this concept got cited.

String: The date this Concept object was created in the OpenAlex dataset, expressed as an date string.

mag (Integer: this concept's ID)

openalex (String: this concept's . Same as )

umls_cui (List: this concept's )

umls_aui (List: this concept's )

wikidata (String: this concept's . Same as )

String: Same as , but it's a smaller image.

Object: This concept's display name in many languages, derived from article titles on each language's wikipedia. See the for "Java Bytecode" for example source data.

key (String): language code in format. Full list of languages is .

Integer: The level in the concept tree where this concept lives. Lower-level concepts are more general, and higher-level concepts are more specific. has a level of 0; has a level of 5. Level 0 concepts have no ancestors and level 5 concepts have no descendants.

List: Concepts that are similar to this one. Each listed concept is a object, with one additional attribute:

2yr_mean_citedness Float: The 2-year mean citedness for this source. Also known as . We use the year prior to the current year for the citations (the numerator) and the two years prior to that for the citation-receiving publications (the denominator).

h_index Integer: The for this concept.

i10_index Integer: The for this concept.

String: The last time anything in this concept object changed, expressed as an date string. This date is updated for any change at all, including increases in various counts.

String: The for this concept. This is the for concepts.

The DehydratedConcept is stripped-down object, with most of its properties removed to save weight. Its only remaining properties are:

Topics
Topics
single concept
lists of concepts
dehydrated Concept
concept tree section
works_count
cited_by_count
ISO 8601
Microsoft Academic Graph
OpenAlex ID
Concept.id
Unified Medical Language System
Concept Unique Identifiers
Unified Medical Language System
Atom Unique Identifiers
Wikidata ID
Concept.wikidata
image_url
Wikidata entry
wikidata language code
here
Computer Science
Java Bytecode
dehydrated Concept
impact factor
h-index
i-10 index
ISO 8601
Wikidata ID
Canonical External ID
Concept