Classic Chess · REST API

Annotated books

Annotated books are exposed as complete book catalogs, paginated game lists, full annotated game detail, and all-games PGN exports.

GET /api/v1/annotated/books/

List all annotated books and source metadata in one response. Use format=txt for titles only; JSON is the default and includes links to games, PGN, and available book downloads.

GET /api/v1/annotated/books/{book_slug}/games/

Paginated games for one annotated book.

GET /api/v1/annotated/books/{book_slug}/games/{game_slug}/

One annotated game with PGN and public-domain annotation notes.

GET /api/v1/annotated/books/{book_slug}/games/{game_slug}/gif/

Animated GIF of one annotated game. Needs a registered account, like every GIF export; add orientation=black to flip the board, or format=mp4 for an MP4 video.

GET /api/v1/annotated/books/{book_slug}/pgn/

All games in one annotated book as a PGN bundle.