Aboutness endpoint (/text)

Experimental endpoint. This endpoint is experimental and not suitable for production use. The API, response format, and behavior may change without notice. If you're interested in using this endpoint in production, please contact us so we can understand your use case and prioritize accordingly.

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 endpoint is rate limited to 1 request per second. Each request costs 1,000 credits (see rate limits).