Trove API Terms of Use

These Trove API Terms of Use terms specify how developers can use Trove metadata.

Please be aware that the Trove API Terms of Use extend only to metadata as specified in the respective Definitions section. The rights do not extend to use of digital objects or images (as accessible through the thumbnail and viewcopy fields). If you wish to use any object or image, that is not openly licensed, then we encourage you to contact the appropriate content owners for their permission.

These Trove API Terms of Use are to be read in conjunction with other terms including the Trove Terms of Use, Privacy and Copyright.


1. In these terms of use:

"anonymous access" or "guest access" means interacting with the Trove API without providing an API key;

"API" means Application Programming Interface;

"API key" is a token that a client provides when making API calls. The key can be sent in the query string or as a request header;

"API Terms" means these Trove API Terms of Use (non-commercial) as updates, amended or modified from time to time;

"authenticated access" means interacting with the Trove API using an active APIkey;

"the Library", "we", "our" and "us" mean the National Library of Australia;

"metadata" means any information (text only) that describes attributes and characteristics of digital content, whether in structured and standard ways or in less structured ways through the use of general descriptions and tagging, and whether at the individual content item level or at the level of a group of content items; for the purposes of these API terms, metadata also includes statistical information available through search queries using the Trove API;

"Trove" means the website of that name made available by the Library, and includes any other functions or services delivered by the Library or Trove Partners to you in connections with that service;

"Trove API" means the Trove Application Programming Interface;

“User Content” means any content uploaded (such as text corrections, comments, images, notes), posted or otherwise provided by you in relation to Trove;

“you” means any individual and/or the company or organisation they represent who are applying for or have been issued with, an API key by the Library.

Agreement to terms

2.1. The Trove API enables people and organisations to retrieve Trove metadata. By proceeding to use Trove API, persons and organisations are agreed to these API terms of use. These API terms constitute a binding agreement between you and the National Library of Australia to govern your use of the Trove API.

2.2. These terms of use apply to all persons and organisations who use the API, including through anonymous/guest access. By using the Trove API, all persons and organisations agree to these API terms.


3. If you are applying for an API key on behalf of a company or other organisation, you represent that you have the authority to bind that company or organisation.

Access and use rights

Anonymous access

4.1 You may access the Trove API without an API Key while:

(a) exploring and learning the API; or

(b) demonstrating the API to another person who may be a colleague, student, etc:

(c) undertaking other activities with written permission from the National Library of Australia.

Anonymous access is only designed for initial trial or education purposes and will be limited to a small number of requests per minute.

Anonymous access can be revoked at the discretion of the National Library of Australia.

An API key is required for all other uses of the Trove API, as per section 4.2.

Authenticated access

4.2 Upon your receipt of an API key, you may:

(a) access the Trove API for uses that extend beyond those outlined in section 4.1; and

(b) copy, use and distribute metadata available through the Trove API for the purposes of your own websites and applications (whether desktop or mobile in nature), provided you comply with all requirements set out in these API terms. Contributions by Trove end users can only be re-used with a CC-BY-NC-SA licence. If you do not comply with these requirements, your limited licence under this clause will automatically terminate. Without limitation, your attention is drawn to clauses 8-10 (Live access and caching), 11 (Attribution), 12-13 (API calls) and 17 (Prohibited use).

Use and protection of API key

5. Your API key is only authorised for use by the person or organisation who obtained it and cannot be used by or transferred to any other person or organisation without NLA’s written permission.

6. You must keep your API key secure and confidential. If you believe that the security and confidentiality of your API key has been compromised, you must notify us as soon as possible via our contact form.

Password restricted site access

7. If you are displaying Trove metadata retrieved via the Trove API on or through a website or application that requires registration you must, on request by the Library or any metadata contributor, provide a logon to the website or application to the Library and/or the metadata contributor, without charge, for the purpose of verifying attribution.

Live access and caching

8. Subject to clause 9 below, when you wish to serve Trove metadata to or through websites or applications, you are required to make real-time calls directly to the Trove API on each occasion and to display the retrieved data on or through those websites or applications as soon as possible upon your system’s receipt of the retrieved data. (The reason for this requirement is that Trove metadata is updated regularly.)

9. The only exception to the requirement in clause 8 above is where you wish to enable offline functionality for your website or application, or where making real-time calls would negatively affect the performance of your service, in which case you may cache Trove metadata retrieved via the Trove API for up to 30 days.

10. If metadata is removed from Trove or is no longer able to be viewed by the general public, you must ensure it is removed from your website or application as soon as possible.

11. If you display metadata retrieved via the Trove API on or through another website or application:

(a) you must, for each item to which the metadata relates:

(i) identify the source (i.e., the third party source of the item, as well as Trove); and
(ii) where available from Trove provide a hyperlink to the page on the online source’s website containing the content item; and

(b) state that your website or application uses data sourced from Trove and include a link to (Please use this logo)

API calls

12. You must not make more than your allotted quota of API calls per minute without written approval from the Library.

13. The Library reserves the right to increase or decrease this API call limit at its sole discretion.


14. The Library does not guarantee the accuracy or completeness of Trove or any content made available by, or accessible on, Trove.

15. To the extent permitted by law, the Library is not liable for any loss, injury, claim, liability or damage of any kind resulting from the use of Trove, or for any content available or accessible on Trove, including any privacy breach or infringement of copyright. The Library is not liable for any special, indirect, incidental or consequential loss or damages of any kind whatsoever (including, without limitation, legal fees) in any way due to, resulting from, or arising in connection with the use of or inability to use Trove.


16. To the extent permitted by law, you indemnify the Library, its officers, directors, employees, agents, distributors and affiliates, and any third party information providers to Trove, for any loss or damage suffered, or any costs or expenses incurred or resulting from any breach of these Terms of Use by you or your access or use of Trove, including any or all third party claims, demands, liabilities, costs or expenses arising directly or indirectly out of or in connection with your access or use of Trove.

17. You must cooperate with the Library as reasonably required in the defence of any third party claim.

Use of the Trove API

18. You agree, in using the Trove API, not to:

(a) sell, rent, or otherwise offer Trove to others, without the Library's prior written consent;

(b) use Trove in any unlawful, fraudulent, defamatory or harmful manner, including to post any User Content that is pornographic, obscene, threatening, offensive, invasive of privacy, or which would constitute or encourage a criminal offence, or give rise to liability under, or breach, any law;

(c) use Trove, or post any User Content that interferes with, impacts, harasses or intimidates other users of Trove or members of the public;

(d) introduce or permit the introduction of any virus, worm, trojan or other malicious code into Trove, or in any other manner whatsoever corrupt, degrade or disrupt Trove.

Reserved rights

19. The Library reserves the right:

(a) not to grant an API key to any person or organisation at its complete discretion;

(b) to release new versions of the Trove API from time to time and require you to use the most recent version;

(c) to withdraw or terminate any API key where it believes that a user of that API key is:

(i) acting contrary to these API terms; or

(ii) providing a website or application that is enabling others to act in a manner that is either contrary to these terms of use or is bringing or could bring Trove, the Library, or any contributor of metadata or partner to Trove into disrepute; and

(d) to otherwise limit, suspend, modify or terminate your access to the Trove API at any time, for any reason and at its sole discretion, without providing notice to you;

(e) to discontinue the Trove API at any time, for any reason, planned or unplanned, and at its sole discretion, without providing notice to you.

(f) to discontinue of anonymous use of Trove API at any time, for any reason, planned or unplanned, and at its sole discretion, without providing notice.


20. The Library may change these API terms at any time at any time in its sole discretion. The Library will notify you of any changes to these API terms by adding a statement on Trove and the amended API terms will take effect 5 working days (in the Australian Capital Territory) after the date on which the statement was added to Trove. If you do not agree to the updated API terms, you must immediately cease using Trove.

Entire agreement

21. These API Terms constitute the entire agreement between the parties, and supersede all previous agreements relating to the use of Trove API.


22. If any provision of these API Terms is deemed to be unenforceable for any reason by any court, the invalidity of the provision does not affect the validity of any other provisions in these API Terms, which remain in full effect.

Governing law

21. These Terms of Use are governed by the laws of the Australian Capital Territory.

22. You submit to the non-exclusive jurisdiction of the courts of the Australian Capital Territory.