{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/download/:itemid/page/page_:page.jpg","auth":"required","examples":{"codes":[{"language":"text","code":"curl https://archive.org/download/platowithenglish04platuoft/page/page_1.jpg"}]},"method":"get","params":[{"name":"itemid","type":"string","default":"","desc":"","required":false,"in":"path","ref":"","_id":"581024407c59d72500b85adf"},{"name":"page","type":"int","default":"","desc":"","required":false,"in":"query","ref":"","_id":"581024407c59d72500b85ade"}],"results":{"codes":[]},"settings":"5809395494bc150f00f2fe41"},"next":{"description":"","pages":[]},"title":"Retrieving Book Pages","type":"endpoint","slug":"retrieving-book-pages","excerpt":"Retrieving and manipulating Archive.org Book Page Images","body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"What happens when you GET a Book Page?\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"body\": \"Make sure when using this book image API in development that your request mechanisms are configured to follow redirects as the above call will trigger a url redirect from the canonical /download path to the server on which the actual book page resides on disk.\",\n  \"title\": \"Caution: API Causes Redirect\"\n}\n[/block]\nWhen a you issue the above HTTP GET request to retrieve a specific book page image, e.g. [https://archive.org/download/theworksofplato01platiala/page/page_1.jpg](https://archive.org/download/theworksofplato01platiala/page/page_1.jpg), the url will resolve to a cryptic url which looks something like this: \n\nhttps://ia800503.us.archive.org/BookReader/BookReaderImages.php?id=platowithenglish04platuoft&itemPath=%2F26%2Fitems%2Fplatowithenglish04platuoft&server=ia800503.us.archive.org&page=page_1.jpg.\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Manipulating Book Page Images\"\n}\n[/block]\nThe IA Book Reader has the capability to manipulate images in several ways, including rotate pages and cropping regions of an image.\n\nFor more information about these APIs see: \n- https://openlibrary.org/dev/docs/bookurls\n- https://openlibrary.org/dev/docs/bookreader#serving-images\n\nFor advanced image manipulation of Archive.org images and Book Pages, see the Archive Labs experimental IIIF API.","updates":[],"order":2,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5810230cc06cc60f007703ff","version":{"version":"1","version_clean":"1.0.0","codename":"Archy","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["56d55014075dfa0b00be98ea","56d55036c8c687150071efb3","56d55094b939870b005129e2","56d550ae5acf9f0b00f735d0","56d5537ac8c687150071efbf","573cae191000320e00918252","573cbe15f320ae29009dbd94","5792a0baf967f617000d9e77","5792a0c023106419009c4302","58093f2994bc150f00f2fe47","580940f33c22790f00fd1e98","58094c01e5998d0f00d29b5d","58101442c03f0b0f0097f099","581020f07c59d72500b85add","581032c708d8050f00948d2a","5810e6ca08d8050f00948dcf"],"_id":"56d55014075dfa0b00be98e9","__v":16,"createdAt":"2016-03-01T08:17:24.051Z","project":"56d55013075dfa0b00be98e6","releaseDate":"2016-03-01T08:17:24.051Z"},"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Books","slug":"books","order":3,"from_sync":false,"reference":false,"_id":"5792a0baf967f617000d9e77","createdAt":"2016-07-22T22:39:54.708Z","project":"56d55013075dfa0b00be98e6","__v":0,"version":"56d55014075dfa0b00be98e9"},"createdAt":"2016-10-26T03:29:16.700Z","user":"56d54fd3c8c687150071efb0","parentDoc":null,"project":"56d55013075dfa0b00be98e6","__v":1,"githubsync":""}

getRetrieving Book Pages

Retrieving and manipulating Archive.org Book Page Images

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

itemid:
string

Query Params

page:
integer

Examples


Documentation

[block:api-header] { "type": "basic", "title": "What happens when you GET a Book Page?" } [/block] [block:callout] { "type": "danger", "body": "Make sure when using this book image API in development that your request mechanisms are configured to follow redirects as the above call will trigger a url redirect from the canonical /download path to the server on which the actual book page resides on disk.", "title": "Caution: API Causes Redirect" } [/block] When a you issue the above HTTP GET request to retrieve a specific book page image, e.g. [https://archive.org/download/theworksofplato01platiala/page/page_1.jpg](https://archive.org/download/theworksofplato01platiala/page/page_1.jpg), the url will resolve to a cryptic url which looks something like this: https://ia800503.us.archive.org/BookReader/BookReaderImages.php?id=platowithenglish04platuoft&itemPath=%2F26%2Fitems%2Fplatowithenglish04platuoft&server=ia800503.us.archive.org&page=page_1.jpg. [block:api-header] { "type": "basic", "title": "Manipulating Book Page Images" } [/block] The IA Book Reader has the capability to manipulate images in several ways, including rotate pages and cropping regions of an image. For more information about these APIs see: - https://openlibrary.org/dev/docs/bookurls - https://openlibrary.org/dev/docs/bookreader#serving-images For advanced image manipulation of Archive.org images and Book Pages, see the Archive Labs experimental IIIF API.

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 }}