{"note":"OpenAPI conversion -- returning structured metadata","name":"isbndb-com","description":"ISBNdb API","version":"1.0.1","base_url":"https://api.isbndb.com","endpoints":10,"raw":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api ISBNdb API\n@base https://api.isbndb.com\n@version 1.0.1\n@auth ApiKey x-api-key in header\n@endpoints 10\n@toc author(1), authors(1), book(1), books(1), publisher(1), publishers(1), search(1), stats(1), subject(1), subjects(1)\n\n@group author\n@endpoint GET /author/{name}\n@desc Gets author details\n@required {name: any # The name of an author in the Author's database}\n@optional {page: any # The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them, pageSize: any # How many items should be returned per page, maximum of 1,000}\n@returns(200) The author name was found in the database\n@errors {404: Author not found}\n\n@endgroup\n\n@group authors\n@endpoint GET /authors/{query}\n@desc Search authors\n@required {query: any # A string to search for in the Author’s database}\n@optional {pageSize: any # How many items should be returned per page, maximum of 1,000, page: any # The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them}\n@returns(200) The query string found results in the author's database\n@errors {404: There are no results in the author's database for the given query}\n\n@endgroup\n\n@group book\n@endpoint GET /book/{isbn}\n@desc Gets book details\n@required {isbn: any # an ISBN 10 or ISBN 13 in the Books database}\n@returns(200) The book ISBN was found in the database\n@errors {404: Book not found}\n\n@endgroup\n\n@group books\n@endpoint GET /books/{query}\n@desc Search books\n@required {query: any # A string to search for in the Book’s database}\n@optional {page: any # The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them, author: any # Filters the query results by author, pageSize: any # How many items should be returned per page, maximum of 1,000}\n@returns(200) The query string found results in the books's database\n@errors {404: There are no results in the book's database for the given query}\n\n@endgroup\n\n@group publisher\n@endpoint GET /publisher/{name}\n@desc Gets publisher details\n@required {name: any # The name of a publisher in the Publisher's database}\n@optional {page: any # The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them, pageSize: any # How many items should be returned per page, maximum of 1,000}\n@returns(200) The publisher name was found in the database\n@errors {404: Publisher not found}\n\n@endgroup\n\n@group publishers\n@endpoint GET /publishers/{query}\n@desc Search publishers\n@required {query: any # A string to search for in the Publisher’s database}\n@optional {pageSize: any # How many items should be returned per page, maximum of 1,000, page: any # The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them}\n@returns(200) The query string found results in the publisher's database\n@errors {404: There are no results in the publisher's database for the given query}\n\n@endgroup\n\n@group search\n@endpoint GET /search\n@desc Search all ISBNDB databases\n@optional {q: any # A query string compatible with ElasticSearch 6}\n@returns(200) Results were found in the requested database\n@errors {404: No results found in the requested database}\n\n@endgroup\n\n@group stats\n@endpoint GET /stats\n@desc Gets status on the ISBNDB Database\n@returns(200) Stats on the ISBNDB sucessfully retrieved\n\n@endgroup\n\n@group subject\n@endpoint GET /subject/{name}\n@desc Gets subject details\n@required {name: any # A subject in the Subject's database}\n@returns(200) The subject was found in the database\n@errors {404: Subject not found}\n\n@endgroup\n\n@group subjects\n@endpoint GET /subjects/{query}\n@desc Search subjects\n@required {query: any # A string to search for in the Subject’s database}\n@optional {pageSize: any # How many items should be returned per page, maximum of 1,000, page: any # The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them}\n@returns(200) The query string found results in the subject's database\n@errors {404: There are no results in the subject's database for the given query}\n\n@endgroup\n\n@end\n"}