Openalex Literature Search

Status

The most recent probe succeeded. Safe to call from the agent today.

Last probed

1d ago

Last success

1d ago

Last latency

111ms

Schema

JSON Schema the agent (or your API call) must match.

{
  "anyOf": [
    {
      "required": [
        "search_keywords"
      ]
    },
    {
      "required": [
        "query"
      ]
    }
  ],
  "properties": {
    "fulltext_terms": {
      "description": "Optional list of terms that must occur in OpenAlex full-text index (adds fulltext.search:<term> filters and implicitly enables require_has_fulltext).",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "limit": {
      "description": "Alias for `max_results` (OpenAlex max 200).",
      "maximum": 200,
      "minimum": 1,
      "type": "integer"
    },
    "max_results": {
      "default": 10,
      "description": "Maximum number of papers to retrieve (default: 10, maximum: 200).",
      "maximum": 200,
      "minimum": 1,
      "type": "integer"
    },
    "open_access": {
      "description": "Filter for open access papers only. Set to true for open access papers, false for non-open access, or omit for all papers.",
      "type": "boolean"
    },
    "query": {
      "description": "Alias for `search_keywords` (recommended when you standardize on `query` across multiple paper-search tools).",
      "type": "string"
    },
    "require_has_fulltext": {
      "default": false,
      "description": "If true, filters to works where OpenAlex indicates a full-text index is available (has_fulltext:true).",
      "type": "boolean"
    },
    "search_keywords": {
      "description": "Keywords to search for in paper titles/abstracts/etc. For full-text-index-only matching, also use require_has_fulltext/fulltext_terms.",
      "type": "string"
    },
    "year_from": {
      "description": "Start year for publication date filter (e.g., 2020). Optional parameter to limit search to papers published from this year onwards.",
      "type": "integer"
    },
    "year_to": {
      "description": "End year for publication date filter (e.g., 2023). Optional parameter to limit search to papers published up to this year.",
      "type": "integer"
    }
  },
  "type": "object"
}

Examples (1)

{
  "fulltext_terms": [],
  "limit": 3,
  "max_results": 1,
  "open_access": false,
  "query": "BRCA1",
  "require_has_fulltext": false,
  "year_from": 1,
  "year_to": 1
}

Identifiers

Catalog ID

tu_openalex_literature_search

Tool name

openalex_literature_search

Added

2026-04-30 22:47Z

Tags

tooluniverse