OpenAlex
OpenAlex scholarly works as JSON: search with abstracts, DOIs, ORCID-tagged authors and open-access PDF links, plus citations, references, authors, institutions, journals and topics.
/openalex/v1/search1 creditSearch OpenAlex works by free text: cursor pagination, year, open-access and type filters, closest-title match, full-text search, and author/venue/institution/concept/topic id filters. Each paper: title, authors, year, venue, DOI, citation count, open-access PDF and the abstract.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Free-text search query. |
| per_page = 25 | optional | 1–200 | Results per page (1-200, default 25); clamped. |
| cursor | optional | — | OpenAlex cursor for deep pagination (use '*' for the first page, then meta.next_cursor). |
| filter | optional | — | Advanced: a raw OpenAlex filter string, appended verbatim (e.g. 'publication_year:2024,is_oa:true'). |
| sort | optional | — | OpenAlex sort key, e.g. cited_by_count:desc or publication_date:desc. |
| from_year | optional | — | Filter to papers published on or after this year. |
| to_year | optional | — | Filter to papers published on or before this year. |
| open_access = false | optional | — | If true, restrict to open-access works (is_oa:true). |
| type | optional | — | OpenAlex work type filter (e.g. article, book-chapter, dataset); passed through. |
| match = false | optional | — | If true, closest-title match (title.search) instead of relevance search (OpenAlex source only). |
| include_abstract = true | optional | — | Include reconstructed abstracts in search results (default true). |
| fulltext | optional | — | Full-text search within the paper body (OpenAlex fulltext.search). |
| author_id | optional | — | Restrict to papers by this OpenAlex author id (filter=author.id:…). A convenience over the raw `filter` string. |
| venue_id | optional | — | Restrict to papers by this OpenAlex venue/source id (filter=primary_location.source.id:…). A convenience over the raw `filter` string. |
| institution_id | optional | — | Restrict to papers by this OpenAlex institution id (filter=institutions.id:…). A convenience over the raw `filter` string. |
| concept_id | optional | — | Restrict to papers by this OpenAlex concept id (filter=concepts.id:…). A convenience over the raw `filter` string. |
| topic_id | optional | — | Restrict to papers by this OpenAlex topic id (filter=topics.id:…). A convenience over the raw `filter` string. |
/openalex/v1/paper_detail1 creditfull paper (abstract/authors/affiliations/venue/year/DOI/OA-PDF/fields); id=OpenAlex|DOI|arXiv|PMID; cross-source abstract gap-fill
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| id | required | — | Paper id — OpenAlex id (W…), OR DOI (10.…), OR arXiv id, OR PMID. |
| enrich = false | optional | — | Pull extra Crossref metadata (funders/license/references flag) for the paper. |
| raw = false | optional | — | Attach the raw OpenAlex record under paper._raw_openalex. |
| fill_abstract = true | optional | — | Gap-fill a missing OpenAlex abstract from arXiv/Crossref (default true). |
/openalex/v1/citations1 creditpapers that cite this work (cursor-paginated)
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| id | required | — | Paper id — OpenAlex id (W…), OR DOI (10.…), OR arXiv id, OR PMID. |
| per_page = 25 | optional | 1–200 | Results per page (1-200, default 25); clamped. |
| cursor | optional | — | OpenAlex cursor for deep pagination (use '*' for the first page, then meta.next_cursor). |
/openalex/v1/references1 creditworks this paper references (hydrated)
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| id | required | — | Paper id — OpenAlex id (W…), OR DOI (10.…), OR arXiv id, OR PMID. |
| limit = 50 | optional | 1–200 | Max records (1-200, default 50); clamped. |
/openalex/v1/institution1 creditinstitution search/profile: ROR, country, geo, works/citation counts, h-index; include_works for the org's papers
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| id | optional | — | OpenAlex institution id for a profile. Supply `id` OR a `query`/`name`. |
| query | optional | — | Search text → ranked list. Supply this OR `id`. |
| per_page = 10 | optional | 1–200 | Results per page (1-200, default 10); clamped. |
| include_works = false | optional | — | Profile only: also return the institution's top works (highest-cited first). |
| works_limit = 25 | optional | 1–200 | Max top works when include_works=true (1-200). |
/openalex/v1/venue1 creditjournal/venue search/profile: ISSN, publisher, OA/DOAJ, h-index, works/citation counts; include_works for the venue's papers
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| id | optional | — | OpenAlex venue/source id for a profile. Supply `id` OR a `query`/`name`. |
| query | optional | — | Search text → ranked list. Supply this OR `id`. |
| per_page = 10 | optional | 1–200 | Results per page (1-200, default 10); clamped. |
| include_works = false | optional | — | Profile only: also return the venue's top works (highest-cited first). |
| works_limit = 25 | optional | 1–200 | Max top works when include_works=true (1-200). |
/openalex/v1/concept1 creditconcept search (query) or profile (id): level, works/citation counts, description; include_works for papers. NOTE: OpenAlex froze the Concepts dataset (ancestors/related now empty) — use `topic` for the live subject hierarchy
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| id | optional | — | OpenAlex concept id for a profile. Supply `id` OR a `query`/`name`. |
| query | optional | — | Search text → ranked list. Supply this OR `id`. |
| per_page = 10 | optional | 1–200 | Results per page (1-200, default 10); clamped. |
| include_works = false | optional | — | Profile only: also return the concept's top works (highest-cited first). |
| works_limit = 25 | optional | 1–200 | Max top works when include_works=true (1-200). |
/openalex/v1/topic1 credittopic search (query) or profile (id): domain>field>subfield hierarchy, keywords, siblings, works/citation counts; include_works for papers (the live replacement for Concepts)
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| id | optional | — | OpenAlex topic id for a profile. Supply `id` OR a `query`/`name`. |
| query | optional | — | Search text → ranked list. Supply this OR `id`. |
| per_page = 10 | optional | 1–200 | Results per page (1-200, default 10); clamped. |
| include_works = false | optional | — | Profile only: also return the topic's top works (highest-cited first). |
| works_limit = 25 | optional | 1–200 | Max top works when include_works=true (1-200). |
/openalex/v1/autocomplete1 creditfast typeahead suggestions (works/authors/sources/institutions)
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| q | required | — | Typeahead prefix. |
| entity = works | optional | works · authors · sources · institutions · concepts · topics | Which entity type to autocomplete. An unknown value falls back to 'works'. |
/openalex/v1/batch2 creditshydrate up to 200 papers by id/DOI in one call (RAG/ETL)
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| ids | required | — | Up to 200 paper ids/DOIs to hydrate (list or comma-separated). |
| include_abstract = false | optional | — | Include reconstructed abstracts in the hydrated rows (default false for batch). |
| limit = 100 | optional | 1–200 | Max records (1-200, default 100); clamped. |
curl -X POST https://api.reefapi.com/openalex/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"covid"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.