{"files":{"SKILL.md":"---\nname: isbndb-api\ndescription: \"ISBNdb API skill. Use when working with ISBNdb for author, authors, book. Covers 10 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# ISBNdb API\nAPI version: 1.0.1\n\n## Auth\nApiKey x-api-key in header\n\n## Base URL\nhttps://api.isbndb.com\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /search -- verify access\n\n## Endpoints\n\n10 endpoints across 10 groups. See references/api-spec.lap for full details.\n\n### author\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /author/{name} | Gets author details |\n\n### authors\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /authors/{query} | Search authors |\n\n### book\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /book/{isbn} | Gets book details |\n\n### books\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /books/{query} | Search books |\n\n### publisher\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /publisher/{name} | Gets publisher details |\n\n### publishers\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /publishers/{query} | Search publishers |\n\n### search\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /search | Search all ISBNDB databases |\n\n### stats\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /stats | Gets status on the ISBNDB Database |\n\n### subject\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /subject/{name} | Gets subject details |\n\n### subjects\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /subjects/{query} | Search subjects |\n\n## Common Questions\n\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Get author details?\" -> GET /author/{name}\n- \"Search authors?\" -> GET /authors/{query}\n- \"Get book details?\" -> GET /book/{isbn}\n- \"Search books?\" -> GET /books/{query}\n- \"Get publisher details?\" -> GET /publisher/{name}\n- \"Search publishers?\" -> GET /publishers/{query}\n- \"Search search?\" -> GET /search\n- \"List all stats?\" -> GET /stats\n- \"Get subject details?\" -> GET /subject/{name}\n- \"Search subjects?\" -> GET /subjects/{query}\n- \"How to authenticate?\" -> See Auth section\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- List endpoints may support pagination; check for limit, offset, or cursor params\n\n## CLI\n\n```bash\n# Update this spec to the latest version\nnpx @lap-platform/lapsh get isbndb-api -o references/api-spec.lap\n\n# Search for related APIs\nnpx @lap-platform/lapsh search isbndb-api\n```\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@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"}}