OpenAlex Citation & Open-Access Works Explorer
Pricing
from $0.49 / 1,000 results
OpenAlex Citation & Open-Access Works Explorer
Search OpenAlex's open catalog of scholarly works and authors, or pull every work tied to an author, journal/source or institution. Returns citations, open-access status, abstracts, authorships and topic tags per work.
Pricing
from $0.49 / 1,000 results
Rating
0.0
(0)
Developer
vexaloom-labs
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
13 hours ago
Last modified
Categories
Features
Share
OpenAlex is a free, open index of scholarly works, authors, institutions and venues. This actor searches it, pulls records by ID, walks citations in either direction, and returns the evidence around open access: every OA copy, its license, and the PDF/TEI links where OpenAlex has full text. No cookies, login or proxy.
Modes
| Mode | What it returns |
|---|---|
searchWorks | Works matching a keyword/Boolean query and/or server-side filters. A query is optional when at least one filter is set, so you can browse e.g. every 2024 open-access review. |
getCitations | Works that cite each seed work (forward citations). |
getReferences | Works each seed work cites (backward citations / references). |
getCitationGraph | Both directions for each seed, with a citationContext on every row. |
searchAuthors | Author profiles: ORCID, works/citation counts, h-index, affiliations, topics. |
byWorkIds | Fetch specific works by OpenAlex ID, DOI, PMID, PMCID or MAG ID. |
byAuthorIds | Every work by an author ID or ORCID. |
byVenueIds | Every work in a journal / repository / conference source ID or ISSN. |
byInstitutionIds | Every work with an author affiliated to an institution ID or ROR. |
What each work record contains
- Identifiers:
openalexId,doi,pmid,pmcid,magId,openalexUrl - Bibliographic:
title,publicationDate,publicationYear,type,language,biblio(volume/issue/pages) - Citations:
citedByCount,referencedWorksCount,fwci,citationPercentile,citedByPercentileYear,countsByYear - Open access:
isOa,openAccessStatus(diamond/gold/green/hybrid/bronze/closed),openAccessOaUrl,bestOaUrl,anyRepositoryHasFulltext,oaLocations[](every OA landing page/PDF with license, version and source),contentUrls(OpenAlex PDF and Grobid TEI when cached) - Authors:
authorships[]with author ID, ORCID, position, corresponding flag, raw name, institution names, institution details and countries; scalarprimaryAuthor - Topics:
primaryTopic,topics[](topic → subfield → field → domain),keywords[],sdgs[], plus legacyconcepts[] - Abstract: reconstructed readable text from OpenAlex's inverted index
- Flags:
isRetracted,isParatext,isPulled,isXpac,isTraditional,hasFulltext,hasContent - Cost data:
apcPaid,apcList - Citation mode only:
citationContext(seedWorkId,seedDoi,seedTitle,direction) - Meta:
recordType,scrapedAt
Opt in to referencedWorks / relatedWorks ID arrays and citedByApiUrl with includeCitationIds=true.
Author rows carry openalexId, name, fullName, orcid, worksCount, citedByCount, summaryStats (h-index, i10-index, 2-year mean citedness), affiliations[], lastKnownInstitutions, topics[], nameAlternatives, worksApiUrl, recordType and scrapedAt.
Inputs
| Field | Default | Notes |
|---|---|---|
mode | searchWorks | One of the nine modes above. |
searchQuery | large language models | Used by searchWorks / searchAuthors. OpenAlex Boolean syntax is supported. |
searchField | default | title, titleAbstractKeywords, titleAndAbstract, abstract or fulltext for cheaper scoped searches. |
workIds | – | Work IDs/DOIs/PMIDs for direct lookup and citation seeds. |
authorIds / venueIds / institutionIds | – | IDs, ORCIDs, ISSNs or RORs for the matching lookup modes. |
citationDirection | both | citations, references or both for getCitationGraph. |
publicationYearMin / publicationYearMax | – | Server-side publication-year range. |
minCitedBy | – | Server-side citation floor; 0 means no minimum. |
openAccessOnly | false | Server-side OA filter. |
oaStatus | any | diamond, gold, green, hybrid, bronze or closed. |
hasFulltextOnly | false | Only works with searchable full text. |
workType | any | Article, book, dataset, preprint, review, etc. |
sortBy | relevance_score:desc | Citation/date/year/FWCI sorts; filter-only modes fall back to most cited. |
perPage | 50 | 1–100 records per API page. |
startPage | 1 | Resume page paging. Page × perPage must stay within 10,000. |
useCursor | false | Optional cursor paging; needs the optional free API key. |
startCursor | — | Cursor value to resume a cursor-paged run. |
customFilter | – | Extra raw OpenAlex filter, e.g. language:en,is_retracted:false. |
includeAbstract / includeAuthorships / includeConcepts | true | Toggle those blocks. |
includeTopics | true | Current topics, keywords and SDGs. |
includeOpenAccessLocations | true | All OA copies plus full-text links. |
includeCitationIds | false | Referenced/related ID arrays and cited-by API URL. |
userAgentEmail | apify-actor@noreply.apify.com | Contact address for OpenAlex's polite pool. |
apiKey | empty | Optional free key from openalex.org/settings/api; never required. |
maxItems | 50 | Hard cap, 1–10,000. |
Legacy saved-task keys are mapped in code, not kept in the input form: query/searchTerm → searchQuery, ids/dois → workIds, authorId → authorIds, venueId → venueIds, institutionId → institutionIds, maxResults/limit → maxItems, fromYear/toYear → publication-year bounds, minCitations → minCitedBy, oaOnly/openAccess → openAccessOnly, type → workType, sort → sortBy, email/mailto → userAgentEmail, includeAbstracts → includeAbstract. A legacy key wins when the new field still holds its schema default, so old tasks keep their saved limits and filters.
Examples
Top-cited open-access 2024 articles:
{"mode": "searchWorks","searchQuery": "large language models","publicationYearMin": 2024,"minCitedBy": 50,"openAccessOnly": true,"workType": "article","sortBy": "cited_by_count:desc","maxItems": 100}
Forward citations of a paper:
{"mode": "getCitations","workIds": ["W2741809807"],"sortBy": "cited_by_count:desc","maxItems": 50}
Both directions with OA copies:
{"mode": "getCitationGraph","workIds": ["https://doi.org/10.7717/peerj.4375"],"citationDirection": "both","includeOpenAccessLocations": true,"maxItems": 100}
Browse every 2024 open-access review without a keyword:
{"mode": "searchWorks","publicationYearMin": 2024,"publicationYearMax": 2024,"openAccessOnly": true,"workType": "review","maxItems": 200}
Pagination
Page paging is the default and needs no key. startPage resumes a page-paged run; the first 10,000 results are reachable. Cursor paging (useCursor=true) follows OpenAlex next_cursor values beyond that and needs the optional free API key. startCursor resumes a cursor-paged run. The actor stops only on maxItems, source exhaustion, or the cursor/page limit — never on a wall-clock timer.
OpenAlex API budget
OpenAlex is free but its anonymous list/search calls share a small daily budget per IP. Single-record lookups (the default prefill) are free. For heavy use, add a free API key from openalex.org/settings/api; it raises the daily budget and enables cursor paging. The actor treats the key as optional and never requires it.
FAQ
Do I need an API key? No. Everything works without one. A free key only helps with very large runs and cursor paging.
Why is an abstract sometimes missing? OpenAlex omits it when the publisher's license does not allow redistribution. The row still contains the work; only the abstract field is omitted.
Why does the citation count differ from Google Scholar? OpenAlex matches reference lists to records in its index. Unmatched references are left out, so counts are usually lower than a publisher PDF's reference list.
What is fwci? Field-Weighted Citation Impact: citations received divided by the field-year-type average. 1.0 is the world average.
Why are some OA fields missing? OpenAlex only emits OA evidence when it has found a free copy. Closed works have isOa=false and no OA locations; fields are omitted rather than set to null.
Can I get the full text? contentUrls.pdf and contentUrls.grobidXml point to OpenAlex's cached copies for works where hasFulltext is true; oaLocations lists publisher and repository copies.
Is this affiliated with OpenAlex? No. It is an independent third-party actor that reads OpenAlex's public API. OpenAlex is run by OurResearch.