Simple Trove Proxy

PDF Links

Get a url that you can use to download the PDF copy of a newspaper article.

Usage: /pdf/[newspaper article id]

Random newspaper articles

Get a random-ish newspaper article from Trove.

Required parameters:

• key: a Trove API key

Optional parameters:

• query: limit the pool to articles matching this query (can be anything you might enter in the Trove search box, eg. 'cats')
• any of the facets you can use with the Trove API (don't include the 'l-', eg: state, category, year)

Examples::

• any random article: /random/?key=[YOUR API KEY]
• a random article containing the word 'cats': /random/?key=[YOUR API KEY]&query=cats
• a random article from Tasmania: /random/?key=[YOUR API KEY]&state=Tasmania
• a random article from the Sydney Morning Herald: /random/?key=[YOUR API KEY]&title=35&category=Article

See this notebook for more information on the method used to select random articles.

Open newspaper search in API Console

Convert a newspaper search url from the web interface into an API query, then open it in the Trove API Console.

Required parameters:

• url: a url encoded newspaper search url

Example:

• /parse/?url=https%3A%2F%2Ftrove.nla.gov.au%2Fsearch%2Fcategory%2Fnewspapers%3Fkeyword%3Dwragge

View hidden metadata for a digitised book or journal

Extracts embedded metadata from the web page of a digitised book or journal and returns it as JSON.

Required parameters:

• url: a url encoded url for a digitised work

Example:

• /metadata/?url=https%3A%2F%2Fnla.gov.au%2Fnla.obj-2906940941

API calls

Make a call to the Trove API via https. This will also redirect API calls to version 2 of the API.

Note that the Trove API now support https itself, so it's not necessary to use this proxy.

Usage: /api/[normal Trove API query (everything after 'http://api.trove.nla.gov.au' or 'http://api.trove.nla.gov.au/v2')]