docs / books

Books & Authors

Book details, search, authors and free ebooks.

base /books/v14 endpoints

post/books/v1/book_detail1 credit

merged book record by ISBN-10/13 or OLID (work OL..W / edition OL..M): title/authors/covers/subjects/description/pages/publishers/languages/editions/identifiers/ratings+distribution/reading-log; queried ISBN always injected

Parameter	Required
id	required

Try in playground →

post/books/v1/search1 credit

search books: q OR fielded (title/author/subject/publisher/place/person/isbn/language); rich cards (ratings/reading-log/ebook_access/IA); sort=new|old|rating|want_to_read|editions; pagination

Parameter	Required
q	optional
query	optional
title	optional
author	optional
subject	optional
publisher	optional
place	optional
person	optional
isbn	optional
language	optional
sort	optional
limit	optional
per_page	optional
page	optional

Try in playground →

post/books/v1/author1 credit

author by OLID (OL..A) → bio/photo/dates/alternate-names/remote-ids(goodreads/wikidata/viaf/gutenberg)/links + include_works; or query/name → best-match-ranked author list

Parameter	Required
id	optional
query	optional
name	optional
q	optional
include_works	optional
works_limit	optional
per_page	optional
limit	optional

Try in playground →

post/books/v1/ebook1 credit

public-domain full-text (Gutenberg via Gutendex): query OR id=Gutenberg-id OR ids=batch; filters languages/topic/sort; returns formats{epub/txt/html/kindle/cover}+download_url+read_url; gutenberg.org OPDS fallback when gutendex is down

Parameter	Required
query	optional
search	optional
q	optional
id	optional
gutenberg_id	optional
ids	optional
languages	optional
topic	optional
sort	optional
mime_type	optional
author_year_start	optional
author_year_end	optional
copyright	optional
limit	optional
per_page	optional
page	optional

Try in playground →

Example request · book_detail

curl -X POST https://api.reefapi.com/books/v1/book_detail \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"id":"9780439023528"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}