Trove API
trove.nla.gov.au · 2 records in Data APIs, Storage · JSON
Records 2
- caveatTrove API (National Library of Australia)
Data APIsfree tieridentity emailno cardlimit write-gatedevidence documentedstale on 2026-12-03
- fails: quotatrove (national library of australia)
Storageidentity email?card?evidence reportedstale on 2026-11-05
- Free allowance
- A free API key after a reviewed application: 200 calls per minute (200m) at review Levels 1 to 4, up to 100 results per category per call, and a bulk download of search results to CSV (at most 1,000,000 records) in the Trove account.
- Verdict
- caveatusable, with a named limit or an unprobed read path
- Cost
- free tier
- Identity
- emailno card, no phone
- Binding limit
- write-gateda key is issued after a staff review of an application form; harvesting full text or AI use needs an approved exemption
- Evidence
- documented16 sources; a first-party page was read and the sentence quoted
- Freshness
- stale on 2026-12-03checked 2026-11-02 (live); stale on 2026-12-03
| Free tier | A free API key after a reviewed application: 200 calls per minute (200m) at review Levels 1 to 4, up to 100 results per category per call, and a bulk download of search results to CSV (at most 1,000,000 records) in the Trove account. unit requests; metered on request-count; Most applications are answered within a week; The quota can be raised on request, subject to approval. |
|---|---|
| Price | none stated |
| Limits |
|
| Binding | write-gated No call works without a key, and the key comes from a reviewed application; 200 calls a minute is met only after that. |
| Identity | email A Trove account is needed first (its sign-up fields are unverified: the sign-up page renders by script); then an application form asking for the account username and contact details, the call rate needed, why and how the API will be used, and an agreement to the API terms. No card is mentioned. |
| Egress | not applicable: XML or JSON answers; bulk download files are CSV |
| Per-object cap | 100 results per category per call (n, default 20) |
| Retention | bulk download files are deleted automatically seven days after they are created (7 days) |
| Interface | rest REST over HTTPS at api.trove.nla.gov.au/v3 (result search, work, newspaper, gazette, magazine titles, list, people) with an OpenAPI file; the key goes in the key parameter or a header; XML by default, JSON with encoding=json endpoint: https://api.trove.nla.gov.au/v3/result |
| Tooling | any HTTP client |
| Composes with | Metadata for books, images, maps, music, journals and digitised newspaper and gazette articles from Australian libraries; article full text is included with include=articletext for approved uses. |
| Reliability | A keyless call answered HTTP 401 No API key found in request; the Trove website pages, not the API host, sit behind an Anubis proof-of-work challenge that a plain page fetch stores as a challenge page; keys can be withdrawn at the Library's discretion. |
| Notes | Storage: retrieved metadata may be cached for up to 30 days for offline use or performance; otherwise each display makes a live call; bulk download CSV files last 7 days. Bulk path: Download results in a Trove account (CSV of metadata and an abstract, up to 1,000,000 records, one category at a time, 10 downloads at a time) or bulkHarvest=true through the API. This is the read API; the deposit question has its own record in storage. |
| Evidence note | documented Key process, review levels, quota, caps, bulk download and caching limit are read from first-party pages; a keyless call answered HTTP 401, and the key application is behind a sign-up, so whether an individual key is granted is unverified: behind a sign-up. |
| Parsed numbers |
|
Evidence 16
| date | source | what it proved |
|---|---|---|
| 2026-11-02 | trove.nla.gov.au/about/create-something/using-api | ongoing use needs an active API key |
| 2026-11-02 | trove.nla.gov.au/about/create-something/using-api | a Trove account is needed to receive a key |
| 2026-11-02 | trove.nla.gov.au/about/create-something/using-api | the application form asks for the call rate needed |
| 2026-11-02 | trove.nla.gov.au/about/create-something/using-api | most applications are answered within a week |
| 2026-11-02 | trove.nla.gov.au/about/create-something/using-api | not published |
| 2026-11-02 | trove.nla.gov.au/about/create-something/using-api | harvesting full-text records and AI modelling are Level 3 and need an exemption |
| 2026-11-02 | trove.nla.gov.au/about/create-something/using-api | training generative AI is Level 4 and needs an exemption |
| 2026-11-02 | trove.nla.gov.au/about/create-something/using-api/v3/api-tec | the standard quota is 200 calls per minute |
| 2026-11-02 | trove.nla.gov.au/about/create-something/using-api/v3/api-tec | a call returns at most 100 results per category |
| 2026-11-02 | trove.nla.gov.au/about/create-something/using-api/v3/api-tec | a bulkHarvest parameter orders results by identifier for a harvest |
| 2026-11-02 | trove.nla.gov.au/about/create-something/bulk-download | bulk download files are deleted seven days after creation |
| 2026-11-02 | trove.nla.gov.au/about/create-something/bulk-download | a bulk download is limited to 1,000,000 records |
| 2026-11-02 | trove.nla.gov.au/about/create-something/bulk-download | at most 10 bulk downloads can exist at a time |
| 2026-11-02 | trove.nla.gov.au/about/create-something/using-api/trove-api- | retrieved metadata may be cached for at most 30 days, and only for offline use or performance |
| 2026-11-02 | trove.nla.gov.au/about/create-something/using-api/trove-api- | the Library may refuse any key at its discretion |
| 2026-11-02 | probe: https://api.trove.nla.gov.au/v3/result?category=newspaper&q=test&encoding=json | a keyless call answers HTTP 401 No API key found in request |
- Free allowance
- Anubis proof-of-work wall on /about/contribute, and structurally Trove is a discovery layer over member-collection metadata plus newspaper OCR — not an upload target for third-party bulk…
- Verdict
- fails: quotathe free allowance is too small to matter
- Cost
- not stated
- Identity
- email?placeholder, not evidence; card unknown, phone unknown
- Binding limit
- noneno named constraint binds
- Evidence
- reported1 source; a third party said so
- Freshness
- stale on 2026-11-05checked 2026-10-21 (inherited); stale on 2026-11-05
| Free tier | Anubis proof-of-work wall on /about/contribute, and structurally Trove is a discovery layer over member-collection metadata plus newspaper OCR — not an upload target for third-party bulk… unit none; metered on none |
|---|---|
| Price | none stated |
| Identity | email (placeholder) not published |
| Egress | not recorded |
| Interface | unknown |
| Tooling | not recorded |
Evidence 1
| date | source | what it proved |
|---|---|---|
| 2026-10-21 | trove.nla.gov.au/about/contribute | the text of Free tier, above |
More fields 1
| dead end | {"failure_class": "quota","why": "Anubis proof-of-work wall on /about/contribute, and structurally Trove is a discovery layer over member-collection metadata plus newspaper OCR — not an upload target for third-party bulk…","retry_when": null,"first_recorded": "2026-10-21"} |
|---|
Unknown values 7
- chaining: no value was recorded for this field
- egress terms: no value was recorded for this field
- interface: the access interface was not established
- per object cap notes: no value was recorded for this field
- per object cap stated: no value was recorded for this field
- retention stated: no value was recorded for this field
- tooling: no value was recorded for this field