{ "opencollection": "1.0.0", "info": { "name": "ISBNdb API v2 Books API", "version": "2.7.0" }, "items": [ { "info": { "name": "Books", "type": "folder" }, "items": [ { "info": { "name": "Get book details by isbn.", "type": "http" }, "http": { "method": "GET", "url": "https://api2.isbndb.com/book/:isbn", "params": [ { "name": "with_prices", "value": "", "type": "query", "description": "Whether to include prices in the response. \n\n***Available starting from Pro plan***\n\n***Performance Impact:*** Enabling this will increase response time, as current prices are fetched from vendors in real-time." }, { "name": "isbn", "value": "", "type": "path" } ], "auth": { "type": "apikey", "key": "Authorization", "value": "{{Authorization}}", "placement": "header" } }, "docs": "Returns the book details. \n \n**A 404 Not Found response for an ISBN lookup typically indicates that the book information is not yet available\nin our database. However, due to frequent updates, there is a high probability that the data will be added shortly,\noften within a minute or up to 24 hours. We recommend trying your request again after a while, as the information\nmay soon become accessible.**" }, { "info": { "name": "Search books", "type": "http" }, "http": { "method": "POST", "url": "https://api2.isbndb.com/books", "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "Authorization", "value": "{{Authorization}}", "placement": "header" } }, "docs": "\nRetrieves a list of books matching the provided array of ISBNs. This endpoint is available on all plans and does not use pagination.\n\n**Request Limits per Plan:**\n* **Academic:** Up to 10 ISBNs per request.\n* **Basic:** Up to 100 ISBNs per request.\n* **Pro, Premium, and higher:** Up to 1,000 ISBNs per request.\n\n**Quota Usage (Important):** Each requested ISBN counts as a separate API call against your daily limit. For example, a single request containing 100 ISBNs will deduct 100 calls from you" }, { "info": { "name": "Search books", "type": "http" }, "http": { "method": "GET", "url": "https://api2.isbndb.com/books/:query", "params": [ { "name": "query", "value": "", "type": "path", "description": "The search query string. **Max length: 150 characters**." }, { "name": "year", "value": "", "type": "query", "description": "Filter books by year of publication" }, { "name": "edition", "value": "", "type": "query", "description": "Filter books by edition" }, { "name": "shouldMatchAll", "value": "", "type": "query", "description": "If set to `1` or `true`, the API will return books where the title \n or author exactly contains all the words entered by the user." }, { "name": "column", "value": "", "type": "query", "description": "Search limited to this column:\n* `` - Empty value search in every column\n* `title` - Only searches in Books Title\n* `author` - Only searches books by the given Author\n* `date_published` - Only searches books in a given year, e.g. 1998\n* `subjects` - Only searches books by the given subject, e.g. physics" }, { "name": "language", "value": "", "type": "query", "description": "Language code to filter books by language (e.g., `eng` for English, `fra` for French, etc.)" }, { "name": "page", "value": "", "type": "query", "description": "The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them" }, { "name": "pageSize", "value": "", "type": "query", "description": "How many items should be returned per page, maximum of 1,000" }, { "name": "publishedFrom", "value": "", "type": "query", "description": "Filter books published on or after this date. Accepted formats: `YYYY`, `YYYY-MM`, `YYYY-MM-DD`. Cannot be combined with the `year` parameter." }, { "name": "publishedTo", "value": "", "type": "query", "description": "Filter books published on or before this date. Accepted formats: `YYYY`, `YYYY-MM`, `YYYY-MM-DD`. Cannot be combined with the `year` parameter." } ], "auth": { "type": "apikey", "key": "Authorization", "value": "{{Authorization}}", "placement": "header" } }, "docs": "This returns a list of books that match the query.\n\n**This endpoint does not return pricing information.**" } ] } ], "bundled": true }