{ "item": [ { "id": "8d26c9f3-c5b2-478c-b36f-15901f35c94a", "name": "Books", "description": { "content": "Books", "type": "text/plain" }, "item": [ { "id": "7e480e68-3e49-4b08-8fcf-d7bb1324a66d", "name": "Get book details by isbn.", "request": { "name": "Get book details by isbn.", "description": { "content": "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.**", "type": "text/plain" }, "url": { "path": [ "book", ":isbn" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "with_prices", "value": "false", "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." } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "isbn", "description": "(Required) " } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "3c666aa3-13fc-457f-89f9-f68baf8cb6e7", "name": "Returns the book details", "originalRequest": { "url": { "path": [ "book", ":isbn" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "with_prices", "value": "false" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "isbn", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"book\": {\n \"title\": \"string\",\n \"title_long\": \"string\",\n \"isbn\": \"string\",\n \"isbn13\": \"string\",\n \"date_published\": \"2023-10-26\",\n \"isbn10\": null,\n \"binding\": null,\n \"publisher\": \"string\",\n \"language\": null,\n \"edition\": null,\n \"pages\": 1063,\n \"dimensions\": null,\n \"overview\": \"string\",\n \"image\": null,\n \"image_original\": \"string\",\n \"msrp\": null,\n \"excerpt\": \"string\",\n \"synopsis\": null,\n \"authors\": null,\n \"subjects\": null,\n \"reviews\": null,\n \"prices\": [\n \"\",\n \"\"\n ],\n \"other_isbns\": null\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2dcc6ba0-9961-482f-a586-41fa19d7f42b", "name": "Book not found", "originalRequest": { "url": { "path": [ "book", ":isbn" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "with_prices", "value": "false" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "isbn", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"string\",\n \"error_message\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "aac328d7-030b-425b-83ca-ab7cc2d956a0", "name": "Search books", "request": { "name": "Search books", "description": { "content": "\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 your daily quota.\n\n**Response Behavior:**\n* The response will only include books that successfully match an ISBN in our database. \n* Any submitted ISBNs that are not found will be silently ignored and excluded from the response.\n* **Note:** Pricing information is not returned by this endpoint.\n", "type": "text/plain" }, "url": { "path": [ "books" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/x-www-form-urlencoded" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] }, "body": { "mode": "urlencoded", "urlencoded": [ { "disabled": false, "key": "isbns", "value": "", "description": "(Required) " }, { "disabled": false, "key": "isbns", "value": "", "description": "(Required) " } ] } }, "response": [ { "id": "68cfef84-fcd1-495e-92d1-21e2c731bc6a", "name": "Returns books details", "originalRequest": { "url": { "path": [ "books" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "urlencoded", "urlencoded": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "key": "isbns", "value": "" }, { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "key": "isbns", "value": "" } ] } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"total\": 8274,\n \"data\": [\n {\n \"title\": \"string\",\n \"title_long\": \"string\",\n \"isbn\": \"string\",\n \"isbn13\": \"string\",\n \"date_published\": \"2023-10-26\",\n \"isbn10\": \"string\",\n \"binding\": null,\n \"publisher\": \"string\",\n \"language\": null,\n \"edition\": \"string\",\n \"pages\": null,\n \"dimensions\": null,\n \"overview\": \"string\",\n \"image\": null,\n \"image_original\": \"string\",\n \"msrp\": 103.93983922347915,\n \"excerpt\": \"string\",\n \"synopsis\": \"string\",\n \"authors\": null,\n \"subjects\": [\n \"string\",\n \"string\"\n ],\n \"reviews\": null,\n \"prices\": null,\n \"other_isbns\": null\n },\n {\n \"title\": \"string\",\n \"title_long\": \"string\",\n \"isbn\": \"string\",\n \"isbn13\": \"string\",\n \"date_published\": \"2023-10-26\",\n \"isbn10\": \"string\",\n \"binding\": \"string\",\n \"publisher\": null,\n \"language\": \"string\",\n \"edition\": null,\n \"pages\": null,\n \"dimensions\": \"string\",\n \"overview\": \"string\",\n \"image\": \"string\",\n \"image_original\": null,\n \"msrp\": 7230.411796246613,\n \"excerpt\": \"string\",\n \"synopsis\": \"string\",\n \"authors\": null,\n \"subjects\": [\n \"string\",\n \"string\"\n ],\n \"reviews\": null,\n \"prices\": [\n \"\",\n \"\"\n ],\n \"other_isbns\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"requested\": null\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2ec919a9-c234-46ca-be09-ea73d162bc52", "name": "Search books", "request": { "name": "Search books", "description": { "content": "This returns a list of books that match the query.\n\n**This endpoint does not return pricing information.**", "type": "text/plain" }, "url": { "path": [ "books", ":query" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "year", "value": "", "description": "Filter books by year of publication" }, { "disabled": false, "key": "edition", "value": "", "description": "Filter books by edition" }, { "disabled": false, "key": "shouldMatchAll", "value": "false", "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." }, { "disabled": false, "key": "column", "value": "", "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" }, { "disabled": false, "key": "language", "value": "", "description": "Language code to filter books by language (e.g., `eng` for English, `fra` for French, etc.)" }, { "disabled": false, "key": "page", "value": "1", "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" }, { "disabled": false, "key": "pageSize", "value": "20", "description": "How many items should be returned per page, maximum of 1,000" }, { "disabled": false, "key": "publishedFrom", "value": "", "description": "Filter books published on or after this date. Accepted formats: `YYYY`, `YYYY-MM`, `YYYY-MM-DD`. Cannot be combined with the `year` parameter." }, { "disabled": false, "key": "publishedTo", "value": "", "description": "Filter books published on or before this date. Accepted formats: `YYYY`, `YYYY-MM`, `YYYY-MM-DD`. Cannot be combined with the `year` parameter." } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "query", "description": "(Required) The search query string. **Max length: 150 characters**." } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "bcf78516-027a-4888-adf2-835d51963092", "name": "Returns the book details", "originalRequest": { "url": { "path": [ "books", ":query" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "year", "value": "" }, { "key": "edition", "value": "" }, { "key": "shouldMatchAll", "value": "false" }, { "key": "column", "value": "" }, { "key": "language", "value": "" }, { "key": "page", "value": "1" }, { "key": "pageSize", "value": "20" }, { "key": "publishedFrom", "value": "" }, { "key": "publishedTo", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "query", "description": "(Required) The search query string. **Max length: 150 characters**." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"total\": 3173,\n \"data\": [\n {\n \"title\": \"string\",\n \"title_long\": \"string\",\n \"isbn\": \"string\",\n \"isbn13\": \"string\",\n \"date_published\": \"2023-10-26\",\n \"isbn10\": \"string\",\n \"binding\": null,\n \"publisher\": null,\n \"language\": null,\n \"edition\": null,\n \"pages\": null,\n \"dimensions\": \"string\",\n \"overview\": null,\n \"image\": \"string\",\n \"image_original\": \"string\",\n \"msrp\": 7009.620778699162,\n \"excerpt\": \"string\",\n \"synopsis\": \"string\",\n \"authors\": null,\n \"subjects\": null,\n \"reviews\": [\n \"string\",\n \"string\"\n ],\n \"prices\": [\n \"\",\n \"\"\n ],\n \"other_isbns\": [\n \"\",\n \"\"\n ]\n },\n {\n \"title\": \"string\",\n \"title_long\": \"string\",\n \"isbn\": \"string\",\n \"isbn13\": \"string\",\n \"date_published\": \"2023-10-26\",\n \"isbn10\": \"string\",\n \"binding\": null,\n \"publisher\": null,\n \"language\": \"string\",\n \"edition\": \"string\",\n \"pages\": null,\n \"dimensions\": \"string\",\n \"overview\": \"string\",\n \"image\": \"string\",\n \"image_original\": null,\n \"msrp\": 6590.074729680467,\n \"excerpt\": null,\n \"synopsis\": \"string\",\n \"authors\": [\n \"string\",\n \"string\"\n ],\n \"subjects\": null,\n \"reviews\": null,\n \"prices\": [\n \"\",\n \"\"\n ],\n \"other_isbns\": null\n }\n ],\n \"requested\": null\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] } ], "event": [], "variable": [ { "type": "string", "value": "https://api2.isbndb.com", "key": "baseUrl" } ], "info": { "_postman_id": "d8c676d2-2c15-4170-827e-71470066ff0d", "name": "ISBNdb API v2 Books API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "Definition of ISBNdb.com API v2.\n\n***Note: A 404 Not Found response for an ISBN lookup typically\nindicates that the book information is not yet available in our database.\nHowever, due to frequent updates, there is a high probability that the data will be \nadded shortly, often within a minute or up to 24 hours. We recommend trying your request \nagain after a while, as the information may soon become accessible***\n", "type": "text/plain" } } }