# Crossref Scholarly Metadata API

> Metadata for 160M+ research papers, books and datasets: search works, DOIs, journals, funders

- Vendor: `crossrefscholarlymetadataapi` · version 1.0 · category Science · tags crossref api, doi lookup api, research paper metadata api, citation data api, journal search api, scholarly works api, funder data api, academic search api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/crossrefscholarlymetadataapi
- This document: https://apiclay.com/docs/crossrefscholarlymetadataapi.md
- OpenAPI 3.1: https://apiclay.com/api/crossrefscholarlymetadataapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `crossrefscholarlymetadataapi`
- Updated: 2026-11-18

## About

## Crossref Scholarly Metadata API

Search and fetch metadata for 160M+ scholarly works registered with Crossref (journal articles, books, conference papers, datasets): titles, authors, dates, references, citation counts, licenses and funders.

Data comes from **crossref.org** (https://www.crossref.org). Every route below calls the source's own public endpoint directly and returns the upstream response unchanged.

### Routes

#### GET `/works` - Search works
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| query | query | string | no | Free text, e.g. `food delivery`. |
| filter | query | string | no | e.g. `from-pub-date:2024-01-01,type:journal-article`. |
| rows | query | number | no | Up to 1000 (default 20). |
| offset | query | number | no | Offset. |
| sort | query | string | no | e.g. `published`, `is-referenced-by-count`. |
| order | query | string | no | `asc` or `desc`. |
| select | query | string | no | Fields, e.g. `DOI,title,author`. |

Returns: `message.total-results`, `message.items[]` with `DOI`, `title`, `author`, `published`, `container-title`, `is-referenced-by-count`.

#### GET `/work` - One work by DOI
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| doi_prefix | path | string | yes | DOI part before the first `/`, e.g. `10.1037`. |
| doi_suffix | path | string | yes | DOI part after it, e.g. `0003-066X.59.1.29`. |

For a DOI whose suffix itself contains `/`, use `/works` with `filter=doi:`.

Returns: `message` with the full record incl. `reference[]`, `license[]`, `funder[]`.

#### GET `/journals` - Search journals
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| query | query | string | no | e.g. `nutrition`. |
| rows | query | number | no | Rows. |
| offset | query | number | no | Offset. |

#### GET `/funders` - Search funders
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| query | query | string | no | e.g. `usda`. |
| rows | query | number | no | Rows. |
| offset | query | number | no | Offset. |

### License

Crossref metadata is free to reuse (facts are not copyrightable; Crossref applies no restrictions).

### Caveats

- Abstracts are included only when the publisher deposited them.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by crossref.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/crossrefscholarlymetadataapi/works`
- Public query params: `query` (string), `filter` (string), `rows` (string), `offset` (string), `sort` (string), `order` (string), `select` (string)
- 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 DOI
- Gateway: `GET https://api.apiclay.com/v1/api/crossrefscholarlymetadataapi/work`
- Public query params: `doi_prefix` (string, required), `doi_suffix` (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 /journals — Search journals
- Gateway: `GET https://api.apiclay.com/v1/api/crossrefscholarlymetadataapi/journals`
- Public query params: `query` (string), `rows` (string), `offset` (string)
- 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 /funders — Search funders
- Gateway: `GET https://api.apiclay.com/v1/api/crossrefscholarlymetadataapi/funders`
- Public query params: `query` (string), `rows` (string), `offset` (string)
- 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/crossrefscholarlymetadataapi/works" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

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