Academic Paper Search (by Keyword)

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "search query / keywords"
    },
    "sort": {
      "enum": [
        "relevance",
        "recency",
        "citations"
      ],
      "type": "string",
      "default": "relevance"
    },
    "source": {
      "enum": [
        "all",
        "arxiv",
        "pubmed",
        "openalex",
        "crossref",
        "semanticscholar"
      ],
      "type": "string",
      "default": "all"
    },
    "year_to": {
      "type": "string",
      "description": "latest publication year (inclusive)"
    },
    "maxItems": {
      "type": "string",
      "default": "20",
      "description": "1-50"
    },
    "year_from": {
      "type": "string",
      "description": "earliest publication year (inclusive)"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "count",
    "items"
  ],
  "properties": {
    "count": {
      "type": "number",
      "description": "Number of items returned by this call -- 20 and 0 observed across the two real fixtures."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "type",
          "source",
          "sources",
          "title",
          "abstract",
          "authors",
          "year",
          "published",
          "venue",
          "url",
          "pdfUrl",
          "doi",
          "citationCount",
          "citedByCount"
        ],
        "properties": {
          "doi": {
            "type": [
              "string",
              "null"
            ],
            "description": "Observed null on several real arxiv preprints that have not been assigned a DOI."
          },
          "url": {
            "type": "string",
            "description": "Link to the paper's page on its source site."
          },
          "type": {
            "type": "string",
            "description": "Observed as the literal string 'paper' on every real item."
          },
          "year": {
            "type": "number"
          },
          "title": {
            "type": "string"
          },
          "venue": {
            "type": "string",
            "description": "Journal, conference, or repository name, e.g. 'arXiv', 'Nature', 'New England Journal of Medicine'."
          },
          "pdfUrl": {
            "type": [
              "string",
              "null"
            ],
            "description": "Direct PDF link when the source offers one; observed null for several real openalex items with no open PDF."
          },
          "source": {
            "type": "string",
            "description": "Which upstream index this specific result came from, e.g. 'arxiv', 'openalex'."
          },
          "authors": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Author full names, in order as returned by the source index."
          },
          "sources": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Same value as `source`, wrapped in a single-element array on every real item observed."
          },
          "abstract": {
            "type": [
              "string",
              "null"
            ],
            "description": "Observed null on several real openalex items (abstract not available from that index), a full paragraph otherwise."
          },
          "published": {
            "type": "string",
            "description": "Publication date/time. Observed as a full ISO 8601 timestamp for arxiv items and a bare YYYY-MM-DD date for openalex items -- format varies by source, not a fixed pattern."
          },
          "citedByCount": {
            "type": [
              "number",
              "null"
            ],
            "description": "Same value as `citationCount` on every real item observed (openalex-sourced items only) -- null wherever citationCount is null."
          },
          "citationCount": {
            "type": [
              "number",
              "null"
            ],
            "description": "Observed null for every real arxiv item (arxiv's own index does not track citation counts) and a real integer for every real openalex item."
          },
          "openAccessUrl": {
            "type": [
              "string",
              "null"
            ],
            "description": "Open-access copy link when one exists; observed null for several real openalex items with no open-access version."
          }
        },
        "additionalProperties": true
      },
      "description": "Empty array on a genuinely no-match query (confirmed real, not inferred)."
    }
  },
  "description": "The paper-search result, as returned at routing.responseResultPath.",
  "additionalProperties": true
}