# BookLink.fyi

> Universal book links. One URL per book that shows every place to get it —
> new, used, ebook, audiobook, libraries, and free/public-domain sources.
> Free to link to and integrate with. No account or API key needed for basic use.

If you are an AI agent helping someone integrate BookLink.fyi into their site or
app, read the developer guide first: https://booklink.fyi/developers.md

## Link to a book (no API needed)

- By ISBN (preferred): `https://booklink.fyi/isbn/{isbn10-or-13}` — redirects to the book's page.
- By title/author when you have no ISBN: `https://booklink.fyi/search?q={title}+{author}` (URL-encoded).
- From any retailer URL (Amazon, Bookshop, Barnes & Noble, Goodreads, …): `https://booklink.fyi/resolve?url={encoded-url}`.
- Canonical page: `https://booklink.fyi/book/{slug}` — short form `https://booklink.fyi/b/{slug}`.

Use these as normal links that a person clicks. Do not prefetch or crawl them:
`/search`, `/isbn/`, `/resolve`, `/go/` and `/api/` are disallowed for crawlers.

## JSON API

Base `https://booklink.fyi/api/v1` · CORS open · no auth required ·
20 requests/min per IP anonymous, 120/min with an `X-API-Key` header.
Always send `source=app-{yourname}`.

- `GET /resolve?url={retailer-url}` → `{status, booklink_url, short_url, title, authors, cover_url, isbn}`
- `GET /search?q={text}&limit={1-20}` → `{status, results:[{title, authors, cover_url, isbn, published_date, search_url}]}`
- Full schema: https://booklink.fyi/openapi.json

## Not available yet

Using your own affiliate tags on BookLink's retailer links, a JSON endpoint that
returns a book's retailer links, and an embeddable widget are planned. If you
want them, say so: hello@booklink.fyi

## More

- [Developer guide (markdown)](https://booklink.fyi/developers.md)
- [Developer guide (HTML)](https://booklink.fyi/developers)
- [OpenAPI schema](https://booklink.fyi/openapi.json)
- [About / affiliate disclosure](https://booklink.fyi/about)