Raw schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 1000,
"pattern": "^[^\\x00-\\x08\\x0B\\x0C\\x0E-\\x1F]*$",
"description": "Search query. Field prefixes: ti: (title), au: (author β search the surname and narrow a common one with a category or topic: au:hinton AND cat:cs.LG; a quoted name such as au:\"geoffrey hinton\" matches when one author's name holds every quoted word, in any order, and an initial does not match a spelled-out first name), abs: (abstract), cat: (category β a leaf code matches exactly, an alias code such as cat:cs.NA matches its canonical code, math.NA, and a bare archive code such as cat:astro-ph matches its whole subtree), co: (comment), jr: (journal ref), all: (all fields). Boolean operators, uppercase only: AND, OR, ANDNOT. Space-separated terms are joined with OR, so \"quantum computing\" matches papers with either word; AND requires every term (\"quantum AND computing\"). The operators share one precedence and group to the right (\"a AND b OR c\" reads as \"a AND (b OR c)\"), so use parentheses for any other grouping. Quote a multi-word topic to match it as a phrase, and put alternatives in parentheses before a filter so the filter applies to all of them: '\"graph neural networks\" AND cat:cs.LG', '(ti:transformer OR ti:attention) AND cat:cs.CL'. arXiv ignores common words such as of, the, and, for, in, so leave them out or keep them inside a quoted phrase. Examples: \"au:bengio AND ti:attention\", \"all:transformer AND cat:cs.CL\"."
},
"category": {
"description": "Restrict results to an arXiv category. A leaf code (\"cs.CL\", \"math.AG\") matches exactly. An alias code matches the papers of the canonical code arXiv lists in its place: \"cs.NA\" matches math.NA, \"cs.SY\" eess.SY, \"math.IT\" cs.IT, \"math.MP\" math-ph, \"stat.TH\" math.ST, \"q-fin.EC\" econ.GN. A bare archive code (\"astro-ph\", \"cond-mat\", \"cs\", \"math\") matches the whole archive β its subject classes plus the legacy flat papers filed before the archive was subdivided β and the canonical codes of the aliases in it, so \"cs\" also matches math.NA and eess.SY. Note \"physics\" is the general-physics archive (physics.*), not the wider physics group: astro-ph, cond-mat, hep-*, quant-ph and the rest are separate archive codes. Use arxiv_list_categories to discover subject classes.",
"type": "string"
},
"max_results": {
"default": 10,
"description": "Maximum results to return. Default 10. At most 50 are returned per call: a larger value returns the first 50, and when more matches exist the response says how to reach them β the start of the next page, or date windows once paging cannot reach them all. arXiv serves only the first 10000 results of a query, so a page reaching past result 10000 can come back cut short at it, and the response says so. Each result includes title, authors, abstract, and metadata β keep low to limit response size.",
"type": "integer",
"minimum": 1,
"maximum": 10000
},
"sort_by": {
"description": "Sort criterion. Use \"submitted\" for newest papers, \"relevance\" for best query matches.",
"default": "relevance",
"type": "string",
"enum": [
"relevance",
"submitted",
"updated"
]
},
"sort_order": {
"default": "descending",
"description": "Sort direction. \"descending\" returns newest/most relevant first.",
"type": "string",
"enum": [
"ascending",
"descending"
]
},
"start": {
"default": 0,
"description": "Pagination offset (0-10000). Use with max_results to page through results. E.g., start=10 with max_results=10 returns results 11-20. arXiv serves only the first 10000 results of a query, so a page reaching past result 10000 can come back cut short at it and a start of 10000 can be refused. To reach later matches, carve the search into submitted_from/submitted_to windows and page within each.",
"type": "integer",
"minimum": 0,
"maximum": 10000
},
"submitted_from": {
"description": "Earliest submission date to include, inclusive, as a UTC YYYY-MM-DD date. Omit for no lower bound.",
"type": "string",
"pattern": "^(\\d{4}-\\d{2}-\\d{2})?$"
},
"submitted_to": {
"description": "Latest submission date to include, inclusive, as a UTC YYYY-MM-DD date. Omit for no upper bound. Both bounds are inclusive, so consecutive windows (\"2024-01-01\"..\"2024-01-15\" then \"2024-01-16\"..\"2024-01-31\") cover the matches with no gap; a paper submitted at exactly the midnight seam between two windows appears in both, so de-duplicate collected results by paper id. That is the way to reach matches past the start ceiling: split the date range, then page within each window.",
"type": "string",
"pattern": "^(\\d{4}-\\d{2}-\\d{2})?$"
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}