Bookworthy · Developers

Developers & API

Bookworthy is built for machines as well as people. These endpoints return clean JSON, are CORS-open and cached, and carry frozen response contracts — additive-only once published, so anything you build on them keeps working.

Base URL https://bookworthy.com · No key required for the read endpoints below · Pricing-bearing fields are clearly marked while exact per-copy print pricing is finalized for launch.

Endpoints

GET /api/facts

The whole fact base as JSON — site identity, mission/vision, key facts, FAQs, and the live answers/blog/pages registries. Same source as llms.txt, so it never drifts.

curl https://bookworthy.com/api/facts

GET /api/v1/specs

The live, operator-editable print specifications: bindings, trim sizes, paper/text stocks (with page-count bounds and caliper), cover stocks, lamination options, and spine limits. Use these ids to build a valid book spec.

curl https://bookworthy.com/api/v1/specs

GET /api/v1/quote

Validate a book spec and get the computed spine width and page-fit. Live print + shipping prices arrive once pricing is finalized — until then pricing.available is false (we never invent prices). The response shape is frozen: when pricing is live, the same fields return populated cents.

Query params: binding (softcover|hardcover), trim, paper, cover (ids from /api/v1/specs), interiorColor (bw|color), pages, qty, country.

curl "https://bookworthy.com/api/v1/quote?binding=hardcover&trim=hard-6x9&paper=offset-50&cover=hard-12pt-c1s&interiorColor=bw&pages=240&qty=1&country=US"

Plain-text / markdown surfaces

For retrieval and RAG, every public page is also available as markdown, and the whole site as one document:

On the roadmap

Authenticated publish endpoints (POST /api/v1/books) and an MCP server so agents can quote, validate, and publish books directly are designed and coming. Want early access or have a use case? Get in touch at launch →