# OpenAlex Scholarly Works API

> 250M+ scholarly works, authors and institutions: titles, citations, open access links, topics

- Vendor: `openalexscholarlyworksapi` · version 1.0 · category Science · tags openalex api, scholarly works api, citations api, research papers api, academic authors api, open access api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/openalexscholarlyworksapi
- This document: https://apiclay.com/docs/openalexscholarlyworksapi.md
- OpenAPI 3.1: https://apiclay.com/api/openalexscholarlyworksapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `openalexscholarlyworksapi`
- Updated: 2026-11-18

## About

## OpenAlex Scholarly Works API

Search OpenAlex, the open catalog of the world's research: works (papers, books, datasets) with title, year, authors and institutions, citation counts, open access status and links, topics and references; authors with works and citation counts; and institutions.

Data comes from **openalex.org** (https://openalex.org). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/works?search=climate change&amp;per-page=5`, then `/work?id=W2741809807`.

### Routes

#### GET `/works` - Search works
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| search | query | string | no | Words to search, e.g. `climate change`. |
| filter | query | string | no | OpenAlex filter, e.g. `publication_year:2025,is_oa:true`. |
| sort | query | string | no | e.g. `cited_by_count:desc`. |
| per-page | query | number | no | 1-200. |
| page | query | number | no | Page. |

Returns: `meta.count`, `results[]` with `id`, `doi`, `title`, `publication_year`, `cited_by_count`, `authorships`, `open_access`, `primary_location`, `topics`.

#### GET `/work` - Work by id
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | OpenAlex work id, e.g. `W2741809807`. |

Returns: one work.

#### GET `/authors` - Search authors
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| search | query | string | no | Author name. |
| filter | query | string | no | OpenAlex filter. |
| per-page | query | number | no | 1-200. |

Returns: `results[]` with `display_name`, `works_count`, `cited_by_count`, `last_known_institutions`.

#### GET `/institutions` - Search institutions
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| search | query | string | no | Institution name. |
| per-page | query | number | no | 1-200. |

Returns: `results[]` with `display_name`, `country_code`, `type`, `works_count`, `cited_by_count`.

### Caveats

- OpenAlex data is CC0.
- Without an OpenAlex key, calls share OpenAlex's small free daily budget per IP.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by openalex.org.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /works — Search works
- Gateway: `GET https://api.apiclay.com/v1/api/openalexscholarlyworksapi/works`
- Public query params: `search` (string), `filter` (string), `sort` (string), `per-page` (number), `page` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /work — Work by id
- Gateway: `GET https://api.apiclay.com/v1/api/openalexscholarlyworksapi/work`
- Public query params: `id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /authors — Search authors
- Gateway: `GET https://api.apiclay.com/v1/api/openalexscholarlyworksapi/authors`
- Public query params: `search` (string), `filter` (string), `per-page` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /institutions — Search institutions
- Gateway: `GET https://api.apiclay.com/v1/api/openalexscholarlyworksapi/institutions`
- Public query params: `search` (string), `per-page` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/openalexscholarlyworksapi/works" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
