{"_id":"5810230cc06cc60f007703ff","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"},"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"},"user":"56d54fd3c8c687150071efb0","parentDoc":null,"project":"56d55013075dfa0b00be98e6","__v":1,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-10-26T03:29:16.700Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"code":"curl https://archive.org/download/platowithenglish04platuoft/page/page_1.jpg","language":"text"}]},"method":"get","results":{"codes":[]},"settings":"5809395494bc150f00f2fe41","auth":"required","params":[{"_id":"581024407c59d72500b85adf","ref":"","in":"path","required":false,"desc":"","default":"","type":"string","name":"itemid"},{"_id":"581024407c59d72500b85ade","ref":"","in":"query","required":false,"desc":"","default":"","type":"int","name":"page"}],"url":"/download/:itemid/page/page_:page.jpg"},"isReference":false,"order":2,"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.","excerpt":"Retrieving and manipulating Archive.org Book Page Images","slug":"retrieving-book-pages","type":"endpoint","title":"Retrieving Book Pages"}

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