OpenAlex Citation & Open-Access Works Explorer avatar

OpenAlex Citation & Open-Access Works Explorer

Pricing

from $0.49 / 1,000 results

Go to Apify Store
OpenAlex Citation & Open-Access Works Explorer

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

vexaloom-labs

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

13 hours ago

Last modified

Features

Limited permissions

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

ModeWhat it returns
searchWorksWorks 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.
getCitationsWorks that cite each seed work (forward citations).
getReferencesWorks each seed work cites (backward citations / references).
getCitationGraphBoth directions for each seed, with a citationContext on every row.
searchAuthorsAuthor profiles: ORCID, works/citation counts, h-index, affiliations, topics.
byWorkIdsFetch specific works by OpenAlex ID, DOI, PMID, PMCID or MAG ID.
byAuthorIdsEvery work by an author ID or ORCID.
byVenueIdsEvery work in a journal / repository / conference source ID or ISSN.
byInstitutionIdsEvery 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; scalar primaryAuthor
  • Topics: primaryTopic, topics[] (topic → subfield → field → domain), keywords[], sdgs[], plus legacy concepts[]
  • 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

FieldDefaultNotes
modesearchWorksOne of the nine modes above.
searchQuerylarge language modelsUsed by searchWorks / searchAuthors. OpenAlex Boolean syntax is supported.
searchFielddefaulttitle, 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.
citationDirectionbothcitations, references or both for getCitationGraph.
publicationYearMin / publicationYearMax–Server-side publication-year range.
minCitedBy–Server-side citation floor; 0 means no minimum.
openAccessOnlyfalseServer-side OA filter.
oaStatusanydiamond, gold, green, hybrid, bronze or closed.
hasFulltextOnlyfalseOnly works with searchable full text.
workTypeanyArticle, book, dataset, preprint, review, etc.
sortByrelevance_score:descCitation/date/year/FWCI sorts; filter-only modes fall back to most cited.
perPage501–100 records per API page.
startPage1Resume page paging. Page × perPage must stay within 10,000.
useCursorfalseOptional 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 / includeConceptstrueToggle those blocks.
includeTopicstrueCurrent topics, keywords and SDGs.
includeOpenAccessLocationstrueAll OA copies plus full-text links.
includeCitationIdsfalseReferenced/related ID arrays and cited-by API URL.
userAgentEmailapify-actor@noreply.apify.comContact address for OpenAlex's polite pool.
apiKeyemptyOptional free key from openalex.org/settings/api; never required.
maxItems50Hard 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.