search_papers5 paramsSearch academic papers. Returns normalized hits with a short abstract preview; call get_paper for the full record.
| Parameter | Type | Description |
|---|
query | string | |
start | integer | |
source | string | |
sort_by | string | |
max_results | integer | |
search_all4 paramsAggregated search across arXiv, Semantic Scholar and OpenAlex at once. Fans out concurrently, de-duplicates the same work across corpora …
Aggregated search across arXiv, Semantic Scholar and OpenAlex at once. Fans out concurrently, de-duplicates the same work across corpora (by DOI or title) and re-ranks with Reciprocal Rank Fusion, so papers found by several sources rank highest. Each hit lists which `sources` found it and an `ids` map ({source: id}) you can pass to get_paper / read_paper / the citation tools. Prefer this over search_papers for a broad lookup.
| Parameter | Type | Description |
|---|
query | string | |
sources | string | |
per_source | integer | |
max_results | integer | |
search_medical5 paramsEvidence-graded MEDICAL literature search (PubMed + Europe PMC). Unlike search_all (generic, ranks high-cited reviews/guidelines above tr…
Evidence-graded MEDICAL literature search (PubMed + Europe PMC). Unlike search_all (generic, ranks high-cited reviews/guidelines above trials), this filters by research type via PubMed Publication-Type tags and re-ranks by the evidence pyramid (meta-analysis / systematic review > RCT > cohort > ...), so the actual clinical trials surface first. Open-access full text is pulled from Europe PMC by PMID. `query` should be English keyword/boolean text (PubMed maps it); do natural-language/multilingua
| Parameter | Type | Description |
|---|
query | string | |
year_from | integer | |
max_results | integer | |
study_types | string | |
fetch_fulltext | boolean | |
get_paper2 paramsFetch one paper by id, with full abstract and PDF link.
| Parameter | Type | Description |
|---|
source | string | |
paper_id | string | |
search_by_author4 paramsFind papers by a specific author, newest first.
| Parameter | Type | Description |
|---|
start | integer | |
author | string | |
source | string | |
max_results | integer | |
list_recent4 paramsList the latest papers in a subject category, newest first.
| Parameter | Type | Description |
|---|
start | integer | |
source | string | |
category | string | |
max_results | integer | |
list_categories1 paramList common subject category codes for filtering/recent.
| Parameter | Type | Description |
|---|
source | string | |
read_paper3 paramsRead a paper's full text. format='markdown' (default, body with formulas as $LaTeX$), 'html' (raw LaTeXML HTML), or 'latex' (the original…
Read a paper's full text. format='markdown' (default, body with formulas as $LaTeX$), 'html' (raw LaTeXML HTML), or 'latex' (the original LaTeX manuscript from the e-print source). arXiv only; id like 2401.01234.
| Parameter | Type | Description |
|---|
format | string | |
source | string | |
paper_id | string | |
list_paper_sourcesList available paper corpora.
recognize_formula3 paramsRecognize a math formula from an image and return LaTeX. Provide image_url (downloaded server-side) OR image_base64. model: deepseek-ocr …
Recognize a math formula from an image and return LaTeX. Provide image_url (downloaded server-side) OR image_base64. model: deepseek-ocr (default), paddleocr-vl, or texify. Returns {latex, model, elapsed_ms}.
| Parameter | Type | Description |
|---|
model | string | |
image_url | string | |
image_base64 | string | |
recognize_table3 paramsRecognize a table from an image and return LaTeX tabular code. Provide image_url OR image_base64. model: deepseek-ocr (default), paddleoc…
Recognize a table from an image and return LaTeX tabular code. Provide image_url OR image_base64. model: deepseek-ocr (default), paddleocr-vl, or texify. Returns {latex, model, elapsed_ms}.
| Parameter | Type | Description |
|---|
model | string | |
image_url | string | |
image_base64 | string | |
list_ocr_modelsList the OCR models available for recognize_formula / recognize_table.
lint_latex1 paramLint a LaTeX snippet: report errors and return an auto-fixed version. Input `code` (the LaTeX source). Returns {errors, fixed_code, summa…
Lint a LaTeX snippet: report errors and return an auto-fixed version. Input `code` (the LaTeX source). Returns {errors, fixed_code, summary_en, summary_zh, elapsed_ms}.
| Parameter | Type | Description |
|---|
code | string | |
extract_pdf4 paramsExtract a PDF to clean Markdown/LaTeX text via MinerU (great for papers behind no open-access full text — give the user's PDF and get rea…
Extract a PDF to clean Markdown/LaTeX text via MinerU (great for papers behind no open-access full text — give the user's PDF and get readable text back). Provide pdf_url (downloaded server-side, SSRF-guarded) OR pdf_base64. formula/table toggle math/table reconstruction. Returns {task_id, status, cached, content, chars}: a recently-seen (cached) or small PDF comes back with `content` in one call; a fresh PDF (MinerU is GPU-heavy, minutes) returns status='running' + a task_id — then call extract
| Parameter | Type | Description |
|---|
table | boolean | |
formula | boolean | |
pdf_url | string | |
pdf_base64 | string | |
extract_pdf_result1 paramFetch the result of an extract_pdf job by task_id. Returns {task_id, status, content, chars}: `content` is the extracted text once status…
Fetch the result of an extract_pdf job by task_id. Returns {task_id, status, content, chars}: `content` is the extracted text once status='done'; while still 'running' content is null — call again shortly. Results expire server-side, so fetch reasonably soon.
| Parameter | Type | Description |
|---|
task_id | string | |
get_paper_citations3 paramsSemantic Scholar: papers that CITE this one (forward citation graph). id accepts S2 id / DOI: / ARXIV: / CorpusId:.
| Parameter | Type | Description |
|---|
start | integer | |
paper_id | string | |
max_results | integer | |
get_paper_references3 paramsSemantic Scholar: papers this one REFERENCES (its bibliography). id accepts S2 id / DOI: / ARXIV: / CorpusId:.
| Parameter | Type | Description |
|---|
start | integer | |
paper_id | string | |
max_results | integer | |
get_paper_authors3 paramsSemantic Scholar: the authors of a paper (with h-index, paper/citation counts).
| Parameter | Type | Description |
|---|
start | integer | |
paper_id | string | |
max_results | integer | |
match_paper_title1 paramSemantic Scholar: find the single paper whose title best matches the given text (exact-match lookup).
| Parameter | Type | Description |
|---|
title | string | |
autocomplete_papers1 paramSemantic Scholar: autocomplete paper titles for a partial query (fast type-ahead).
| Parameter | Type | Description |
|---|
query | string | |
search_papers_bulk9 paramsSemantic Scholar: bulk paper search (up to 1000 hits, sortable e.g. 'citationCount:desc' or 'publicationDate:desc', with a continuation t…
Semantic Scholar: bulk paper search (up to 1000 hits, sortable e.g. 'citationCount:desc' or 'publicationDate:desc', with a continuation token). Filters: fields_of_study, year (e.g. '2020-2024'), venue, publication_types, open_access_pdf.
| Parameter | Type | Description |
|---|
sort | string | |
year | string | |
query | string | |
token | string | |
venue | string | |
max_results | integer | |
fields_of_study | string | |
open_access_pdf | boolean | |
publication_types | string | |
get_papers_batch1 paramSemantic Scholar: fetch many papers at once by id (S2/DOI:/ARXIV:/CorpusId:), up to ~500 per call.
| Parameter | Type | Description |
|---|
ids | array | |
search_authors3 paramsSemantic Scholar: search for authors by name; returns profiles with h-index and paper/citation counts.
| Parameter | Type | Description |
|---|
query | string | |
start | integer | |
max_results | integer | |
get_author1 paramSemantic Scholar: a single author's profile by id.
| Parameter | Type | Description |
|---|
author_id | string | |
get_author_papers3 paramsSemantic Scholar: all papers by a given author id, newest first.
| Parameter | Type | Description |
|---|
start | integer | |
author_id | string | |
max_results | integer | |
get_authors_batch1 paramSemantic Scholar: fetch many authors at once by id.
| Parameter | Type | Description |
|---|
ids | array | |
search_snippets2 paramsSemantic Scholar: search INSIDE paper full text and return matching text snippets (not just titles/abstracts).
| Parameter | Type | Description |
|---|
query | string | |
max_results | integer | |
recommend_papers_for_paper3 paramsSemantic Scholar: recommend papers similar to one paper. pool='recent' (last open corpus) or 'all-cs' (all of CS). If the 'recent' pool y…
Semantic Scholar: recommend papers similar to one paper. pool='recent' (last open corpus) or 'all-cs' (all of CS). If the 'recent' pool yields nothing (common for older papers), it automatically retries the 'all-cs' pool.
| Parameter | Type | Description |
|---|
pool | string | |
paper_id | string | |
max_results | integer | |
recommend_papers_from_examples3 paramsSemantic Scholar: recommend papers from positive (and optional negative) example paper ids.
| Parameter | Type | Description |
|---|
max_results | integer | |
negative_ids | | |
positive_ids | array | |
list_dataset_releasesSemantic Scholar Datasets: list all available release ids (dated snapshots of the full corpus).
get_dataset_release1 paramSemantic Scholar Datasets: which datasets a release contains (papers, abstracts, citations, embeddings, s2orc, tldrs…). release_id defaul…
Semantic Scholar Datasets: which datasets a release contains (papers, abstracts, citations, embeddings, s2orc, tldrs…). release_id defaults to 'latest'.
| Parameter | Type | Description |
|---|
release_id | string | |
get_dataset_download_links2 paramsSemantic Scholar Datasets: get download links (presigned URLs) for one dataset in a release. Needs the API key.
| Parameter | Type | Description |
|---|
release_id | string | |
dataset_name | string | |
get_dataset_diffs3 paramsSemantic Scholar Datasets: incremental diff (added/updated/deleted) for a dataset between two releases. Needs the key.
| Parameter | Type | Description |
|---|
end_release | string | |
dataset_name | string | |
start_release | string | |
get_openalex_work1 paramOpenAlex: fetch one work's full record (316M-work, all-field corpus). id accepts OpenAlex Wxxxx, a DOI, or an arXiv id.
| Parameter | Type | Description |
|---|
work_id | string | |
get_openalex_citations3 paramsOpenAlex: papers that CITE this work (forward citation graph), most-cited first.
| Parameter | Type | Description |
|---|
start | integer | |
work_id | string | |
max_results | integer | |
get_openalex_references2 paramsOpenAlex: the works this one REFERENCES (its bibliography).
| Parameter | Type | Description |
|---|
work_id | string | |
max_results | integer | |
search_openalex_authors3 paramsOpenAlex: search authors; returns profiles with h-index, i10-index, works/citation counts and institutions.
| Parameter | Type | Description |
|---|
query | string | |
start | integer | |
max_results | integer | |
search_openalex_institutions2 paramsOpenAlex: search institutions (universities, labs) with ROR id, country, works/citation counts.
| Parameter | Type | Description |
|---|
query | string | |
max_results | integer | |
search_openalex_works8 paramsOpenAlex: advanced filtered work search. Filters: from_year, to_year, is_oa (open access only), min_citations, institution_id. sort_by: r…
OpenAlex: advanced filtered work search. Filters: from_year, to_year, is_oa (open access only), min_citations, institution_id. sort_by: relevance|newest|cited.
| Parameter | Type | Description |
|---|
is_oa | boolean | |
query | string | |
sort_by | string | |
to_year | integer | |
from_year | integer | |
max_results | integer | |
min_citations | integer | |
institution_id | string | |
get_openalex_trends2 paramsOpenAlex: publication-trend analytics for a query — counts grouped by year (default), or by 'institutions.id', 'authorships.author.id', '…
OpenAlex: publication-trend analytics for a query — counts grouped by year (default), or by 'institutions.id', 'authorships.author.id', 'open_access.is_oa', 'type', 'language'. Returns aggregate counts only (cheap, no rows).
| Parameter | Type | Description |
|---|
query | string | |
group_by | string | |
list_openalex_topics2 paramsOpenAlex: search the topic taxonomy (~4500 topics) to find the right subject term for filtering or recent-work queries.
| Parameter | Type | Description |
|---|
query | string | |
max_results | integer | |