Skip to main content
POST
papers.get

Authorizations

Authorization
string
header
required

API key: sk_live_…

Headers

Idempotency-Key
string

Optional. A retry with the same key returns the stored result.

Maximum string length: 255
Pramaan-Max-Price-Micro
string

Optional. The most this request may be priced at, in micro-USD (a whole number above 0). It replaces the capability's own price ceiling for this request, lower or higher. Sources that could cost more are left out; when none is left the answer is 400 with the lowest limit that would work.

Pattern: ^[1-9]\d{0,14}$

Body

application/json
doi
string

Public DOI, for example 10.5555/example-paper.

Required string length: 1 - 512
pmid
string

Public PMID.

Required string length: 1 - 16
Pattern: ^\d+$
pmcid
string

Public PMCID.

Required string length: 1 - 24
Pattern: ^PMC\d+$
arxivId
string

Public preprint identifier.

Required string length: 1 - 64
Pattern: ^(?:\d{4}\.\d{4,5}|[a-z.-]+\/\d{7})(?:v\d+)?$
anthologyId
string

Public anthology record identifier.

Required string length: 1 - 64
Pattern: ^[A-Za-z0-9.-]+$
publicationUrl
string

Original publisher or repository publication URL.

Required string length: 1 - 2048
ref
string

The ref returned by a paper list.

Pattern: ^(ref_[0-9A-HJKMNP-TV-Z]{26}|rh_[A-Za-z0-9_-]{24,1024})$

Response

The result

title
string

Publication title.

Required string length: 1 - 1024
doi
string

Public DOI.

Required string length: 1 - 512
pmid
string

Public biomedical record identifier.

Required string length: 1 - 512
pmcid
string

Public full-text archive identifier.

Required string length: 1 - 512
arxivId
string

Public preprint identifier.

Required string length: 1 - 512
anthologyId
string

Public anthology identifier.

Required string length: 1 - 512
abstract
string

Published abstract.

Required string length: 1 - 20000
publicationYear
integer

Publication year.

Required range: 1000 <= x <= 3000
publicationDate
string

Complete publication date, YYYY-MM-DD.

Required string length: 1 - 10
documentType
string

Publication format.

Required string length: 1 - 64
language
string

Publication language code.

Required string length: 1 - 16
authors
object[]

Published author names, ORCIDs and affiliations; no contact details.

Maximum array length: 100
venue
string

Journal or conference.

Required string length: 1 - 512
citationCount
integer

Number of citing publications.

Required range: 0 <= x <= 9007199254740991
referenceCount
integer

Number of outgoing references.

Required range: 0 <= x <= 9007199254740991
isOpenAccess
boolean

Whether a publicly readable copy is known.

url
string

Original publication link.

Required string length: 1 - 2048
pdfUrl
string

Original public PDF.

Required string length: 1 - 2048
funding
object[]

Published funders and grants.

Maximum array length: 50
subjects
string[]

Published academic subjects.

Maximum array length: 50

Subject label.

Required string length: 1 - 512