Ctrl+K
🚧 This is a working draft and will change often. Do not cite!
Use the latest published version instead. 🚧

HOW TO: Get text, images, and PDFs using Trove’s download link

25.4. HOW TO: Get text, images, and PDFs using Trove’s download link#

On this page

25.4.1. Background#

You can download text, images, and PDFs from individual digitised items using the Trove web interface. But only the text of periodical articles is available for machine access through the Trove API. This makes it difficult to assemble datasets, or build processing pipelines involving digitised resources.

This page documents a workaround developed by reverse-engineering the download link used by the Trove web interface. You can use it to automate the download of text, images, and PDFs from many digitised resources.

25.4.4. Download selected pages#

You don’t have to ask for everything at once. By adjusting the firstPage and lastPage values, you can download a specific range of pages. If you wanted the first ten pages of The gold finder of Australia as zipped images, you’d set firstPage to 0 and lastPage to 9:

https://nla.gov.au/nla.obj-248742150/download?downloadOption=zip&firstPage=0&lastPage=9

To request a single page, set firstPage and lastPage to the same value. For example, if you wanted an image of the cover, you’d set both firstPage and lastPage to 0:

https://nla.gov.au/nla.obj-248742150/download?downloadOption=zip&firstPage=0&lastPage=0

25.4.5. How do you know the number of pages?#

The value of this method lies in the fact that it can be used programatically to download large collections of digitised items without any manual intervention. But to do that you need some way of finding out the number of pages or images in each item so you can set the lastPage value. This information isn’t included in the metadata from the API, and so requires a little extra effort to extract.

The approach varies depending on the type of resource.

If you’re downloading a resource that is made up of pages, such as a book or periodical, you need to:

If you’re downloading a collection of images, manuscripts, or maps, you can look for the value of maxNumOfChildDownloads embedded in the HTML of the digitised image viewer. Here’s an example that finds the number of photographs in the collection of B.A.N.Z. Antarctic Research Expedition photographs (nla.obj-141170265).

import requests
import re

obj_id = "nla.obj-141170265"

# Get the page from the digitised image viewer
response = requests.get(f"https://nla.gov.au/{obj_id}")

# Find lines where this variable is referenced
matches = re.findall(r"maxNumOfChildDownloads = (\d+)", response.text)

# This variable can be referenced multiple times - we want to get the highest value
num_items = sorted([int(m) for m in matches])[-1]
print(num_items)

151

25.4.6. Limitations and alternatives#

This method works really well if you want to get all the OCRd text out of books or periodical issues. It’s also handy if you want to download selected pages or images, such as the front covers of periodicals.

However, if your aim is to download all the images from a collection of items then there are two potential problems. The first is that the download link doesn’t always provide images at their highest available resolution. This particularly seems to be the case with manuscript and photographic collections.

The other problem is that the zip files can become very large if you request collections that contain a significant number of pages or images. This makes them slow to download and can cause errors. Of course you also have to add in a step to unzip the zips!

If you’re downloading lots of images or the quality of the images is important to you, I’d suggest you try the alternative approach which involves downloading one at a time. This method is fully documented in HOW TO: Create download links for images using nla.obj identifiers.

Contents