Home › Monitoring and research › OpenAlex Papers API
Search scholarly papers in OpenAlex by keyword, author, institution, topic and year, with citation counts, open-access links and abstracts, or monitor for new papers since your last run. Beta.
| Field | Name | Required | What it does |
|---|---|---|---|
query | Keyword search | no | Search titles, abstracts and full text, e.g. 'graph neural networks'. Can be combined with the filters below. |
authors | Authors | no | Author names, OpenAlex IDs (A123...) or ORCID iDs. Names resolve to the best OpenAlex match (shown in the run OUTPUT, check it). |
institutions | Institutions | no | Institution names, OpenAlex IDs (I123...) or ROR ids, e.g. 'MIT'. Names resolve to the best match. |
topics | Topics | no | Topic names or OpenAlex topic IDs (T123...), e.g. 'Machine learning in healthcare'. |
dois | DOIs (exact lookup) | no | Fetch these specific papers by DOI (https://doi.org/... or bare 10.xxxx/...). |
yearFrom | Published from year | no | First publication year to include. |
yearTo | Published up to year | no | Last publication year to include. |
minCitations | Minimum citations | no | Only papers cited at least this many times. |
openAccessOnly | Open access only | no | Only papers with a free full-text version. |
sortBy | Sort by | no | Order of results. Monitor mode defaults to newest. |
maxItems | Max items | no | Cap on paper records delivered (and charged) this run. |
onlyNewSinceLastRun | Monitor mode: only new since last run | no | Skip papers already delivered in a previous run (tracked in a named key-value store) and only look at recent publications (see Days back). Schedule the actor to get a feed of new... |
daysBack | Days back (monitor mode) | no | Monitor mode: look at papers published in the last N days (ignored if 'Published from year' is set). |
workTypes | Work types | no | Optional OpenAlex types, e.g. article, preprint, review, dissertation, book-chapter. |
One row per result. These are the 26 fields declared in the actor's dataset schema (field list from the schema, not a sample run).
| Field | Type | Meaning |
|---|---|---|
id | string | |
doi | string | |
title | string | |
publicationYear | integer | |
publicationDate | string | |
type | string | |
language | string | |
citedByCount | integer | |
isRetracted | boolean | |
isOpenAccess | boolean | |
openAccessStatus | string | |
openAccessUrl | string | |
pdfUrl | string | |
license | string | |
venue | string | |
venueType | string | |
authors | array | |
authorCount | integer | |
institutions | array | |
topics | array | |
abstract | string | |
url | string | |
openAlexUrl | string | |
sourceRegistry | string | |
query | string | |
scrapedAt | string |
Public data only, no login. Fields a source does not publish come back empty rather than guessed. Coverage and freshness follow the underlying public source.
Pay on Apify, no subscription: $0.002 per paper returned (pay per event). The live price is on the actor page.
Disclosure: we build and maintain this actor.