arXiv API: Search papers
Finds arXiv preprints by topic or title words, with optional author, subject, submission date range and sorting. Returns up to 100 papers with abstracts, subjects, dates and links.
Unofficial. Not affiliated with or endorsed by arXiv.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Sort optional
sort Sort by relevance or newest first, for example "newest".
relevance (default)
One of
relevance,newest.- Query, required
query Topic or title words to find, for example "diffusion models".
diffusion models
- Author optional
author Author name to narrow results, for example "Jonathan Ho".
Not set
- Subject optional
subject arXiv subject in plain words, for example "machine learning".
Not set
- End Date optional
end_date First submission date on or before this day, for example "2023-12-31".
Not set
Date.
- Start Date optional
start_date First submission date on or after this day, for example "2020-01-01".
Not set
Date.
- Max Results optional
max_results Maximum number of papers to return, for example 20.
20 (default)
Whole number from 1 to 100.
Input as JSON
{ "query": "diffusion models"}Output
{ "papers": [ { "title": "Video Diffusion Models: A Survey", "authors": [ "Andrew Melnik", "Michal Ljubljanac", "Cong Lu" ], "abstract": "Diffusion generative models have recently become a powerful technique for creating and modifying high-quality, coherent video content. This survey provides a comprehensive overview of the critical components of diffusion models for video generation, including their applications, architectural design…", "pdf_link": "https://arxiv.org/pdf/2405.03150v2" , "subjects": [ "Computer Vision and Pattern Recognition (cs.CV)", "Machine Learning (cs.LG)" ], "arxiv_number": "2405.03150", "last_updated_date": "2024-11-17", "abstract_page_link": "https://arxiv.org/abs/2405.03150v2" , "first_submitted_date": "2024-05-06" }, { "title": "Controllable Generation with Text-to-Image Diffusion Models: A Survey", "authors": [ "Pu Cao", "Feng Zhou", "Qing Song" ], "abstract": "In the rapidly advancing realm of visual generation, diffusion models have revolutionized the landscape, marking a significant shift in capabilities with their impressive text-guided generative functions. However, relying solely on text for conditioning these models does not fully cater to the varie…", "pdf_link": "https://arxiv.org/pdf/2403.04279v2" , "subjects": [ "Computer Vision and Pattern Recognition (cs.CV)" ], "arxiv_number": "2403.04279", "last_updated_date": "2026-01-07", "abstract_page_link": "https://arxiv.org/abs/2403.04279v2" , "first_submitted_date": "2024-03-07" }, { "title": "LDM3D-VR: Latent Diffusion Model for 3D VR", "authors": [ "Gabriela Ben Melech Stan", "Diana Wofk", "Estelle Aflalo" ], "abstract": "Latent diffusion models have proven to be state-of-the-art in the creation and manipulation of visual outputs. However, as far as we know, the generation of depth maps jointly with RGB is still limited. We introduce LDM3D-VR, a suite of diffusion models targeting virtual reality development that inc…", "pdf_link": "https://arxiv.org/pdf/2311.03226v1" , "subjects": [ "Computer Vision and Pattern Recognition (cs.CV)", "Artificial Intelligence (cs.AI)" ], "arxiv_number": "2311.03226", "last_updated_date": "2023-11-06", "abstract_page_link": "https://arxiv.org/abs/2311.03226v1" , "first_submitted_date": "2023-11-06" } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"arxiv.org/search_papers","input":{"query":"diffusion models"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "arxiv.org/search_papers" , "input": { "query": "diffusion models" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "arxiv.org/search_papers" , "input": { "query": "diffusion models" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run arxiv.org/search_papers# with {"query":"diffusion models"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "query" ], "properties": { "sort": { "enum": [ "relevance", "newest" ], "type": "string", "default": "relevance", "description": "Sort by relevance or newest first, for example \"newest\"." }, "query": { "type": "string", "minLength": 1, "description": "Topic or title words to find, for example \"diffusion models\"." }, "author": { "type": "string", "description": "Author name to narrow results, for example \"Jonathan Ho\"." }, "subject": { "type": "string", "description": "arXiv subject in plain words, for example \"machine learning\"." }, "end_date": { "type": "string", "format": "date", "description": "First submission date on or before this day, for example \"2023-12-31\"." }, "start_date": { "type": "string", "format": "date", "description": "First submission date on or after this day, for example \"2020-01-01\"." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum number of papers to return, for example 20.", "x-fous-developer": true } }, "additionalProperties": false}Output schema
{ "type": "object", "required": [ "papers" ], "properties": { "papers": { "type": "array", "items": { "type": "object", "required": [ "title", "authors", "abstract", "subjects", "first_submitted_date", "last_updated_date", "pdf_link", "abstract_page_link", "arxiv_number" ], "properties": { "title": { "type": "string", "description": "Paper title." }, "authors": { "type": "array", "items": { "type": "string" }, "description": "Author names." }, "abstract": { "type": "string", "description": "Paper abstract in plain text." }, "pdf_link": { "type": [ "string", "null" ], "description": "Link to the paper PDF." }, "subjects": { "type": "array", "items": { "type": "string" }, "description": "Subject names and arXiv category codes." }, "arxiv_number": { "type": "string", "description": "arXiv paper number.", "x-fous-developer": true }, "last_updated_date": { "type": "string", "format": "date", "description": "Date last updated." }, "abstract_page_link": { "type": "string", "description": "Link to the paper abstract page." }, "first_submitted_date": { "type": "string", "format": "date", "description": "Date first submitted." } }, "additionalProperties": false }, "description": "Matching preprints." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
arxiv.org/search_papers- Returns
- title, authors, abstract, subjects, submitted and updated dates, PDF and abstract links, arXiv number
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method arxiv.org/search_papers with the inputs above.
Ask your agent
- Find recent preprints on diffusion models submitted in 2023, sorted newest first
- Search arXiv for papers by Jonathan Ho about generative models
- Show me up to 50 machine learning papers mentioning transformer attention from 2021 to 2022
- Look up preprints titled with graph neural networks for molecular property prediction
- Find papers on reinforcement learning from human feedback, most relevant first, limit 10
See more
All arXiv methodsGets an arXiv paper's title, authors, abstract, subjects, submission dates and publication details from its exact title, arXiv link or number.
arxiv.org/get_paperLists the latest newly announced papers in an arXiv subject, in announcement order. Cross-lists are optional and replacements are excluded.
arxiv.org/list_new_papersFinds bioRxiv and medRxiv preprints whose title, abstract or subject matches all topic words, within a posting date range, newest first. Adds published journal details when available.
biorxiv.org/search_preprintsSearches OpenAlex scholarly works by topic, with optional institution, publication-year and open-access filters, ranked by relevance, citations or newest date.
openalex.org/search_papersSearches Semantic Scholar for research papers in relevance order, with field of study, year range and open-access filters, returning AI one-sentence summaries, citations and free PDF links when available.
semanticscholar.org/search_papersSearches New York Times article headlines and summaries by keyword, optionally within a date range, and returns matching articles with dates, authors, sections and links, newest or most relevant first.
nytimes.com/search_newsSearches The Verge articles by keyword, with optional date filters, sorting and pagination. Only the first 100 matches from The Verge search are used.
theverge.com/search_newsSearches Guardian articles by keyword through the public Google News feed for theguardian.com, optionally within publication dates, ordered newest first or by relevance, and returns each article's headline, summary, authors, section and publication time from its Guardian page.
theguardian.com/search_news