Curation & special

Tag Aboutness

Warning: Deprecated endpoint. The /text/topics endpoint is deprecated. Use the /text/keywords endpoint instead.

The /text endpoint lets you tag free text with OpenAlex’s “aboutness” assignments: topics, keywords, and concepts.

Request format

Send a title and optional abstract via GET or POST:

GET https://api.openalex.org/text/keywords?title=type%201%20diabetes%20research%20for%20children

Available endpoints

Endpoint Returns
/text/keywords Keywords for your text
/text/concepts Concepts for your text
/text All of the above in one request

Example response

GET https://api.openalex.org/text?title=type%201%20diabetes%20research%20for%20children
{
  "meta": {
    "keywords_count": 5,
    "concepts_count": 3
  },
  "keywords": [
    {
      "id": "https://openalex.org/keywords/type-1-diabetes",
      "display_name": "Type 1 Diabetes",
      "score": 0.677
    }
  ],
  "concepts": [
    {
      "id": "https://openalex.org/C71924100",
      "display_name": "Medicine",
      "score": 0.85
    }
  ]
}

Limits

Constraint Value
Text length 20-2000 characters
Rate limit 1 request per second
Cost $0.01 per request
View as Markdown