Skip to main content
Paper search finds research papers by their title and abstract. It has three operations: search papers, read one paper by its id, and find papers like it.

Search papers

Get an API key in the Quickstart. Paper search needs an API key. This request finds papers from 2024 on, newest first.
GET /v1/search/research/papers takes the same fields as query parameters.

Read the response

results holds the papers. This real response is cut to the last of the three papers.
paperId names the paper. primaryId is its best outside id: arxiv:<id>, else doi:<DOI>, else openalex:<id>. ids lists every id Stophy knows. year, venue and openAccessUrl appear when known, and abstract is an empty string when the index holds none.

Search options

Read one paper

GET /v1/search/research/papers/{id} takes a paperId, a DOI as doi:10.18653/v1/2024.eacl-demo.16, an arXiv id as arxiv:<id>, or an OpenAlex id as openalex:W4411630045. Add query to get the passage that matches it.
This real response is cut: note is left out.
The paper index holds titles and abstracts, not full text, so the passage is the abstract, and note says so. Here authors is one string. k, from 1 to 50, is only valid with query. Without query, the answer holds only paper.

Find similar papers

GET /v1/search/research/papers/{id}/similar ranks papers by the words of your intent and the title of the paper. Add more papers to find ones like all of them: repeat anchor once for each.
This real response is cut to the first of the five papers.
The papers you start from are left out of results. poolSize is how many papers came back.

Limits and errors

  • All three operations need an API key. Without one they return 401 apiKeyRequired.
  • A paper that is not in the index returns 404 notFound with No paper matches <id>.
  • from later than to returns 400 invalidRequest with from: must not be later than to. from and to must be dates as YYYY-MM-DD.
  • categories on a search returns 400 invalidRequest, because the paper index holds no categories. mode set to citers or references returns 400 invalidRequest, because the index holds no citations.
  • A search that returns no papers costs nothing.

Price

Searching papers and finding similar papers cost $1 per 1,000 searches of up to 10 papers: $0.001 for each 10. Reading one paper counts as one page: $1 per 1,000 pages. A failed call costs nothing. See Pricing.