πŸ’‘
Concept
Concepts are abstract ideas that works are about.
OpenAlex indexes about 65k concepts. The Canonical External ID for OpenAlex concepts is the Wikidata ID, and each of our concepts has one, because all OpenAlex concepts are also Wikidata concepts.
Concepts are hierarchical, like a tree. There are 19 root-level concepts, and six layers of descendents branching out from them, containing about 65 thousand concepts all told. This concept tree is a modified version of the one created by MAG. You can view all the concepts and their position in the tree as a spreadsheet here.
Each work is tagged with multiple concepts, based on its title and abstract. The tagging is done using an automated classifier that was trained on MAG’s corpus; you can read more about the development and operation of this classifier in Automated concept tagging for OpenAlex, an open index of scholarly articles. You can also implement the classifier yourself using our models and code.
Concepts are linked to works via the concepts property. They’re also linked to authors, venues, and institutions via the x_concepts property, and to other concepts via the ancestors and related_concepts properties.

The Concept object

id

String: The OpenAlex ID for this concept.
1
id: "https://openalex.org/C2778407487"
Copied!

wikidata

String: The Wikidata ID for this concept. This is the Canonical External ID for concepts.
All OpenAlex concepts have a Wikidata ID, because all OpenAlex concepts are also Wikidata concepts.
1
wikidata: "https://www.wikidata.org/wiki/Q14565201"
Copied!

display_name

String: The English-language label of the concept.
1
display_name: "Altmetrics"
Copied!

level

Integer: The level in the concept tree where this concept lives.
todo
1
level: 2
Copied!

description

String: A brief description of this concept.
todo
1
description: "study of alternative metrics for analyzing and informing scholarship"
Copied!

works_count

Integer: The number of works tagged with this concept.
1
works_count: 3078
Copied!

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.
1
cited_by_count: 20248
Copied!

ids

​
Object: All the external identifiers that we know about for this institution. IDs are expressed as URIs whenever possible. Possible ID types:
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..
1
ids: {
2
openalex: "https://openalex.org/C2778407487",
3
wikidata: "https://www.wikidata.org/wiki/Q14565201",
4
wikipedia: "https://en.wikipedia.org/wiki/Altmetrics",
5
mag: 2778407487114027177
6
}
Copied!
​

image_url

String: URL where you can get an image representing this concept, where available. Usually this is hosted on Wikipedia.
1
image_url: "https://upload.wikimedia.org/wikipedia/commons/f/f1/Altmetrics.svg"
Copied!

image_thumbnail_url

String: Same as image_url, but it's a smaller image.
1
image_thumbnail_url: "https://upload.wikimedia.org/wikipedia/commons/thumb/f/f1/Altmetrics.svg/100px-Altmetrics.svg.png"
Copied!

international

Object: todo
1
international: {
2
display_name: {
3
ca: "Altmetrics",
4
...
5
}
6
}
Copied!
​

ancestors

List: List of concepts that this concept descends from, as dehydrated Concept objects. See the concept tree section for more details on how the different layers of concepts work together.
1
ancestors: [
2
{
3
id: "https://openalex.org/C2522767166",
4
wikidata: "https://www.wikidata.org/wiki/Q2374463",
5
display_name: "Data science",
6
level: 1
7
},
8
{
9
id: "https://openalex.org/C161191863",
10
wikidata: "https://www.wikidata.org/wiki/Q199655",
11
display_name: "Library science",
12
level: 1
13
},
14
15
// and so forth
16
]
Copied!
List: Concepts that are similar to this one. Each listed concept is a dehydrated Concept object, with one additional attribute:
  • score (Float): The strength of association between this concept and the listed concept, on a scale of 0-100.
1
related_concepts: [
2
{
3
id: "https://openalex.org/C2778793908",
4
wikidata: null,
5
display_name: "Citation impact",
6
level: 3,
7
score: 4.56749
8
},
9
{
10
id: "https://openalex.org/C2779455604",
11
wikidata: null,
12
display_name: "Impact factor",
13
level: 2,
14
score: 4.46396
15
}
16
17
// and so forth
18
]
Copied!

counts_by_year

List: The values of works_count and cited_by_count 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.
1
counts_by_year: [
2
{
3
year: 2021,
4
works_count: 4211,
5
cited_by_count: 120939
6
},
7
{
8
year: 2020,
9
works_count: 4363,
10
cited_by_count: 119531
11
},
12
13
// and so forth
14
]
Copied!
​

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.
1
works_api_url: "https://api.openalex.org/works?filter=concept.id:C2778407487"
Copied!

updated_date

String: The last time anything in this concept object changed, expressed as an ISO 8601 date string. This date is updated for any change at all, including increases in various counts.
1
updated_date: "2021-12-25T14:04:30.578837"
Copied!

created_date

String: The date this Concept object was created in the OpenAlex dataset, expressed as an ISO 8601 date string.
1
created_date: "2017-08-08"
Copied!

The DehydratedConcept object

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