{ "item": [ { "id": "e1597d08-8903-4c6e-a959-48580ff3fdd6", "name": "Subject", "description": { "content": "Subject", "type": "text/plain" }, "item": [ { "id": "2ebc4c46-b088-4cce-8e76-f17ed4dea5fa", "name": "Search subjects", "request": { "name": "Search subjects", "description": { "content": "This returns a list of subjects that match the given query", "type": "text/plain" }, "url": { "path": [ "subjects", ":query" ], "host": [ "{{baseUrl}}" ], "query": [ { "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" } ], "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": "a7304e0d-c700-44ec-acdc-e6229a3dd21f", "name": "The query string found results in the author's database", "originalRequest": { "url": { "path": [ "subjects", ":query" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "page", "value": "1" }, { "key": "pageSize", "value": "20" } ], "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 \"name\": \"string\",\n \"subjects\": [\n \"string\",\n \"string\"\n ],\n \"total\": 3187,\n \"page\": 7093,\n \"page_size\": 2873\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7561206c-9c8b-4403-8ba9-9fc9e45a77d5", "name": "Gets subject details", "request": { "name": "Gets subject details", "description": { "content": "Returns the name and a list of books by the subject.", "type": "text/plain" }, "url": { "path": [ "subject", ":name" ], "host": [ "{{baseUrl}}" ], "query": [ { "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": "name", "description": "(Required) The subject name. **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": "f1cf9dd4-d5a0-4911-ae3c-d2e332f75e06", "name": "Returns the book details", "originalRequest": { "url": { "path": [ "subject", ":name" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "language", "value": "" }, { "key": "page", "value": "1" }, { "key": "pageSize", "value": "20" }, { "key": "publishedFrom", "value": "" }, { "key": "publishedTo", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "name", "description": "(Required) The subject name. **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 \"subject\": \"string\",\n \"name\": \"string\",\n \"books\": [\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\": \"string\",\n \"image_original\": null,\n \"msrp\": null,\n \"excerpt\": \"string\",\n \"synopsis\": null,\n \"authors\": [\n \"string\",\n \"string\"\n ],\n \"subjects\": [\n \"string\",\n \"string\"\n ],\n \"reviews\": null,\n \"prices\": [\n \"\",\n \"\"\n ],\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\": null,\n \"binding\": null,\n \"publisher\": \"string\",\n \"language\": \"string\",\n \"edition\": \"string\",\n \"pages\": null,\n \"dimensions\": \"string\",\n \"overview\": \"string\",\n \"image\": \"string\",\n \"image_original\": null,\n \"msrp\": null,\n \"excerpt\": null,\n \"synopsis\": \"string\",\n \"authors\": [\n \"string\",\n \"string\"\n ],\n \"subjects\": null,\n \"reviews\": null,\n \"prices\": null,\n \"other_isbns\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"total\": 9205,\n \"page\": 1367,\n \"page_size\": 4201\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] } ], "event": [], "variable": [ { "type": "string", "value": "https://api2.isbndb.com", "key": "baseUrl" } ], "info": { "_postman_id": "f5677fce-5daf-460f-8879-ece8c57c1de3", "name": "ISBNdb API v2 Subject 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" } } }