Search API
Search public papers by full title, finding, or method. No API key required.
curl -fsSG https://openversions.com/api/v1/search \
--data-urlencode "q=Fine-tuning a large language model on one GPU" \
--data "limit=1"Response shape
type SearchResponse = {
query: string
search_mode: "semantic" | "title" | null
next_cursor: string | null
results: (Finding | Method | TitleMatch)[]
}
type Finding = {
type: "finding"
id: string
claim: string
url: string
excerpt?: Excerpt
verification: {
status: "verified" | "unsupported" | "unverified" | "checking"
explanation: string | null
}
publication: Publication
}
type Method = {
type: "method"
id: string
claim: string
url: string
excerpt?: Excerpt
sources: string[]
publication: Publication
}
type TitleMatch = {
type: "publication"
publication: Publication
}
type Excerpt = { quote: string; url: string | null }
type Publication = {
path: string
title: string
authors: string[]
url: string
commit: string
source_url: string | null
}claimis a standalone description of what the authors found or did.excerptis a verbatim quote and its manuscript link, when available.sourceslists the manuscript links for a method. Multiple links can point to different pages of the same PDF.publication.authorslists names from the paper byline or commit history.publication.urlopens the OpenVersions page at the manuscript preview when available.publication.source_urllinks to the original on GitHub or arXiv, or is null for work published directly on OpenVersions.
Search options
qtakes a query of 1–300 characters.limitsets the page size (1–20, default 10).- For more results, pass
next_cursorascursorwith the same query. A null cursor means you’ve reached the end. - Add
group_by=publicationto group the current page’s results by paper, with findings and methods undermatches. A paper can appear on multiple pages.