{"_id":"5792a9bdf967f617000d9e7a","parentDoc":null,"project":"56d55013075dfa0b00be98e6","version":{"_id":"56d55014075dfa0b00be98e9","__v":16,"project":"56d55013075dfa0b00be98e6","createdAt":"2016-03-01T08:17:24.051Z","releaseDate":"2016-03-01T08:17:24.051Z","categories":["56d55014075dfa0b00be98ea","56d55036c8c687150071efb3","56d55094b939870b005129e2","56d550ae5acf9f0b00f735d0","56d5537ac8c687150071efbf","573cae191000320e00918252","573cbe15f320ae29009dbd94","5792a0baf967f617000d9e77","5792a0c023106419009c4302","58093f2994bc150f00f2fe47","580940f33c22790f00fd1e98","58094c01e5998d0f00d29b5d","58101442c03f0b0f0097f099","581020f07c59d72500b85add","581032c708d8050f00948d2a","5810e6ca08d8050f00948dcf"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"Archy","version_clean":"1.0.0","version":"1"},"user":"573cb45cced73c20002cf5a2","category":{"_id":"5792a0baf967f617000d9e77","project":"56d55013075dfa0b00be98e6","__v":0,"version":"56d55014075dfa0b00be98e9","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-07-22T22:39:54.708Z","from_sync":false,"order":3,"slug":"books","title":"Books"},"__v":1,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-07-22T23:18:21.248Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"language":"curl","code":"curl https://archive.org/services/img/theworksofplato01platiala"}]},"method":"get","results":{"codes":[{"name":"","code":"{}","language":"html","status":200},{"language":"text","status":400,"name":"","code":"https://archive.org/images/notfound.png (returns a default image)"}]},"settings":"573c9bbf06d222170092abda","auth":"required","params":[{"_id":"5792abf4f967f617000d9e7b","ref":"","in":"path","required":false,"desc":"An archive.org item identifier having mediatype text (e.g. the id of a book)","default":"","type":"string","name":"itemid"}],"url":"/img/:itemid"},"isReference":false,"order":3,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Archive.org Bookcover Thumbnails (fast)\"\n}\n[/block]\nThere are several ways to retrieve bookcovers for archive.org and OpenLibrary items.\n\nIf you're looking for an endpoint which will automatically determine the appropriate image to represent an item, you should use the above service. It is also used by the Archive.org website for displaying item previews to the end-user.\n[block:api-header]\n{\n  \"type\": \"get\",\n  \"title\": \"Archive.org Bookcover Cover Page\"\n}\n[/block]\nIf you know the item you're working with is a book (of mediatype 'text') and you prefer a full sized image, you can extract it directly from the item with the following syntax:\n\nhttps://archive.org/download/:itemid/page/cover_t.jpg\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"https://archive.org/download/theworksofplato01platiala/page/cover_t.jpg\",\n      \"language\": \"curl\"\n    }\n  ]\n}\n[/block]\nOf course, you can also follow the \"[Retrieving Book Pages](/docs/retrieving-book-pages)\" instructions to manually retrieve the bookcover image, the title page, or any other book page as an image.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"OpenLibrary Bookcover API\"\n}\n[/block]\nThe OpenLibrary (run by the Internet Archive) also provides its own API Book Cover service which extends to include works which the Internet Archive has not net digitized or made available. These APIs provide a programmatic method to access the book covers and author photos which are available in the Open Library Covers Repository.\n\nRead more about this service here: \n\nhttps://openlibrary.org/dev/docs/api/covers","excerpt":"Programatically retrieving book cover images","slug":"book-covers","type":"endpoint","title":"Book Cover APIs"}

getBook Cover APIs

Programatically retrieving book cover images

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

itemid:
string
An archive.org item identifier having mediatype text (e.g. the id of a book)

Examples


Result Format


Documentation

[block:api-header] { "type": "basic", "title": "Archive.org Bookcover Thumbnails (fast)" } [/block] There are several ways to retrieve bookcovers for archive.org and OpenLibrary items. If you're looking for an endpoint which will automatically determine the appropriate image to represent an item, you should use the above service. It is also used by the Archive.org website for displaying item previews to the end-user. [block:api-header] { "type": "get", "title": "Archive.org Bookcover Cover Page" } [/block] If you know the item you're working with is a book (of mediatype 'text') and you prefer a full sized image, you can extract it directly from the item with the following syntax: https://archive.org/download/:itemid/page/cover_t.jpg [block:code] { "codes": [ { "code": "https://archive.org/download/theworksofplato01platiala/page/cover_t.jpg", "language": "curl" } ] } [/block] Of course, you can also follow the "[Retrieving Book Pages](/docs/retrieving-book-pages)" instructions to manually retrieve the bookcover image, the title page, or any other book page as an image. [block:api-header] { "type": "basic", "title": "OpenLibrary Bookcover API" } [/block] The OpenLibrary (run by the Internet Archive) also provides its own API Book Cover service which extends to include works which the Internet Archive has not net digitized or made available. These APIs provide a programmatic method to access the book covers and author photos which are available in the Open Library Covers Repository. Read more about this service here: https://openlibrary.org/dev/docs/api/covers

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}