Service metadata

Code snippets

curl "https://api.oanor.com/bookstats-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/bookstats-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/bookstats-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/bookstats-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "Look up a book by its Open Library work id (work=OL27448W) or by title (title=the hobbit). Reading-log counts (want-to-read, currently-reading, already-read) come from the community's bookshelves.",
        "source": "Open Library public API (openlibrary.org, live)",
        "service": "bookstats-api",
        "endpoints": {
            "GET /v1/book": "A book's reader stats — rating distribution and reading-log counts (work=OL27448W or title=dune).",
            "GET /v1/meta": "This document.",
            "GET /v1/author": "An author's profile — work count, top work, dates (author=brandon sanderson).",
            "GET /v1/search": "Search books with ratings and want-to-read counts (q=dune)."
        },
        "description": "Live reader-community stats for books from Open Library (the Internet Archive's open book catalog). The reading-community view of a book — how readers rate it and how many want to read, are reading or have already read it. book = a title's reader stats (average rating, full 1-5 star distribution, reading-log counts, authors, year, subjects); search = search books, each with its rating and want-to-read count; author = an author's profile (work count, top work, dates). Live, no key, nothing stored. The community-engagement layer, distinct from the plain book-catalog and reading-trends APIs.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-12T01:42:15.771Z",
        "request_id": "c165aa02-df28-4430-9410-3df784882852"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}