Example costs

OpenAlex data is free; what costs money is usage of the API. This page makes that concrete: the per-operation rate, what a day of free usage buys, and what a few common activities cost. For how billing and plans work, see Pricing; for the API mechanics of sending a key and tracking your usage, see Authentication.

What each operation costs

Tip: Use per_page=100 to load many results per query — it makes your budget go much further.

OperationDescriptionCost per 1,000 calls
Get single entityRetrieve one entity by ID or DOIFree
List + filterQuery and filter entities (filters that don’t search)$0.10
SearchFull-text keyword search: the search parameter, or any .search filter (default.search, title.search…)$1
Group byCounts by a field (group_by=), on a list or a search$0.10 on a list, $1 on a search
RerankAdd-on: the top 100 results reordered by relevance (rerank=true)+$1 (a reranked search: $2)
Semantic searchAI-powered semantic search$1
Content downloadCached PDF via the content API$10
Text / Aboutness (deprecated)Topic classification$10

Note: Rerank adds 10 credits ($0.001) to each page it reranks. A search costs 10 credits; with rerank=true it costs 20. A page past result 100 keeps the normal order and costs what it costs without rerank. The add-on is the same on an OQL request. openalex.org reranks its searches by default, and so do the Claude and ChatGPT connectors, so a search there costs 20 credits plus whatever else the page loads.

What an OQL calculation costs

An OQL table of groups (get the count of works ... by ...), and anything in OQL’s general form, is priced from what it does, step by step:

StepCreditsCost
The set of works, defined by filters only1$0.0001
The set of works, defined by a search10$0.001
Each lookup of the groups’ own records (by author at [X], with an h-index above 20, Show h-index, co-author is not)1$0.0001
Each compared search (compare title-abstract has "a" versus "b")10$0.001
Walks and sets: each extra call they need1$0.0001

Each compared search costs what that search costs on its own, so a query that compares three searches costs the same as running the three searches. Nothing else adds to the price: splits, counts, means, shares and percentages are free. A list (get works ..., get authors ...) costs what the same query costs as a URL: 1 credit, or 10 with a search.

QueryCreditsCost
get the count of [Kenya](KE)'s works by year1$0.0001
get the count and percent open access of works about "climate change" by year since 202010$0.001
get the count of works about kelp by author with an h-index above 20. Only authors with more than 10 works about kelp.11$0.0011
get the count of works about kelp by author at [University of British Columbia](I141945490) since 2022. Show h-index.12$0.0012
get works where published since 2010; then, compare title-abstract has "a" versus "b" versus "c" using count31$0.0031
get works where institution is [University of Kansas](I146416000) and published in 2023; then, get each author of those works; then, get all that author's works; finally, summarize each author using mean FWCI11$0.0011

Check the price before you run. The /query endpoint is free and reports a query’s price, step by step, in check.cost. A response reports what the query cost in meta.cost and in the X-RateLimit-Credits-Used header. A query that costs more than you have left today is refused before it runs, and refusals are free.

What your free daily budget buys

Every account gets $1 of usage per day for free. With that $1 you can do a mix of:

ActionCallsResultsExample
Get a single entityUnlimitedUnlimitedLook up a work by DOI
List + filter10,0001,000,000All works from MIT in 2024
Search1,000100,000Full-text search for “CRISPR”
Search with rerank50050,000The same search, top 100 reordered by relevance
Content download100100 PDFsDownload a paper’s full text

Without a key you get $0.10/day — a tenth of the above, enough to try the API. A free API key gives you 10× that. Need more than $1/day? Paid plans raise your daily budget, and prepaid usage covers anything beyond it.

What common activities cost

ActivityEndpointCallsResultsCost
Search “climate change AND kelp”Search10310,205$0.10
All works from HarvardList + filter8,707870,627$0.87
Retrieve works by DOI from a listSingleton1,000,0001,000,000Free
Daily research (20 searches, 200 filters, 50 lookups)Mixed270~27,000$0.04
Download 1,000 PDFsContent1,0001,000 PDFs$10.00

Note: The openalex.org website runs on this same API, so browsing it draws from the same budget (anonymous browsing uses the $0.10/day no-key budget; sign in for $1/day). Viewing a single record’s page (one work, author, source) is free, but a search or a results page loads several billable calls — the list of results plus its facets and charts. So one website search costs more than one API call: a programmatic /works?search= call is 10 credits, while one search on the website is roughly 28 (the search, reranked at 20 credits, plus ~5 facet/chart calls). Those facet counts cost 1 credit each on the website, though a group_by on a search costs 10 through the API. “$1/day ≈ 1,000 searches” holds for direct API calls; browsing the website is about 2.8× costlier per search (closer to ~360/day). A prepaid balance covers anything beyond your daily budget.

Last updated

View as Markdown