{
  "openapi": "3.0.3",
  "info": {
    "title": "Books Like This",
    "version": "1.0.0",
    "description": "Find a book and its details, get books like one the user enjoyed (or for a genre), list an author's books, and see which books have been or are being made into films and TV series. Every answer has a ready-to-read `say` line and buy links for the user's country. Read only, no account, nothing stored. Data: Open Library and Wikidata.",
    "contact": { "email": "hello@askmizan.com" }
  },
  "servers": [{ "url": "https://bookslikethis.pages.dev" }],
  "paths": {
    "/v1/book": { "get": { "operationId": "getBook", "summary": "A book's details and any film or series made from it", "description": "Use for \"tell me about Project Hail Mary\", \"is The Name of the Wind being made into a film?\", \"how long is Dune?\".", "parameters": [ { "name": "title", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "author", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "country", "in": "query", "required": false, "description": "For buy links: US, GB, IE, CA, AU. Default from the request.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Book, with screen_adaptations (title, type, released, status: out, coming or announced)" }, "404": { "description": "Not found" } } } },
    "/v1/similar": { "get": { "operationId": "findSimilarBooks", "summary": "Books like one the user enjoyed, or for a genre", "description": "Use for \"books like The Martian\" or \"a good cosy mystery\". Other books by the same author are left out unless same_author=true. Each suggestion lists the subjects it shares.", "parameters": [ { "name": "title", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "author", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "subject", "in": "query", "required": false, "description": "A genre or theme, for example space opera, cozy mystery, heist.", "schema": { "type": "string" } }, { "name": "same_author", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Suggestions" } } } },
    "/v1/author": { "get": { "operationId": "getAuthorBooks", "summary": "An author's books, newest first", "parameters": [ { "name": "author", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Books" }, "404": { "description": "Not found" } } } },
    "/v1/health": { "get": { "operationId": "health", "summary": "Service status", "responses": { "200": { "description": "OK" } } } }
  }
}