fshy

Home

Trove API

trove.nla.gov.au · 2 records in Data APIs, Storage · JSON

Records 2

trove.nla.gov.au/about/create-something/using-apiLibrary and newspaper metadata APIdata-apis/trove-apiJSONcomparereport an error

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 tierA 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.
Pricenone stated
Limits
  • request-rate 200 API calls per minute (200m) as the standard quota source
  • per-object-cap 100 results per category per call; bulk download results limited to 1,000,000 records and 10 downloads at a time source
  • write-gated (binding) a key is issued after a staff review of an application form; harvesting full text or AI use needs an approved exemption source
Bindingwrite-gated No call works without a key, and the key comes from a reviewed application; 200 calls a minute is met only after that.
Identityemail 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.
Egressnot applicable: XML or JSON answers; bulk download files are CSV
Per-object cap100 results per category per call (n, default 20)
Retentionbulk download files are deleted automatically seven days after they are created (7 days)
Interfacerest 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
Toolingany HTTP client
Composes withMetadata 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.
ReliabilityA 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.
NotesStorage: 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 notedocumented 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
  • has-free-tier 1
Evidence 16
datesourcewhat it proved
2026-11-02trove.nla.gov.au/about/create-something/using-apiongoing use needs an active API key
2026-11-02trove.nla.gov.au/about/create-something/using-apia Trove account is needed to receive a key
2026-11-02trove.nla.gov.au/about/create-something/using-apithe application form asks for the call rate needed
2026-11-02trove.nla.gov.au/about/create-something/using-apimost applications are answered within a week
2026-11-02trove.nla.gov.au/about/create-something/using-apinot published
2026-11-02trove.nla.gov.au/about/create-something/using-apiharvesting full-text records and AI modelling are Level 3 and need an exemption
2026-11-02trove.nla.gov.au/about/create-something/using-apitraining generative AI is Level 4 and needs an exemption
2026-11-02trove.nla.gov.au/about/create-something/using-api/v3/api-tecthe standard quota is 200 calls per minute
2026-11-02trove.nla.gov.au/about/create-something/using-api/v3/api-teca call returns at most 100 results per category
2026-11-02trove.nla.gov.au/about/create-something/using-api/v3/api-teca bulkHarvest parameter orders results by identifier for a harvest
2026-11-02trove.nla.gov.au/about/create-something/bulk-downloadbulk download files are deleted seven days after creation
2026-11-02trove.nla.gov.au/about/create-something/bulk-downloada bulk download is limited to 1,000,000 records
2026-11-02trove.nla.gov.au/about/create-something/bulk-downloadat most 10 bulk downloads can exist at a time
2026-11-02trove.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-02trove.nla.gov.au/about/create-something/using-api/trove-api-the Library may refuse any key at its discretion
2026-11-02probe: https://api.trove.nla.gov.au/v3/result?category=newspaper&q=test&encoding=jsona keyless call answers HTTP 401 No API key found in request

trove.nla.gov.au/about/contributestorage/troveJSONcomparereport an error

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 tierAnubis 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
Pricenone stated
Identityemail (placeholder) not published
Egressnot recorded
Interfaceunknown
Toolingnot recorded
Evidence 1
datesourcewhat it proved
2026-10-21trove.nla.gov.au/about/contributethe 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