Aboutness endpoint (/text)
You can use the /text
API endpoint to tag your own free text with OpenAlex's "aboutness" assignments—topics, keywords, and concepts.
Accepts a title
and optional abstract
in the GET params or as a POST request. The results are straight from the model, with 0 values truncated.
Examples
Get OpenAlex Keywords for your text
https://api.openalex.org/text/keywords?title=type%201%20diabetes%20research%20for%20children
Get OpenAlex Topics for your text
https://api.openalex.org/text/topics?title=type%201%20diabetes%20research%20for%20children
Get OpenAlex Concepts for your text
https://api.openalex.org/text/concepts?title=type%201%20diabetes%20research%20for%20children
Get all of the above in one request
https://api.openalex.org/text?title=type%201%20diabetes%20research%20for%20children
Example response for that last one:
{
meta: {
keywords_count: 5,
topics_count: 3,
concepts_count: 3
},
keywords: [
id: "https://openalex.org/keywords/type-1-diabetes",
display_name: "Type 1 Diabetes",
score: 0.677
], ...
primary_topic: {
id: "https://openalex.org/T10560",
display_name: "Management of Diabetes Mellitus and Hypoglycemia",
score: 0.995
// more information about the primary topic, removed for brevity
},
topics: [
// list of topic objects with scores
],
concepts: [
// list of concept objects with scores
]
}
Queries are limited to between 20 and 2000 characters. The endpoints are rate limited to 1 per second and 1000 requests per day.
Last updated