Reef AI: ask for any data. Try it
Crossref API

Crossref DOI metadata as JSON: titles, authors, publishers, journals, record types and citation counts

endpoint
1
credit per call
1

The Crossref API returns Crossref's DOI metadata as JSON: for each record the DOI, title, authors, journal or book title with ISSN, publisher, publication year and date, record type (journal article, book chapter, preprint, dataset, proceedings article and more), license, funders, volume, issue and first page, a full-text link where the publisher deposited one, and the Crossref citation count (is-referenced-by).

/crossref/v1

  • POST/crossref/v1/search1 credit
1 active endpoint. Every call is 1 credit.Every parameter ↓OpenAPI 3.0 spec ↗

1 credit per call≈ $1/1,000 calls1,000 free credits, no card

Get a free API key
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

Crossref API

1 of 1 endpoints, ready to run

View docs ↗

Crossref records for a keyword: DOI, title, authors, publisher, venue, year, type, citations

1 credit1 required · 3 optional
POST/crossref/v1/search
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

Try every endpoint in the playground

Endpoints

What Crossref endpoints does ReefAPI ship?

1 live read endpoint. Read-only data API: no writes, no account actions, no dashboard access on the target site.

  • search

    1 cr

    Search Crossref's DOI metadata by free text, with an optional raw Crossref filter and offset…

    required
    query
    optional
    per_page, filter

Every parameter, every allowed value →

Missing a Crossref endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the Crossref API works

Crossref is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 746 engines.

Call02
POST /crossref/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

Pay03
1 credit per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

From a keyword to journal articles with DOIs

Search Crossref, narrow to the record types you want with a filter, then page with offset.

01search
POST/crossref/v1/search
{"query": "crispr gene editing", "per_page": 25}

On 2026-11-21: 1,051,076 matching records; 25 of 25 with DOI, publisher and the Crossref citation count, and a mix of types (5 journal articles, 5 book chapters, 5 preprints, 4 datasets and others).

02search
POST/crossref/v1/search
{"query": "crispr gene editing", "filter": "type:journal-article,from-pub-date:2024-01-01", "per_page": 100}

Journal articles published since 2024 only; the filter is passed to Crossref as written.

03search
POST/crossref/v1/search
{"query": "crispr gene editing", "filter": "type:journal-article,from-pub-date:2024-01-01", "per_page": 100, "offset": 100}

The next 100 (offset 0 to 10,000). Old calls to POST /academic/v1/search with source crossref keep working unchanged; the call for Crossref is POST /crossref/v1/search.

A dated list of DOIs with titles, authors, publishers, venues and citation counts, ready to resolve or to enrich with abstracts and open-access links on the OpenAlex API.

request
curl -X POST https://api.reefapi.com/crossref/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"crispr","per_page":10}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "crossref",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

What a Crossref field actually contains

Fields that read differently from how they look. Measured on a live search for "crispr gene editing" (25 results) on 2026-11-21, plus the parameter rules of the action.

Field or inputWhat it holds
doi, idThe DOI, the same in both fields (10.1007/978-981-99-8529-6_28). Present on 25 of 25.
typeCrossref's record type: journal-article 5, book-chapter 5, posted-content 5 (preprints), dataset 4, component 2, database 1, proceedings-article 1, book 1, peer-review 1 on the 25 results.
component DOIsParts of an article registered on their own, such as 10.7554/elife.44452.031 (eLife). They come back as rows next to articles; filter type:journal-article removes them.
cited_by_countCrossref's is-referenced-by count: how many Crossref-registered works cite the DOI. Present on 25 of 25, 0 to 34 on these rows.
venuename (journal or book title), ISSN, type and publisher. Publisher on 25 of 25, venue name on 15: encyclopedia entries and some datasets have none.
year, publication_dateEmpty on 7 of 25 (records deposited without a date, such as the AccessScience entries).
authors[]Names as deposited; on 18 of 25. The AccessScience encyclopedia entries had none.
license, fundersLicense links where the publisher deposited them (10 of 25). Funders were empty on 25 of 25.
abstractOnly where the publisher deposited one: 2 of 25.
filterA Crossref filter string, passed to Crossref as written; several filters are comma-separated: type:journal-article,from-pub-date:2024-01-01.
offset, per_pageoffset 0 to 10,000, per_page 1 to 200. There is no sort option.

is_oa and oa_url are not filled from Crossref (null on 25 of 25); the OpenAlex API returns open-access status for the same DOI.

Coverage

Crossref coverage, measured

Every number below comes from a live search for "crispr gene editing" (25 results) on 2026-11-21, answered in 1.1 seconds.

Size

1,051,076 Crossref records matched "crispr gene editing".

Fields

DOI, title, record type, publisher and the Crossref citation count (is-referenced-by, 0 to 34 on these rows) on 25 of 25. Authors on 18, publication year on 18, journal or book title on 15, license on 10, a full-text link on 4, abstract on 2. Funders were empty on 25 of 25.

Record types

Crossref registers DOIs for more than articles: 5 journal articles, 5 book chapters, 5 posted content (preprints), 4 datasets, 2 components (parts of an eLife article, e.g. 10.7554/elife.44452.031), 1 database, 1 proceedings article, 1 book and 1 peer review. filter type:journal-article keeps articles only.

Ranking

Results come in Crossref's relevance order with no sort option: the top rows were McGraw-Hill AccessScience encyclopedia entries (type dataset) titled "CRISPR/Cas9 gene editing", not the most cited papers.

Limits

Abstracts are rare in Crossref (2 of 25) and open-access status is not returned (is_oa null). For abstracts, open-access PDFs and citation graphs look the DOI up on the OpenAlex API (/openalex-api).

Use cases

What people build with Crossref

The jobs this data is most often used for.

01

Find the DOI, publisher and venue of articles, books and chapters by keyword.

02

Check reference lists against Crossref metadata.

03

Count Crossref citations for a set of publications.

04

Collect publishers' records of a given type and date range with filters.

1

endpoints

1

credit per call

Pricing

What Crossref data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 1,000 free credits on signup, no card
  • One key, all 746 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/crossref/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"crispr","per_page":10}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

r = requests.post(
    "https://api.reefapi.com/crossref/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
        "query": "crispr",
        "per_page": 10
    },
    timeout=90,
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Crossref.

Is there a Crossref API?▾

Yes. The Crossref API on ReefAPI searches Crossref's DOI metadata and returns title, authors, journal or book, publisher, year, DOI, record type, license and citation count as JSON with one ReefAPI key. Call POST /crossref/v1/search.

How many records can I search?▾

All of Crossref's DOI metadata: "crispr gene editing" alone matched 1,051,076 records on 2026-11-21. Pages hold 1 to 200 records; offset pages up to 10,000.

Why do I get datasets, book chapters and figures, not only papers?▾

Crossref registers a DOI for every kind of scholarly item. The first 25 results for "crispr gene editing" on 2026-11-21 were 5 journal articles, 5 book chapters, 5 preprints, 4 datasets, 2 article components and 4 other types. Add filter type:journal-article to keep articles only.

Does it return citation counts?▾

Yes, Crossref's own count of citing works (is-referenced-by) on every record: 25 of 25 on 2026-11-21. For the list of citing papers use citations on the OpenAlex API.

Does it return abstracts?▾

Only where the publisher deposited one with Crossref: 2 of 25 results on 2026-11-21. The OpenAlex API returns abstracts for many more DOIs.

Can I filter by date or type?▾

Yes. filter takes a Crossref filter string as written, for example type:journal-article,from-pub-date:2024-01-01. Results come in Crossref's relevance order; there is no sort option.

Do old academic calls still work?▾

Yes. POST /academic/v1/search with source crossref keeps working unchanged. For Crossref the call is now POST /crossref/v1/search, without the source parameter.

What is the Crossref API?▾

Crossref API is a ReefAPI endpoint group for crossref doi metadata search as json: title, authors, journal or book, publisher, year, doi, record type, license and the crossref citation count. It returns live JSON through POST requests under /crossref/v1.

Is the Crossref API free to try?▾

Yes. ReefAPI starts with 1,000 free credits, no card required. Crossref calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Crossref login or account?▾

No login to Crossref is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Crossref data?▾

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Crossref API use?▾

Crossref actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Crossref from an AI assistant or MCP client?▾

Yes. Connect ReefAPI once through MCP and your assistant can call crossref actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Crossref API a Crossref scraper?▾

It is the managed alternative to a DIY Crossref scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same crossref doi metadata search as json: title, authors, journal or book, publisher, year, doi, record type, license and the crossref citation count back as clean JSON.

Same key

47 Media, Film & Knowledge APIs on the same key

One key, one credit pool, one response envelope. If you are pulling Crossref, you are one call away from the rest of the category — no second contract, no second integration.

Contact

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 745 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-21.