Search result

Conduct a search of Trove.

Arguments

There are many facets

key (Required)
Your API key
zone (Required)
Allows searching in a particular zone. Multiple zones can be searched by separating them with a comma. If no zone is specified, an error occurs. To get a faster response, search only the zones you need. The current list of zones are:
  • all
  • book
  • picture
  • article
  • music
  • map
  • collection
  • newspaper
  • list
q (Required)
The query. This can contain words, indexes and combinations of these. See the form for details.
reclevel (Optional)
Get all the details for the contributors, instead of just the name and id. Valid values are brief or full. If this is omitted, it defaults to brief.
s (Optional)
The default number to start from. You will receive a CursorMark in your results if there are more pages of results. Use this to page through a long list of results. If this is omitted, it defaults to *.
n (Optional)
The number of results to return per zone. Maximum is 100. If this is omitted, it defaults to 20.
sortby (Optional)
The sort order for the results. Both date of publication and relevance are supported.
reclevel (Optional)
Indicates whether to return a full or brief metadata record. Valid values are brief or full. If this is omitted, it defaults to brief.
include (Optional)
Include additional details in the response
facet (Optional)
Include specific facets in the response
encoding (Optional)
Get the response in xml or json. If this is omitted, it defaults to xml.

Explore

Required fields
Limiting the search

A comma seperated list of:

  • all
  • book
  • picture
  • article
  • music
  • map
  • collection
  • newspaper
  • gazette
  • list

Queries can be constructed with a number of indexes and combined to create complex queries eg:

Simple queries

  • Multi word: sydney harbour bridge
  • Phrase: "sydney harbour bridge"
  • NOT search: "sydney harbour" NOT bridge

Searching indexes

  • Creator: creator:(Frank Hurley)
  • Subject: subject:(cognitive psychology)
  • Title: title:(short history of Australia)
  • Stemmed creator: s_creator:(Frank Hurley)
  • Stemmed subject: s_subject:(cognitive psychology)
  • Stemmed title: s_title:(short history of Australia)
  • Exact creator (lists): exact_creator:"public:NLAexhibitions"
  • Format: format:book, format:map/atlas (see the list at l-format)
  • Language: language:english
  • ISBN: isbn:0333337352
  • ISSN: issn:15386597
  • Public tags: publictag:(sydney)
  • NUC: nuc:QU, nuc:QU\:NET, nuc:QU*
  • ID id:6311198
  • Identifier identifier:0333337352
  • Libraries Australia record identifier anbdid:46285585
  • Dewey Decimal Classification number ddc:"791.4372"
  • Last updated lastupdated:[2012-04-04T00:00:00Z TO *], lastupdated:[2012-04-04T00:00:00Z TO 2012-04-04T00:00:00Z]
  • Tags last updated: taglastupdated:[2012-04-04T00:00:00Z TO *], taglastupdated:[2012-04-04T00:00:00Z TO 2012-04-04T00:00:00Z]
  • Comments last updated: commentlastupdated:[2012-04-04T00:00:00Z TO *], commentlastupdated:[2012-04-04T00:00:00Z TO 2012-04-04T00:00:00Z]
  • Date: date:[* TO 1900], date:[1900 TO *], date:[1980 TO 2001]
  • Decade: decade:199
  • Articles where OCR text has been corrected: has:corrections
  • Articles where OCR text hasn't been corrected: NOT has:corrections
  • Articles that have OCR text that can be corrected: has:correctabletext
  • Contains tags: has:tags
  • Contains comments: has:comments
  • Text: text:Jackes
  • Fulltext (newspapers) fulltext:Jackes

Combining items to create a more complex search

  • Phrase and date: "sydney harbour bridge" date:[1980 TO 2005]
  • Phrase and creator: "sydney harbour bridge" creator:(Frank Hurley)
  • Phrase and comments: "sydney harbour bridge" has:comments

Only available if the zone is newspapers and the year facet is also applied.

Only applies to articles from Gale

Only available if illustrated limit is applied

A code sourced from the Library of Congress geographic area codes vocabulary

Navigating and sorting
Controlling the metadata

A comma seperated list of:

  • all
  • tags
  • comments
  • lists
  • holdings
  • links
  • subscribinglibs
  • workversions
  • articletext
  • years
  • listitems

A comma seperated list of:

  • all
  • format
  • decade
  • year
  • month
  • language
  • availability
  • australian
  • occupation
  • zoom
  • vendordb
  • audience
  • title
  • category
  • illustrated
  • illtype
  • word

Sort results by identifier rather than relevance. This prevents your results set order changing when harvesting and ensures you get every record once.

API response

Request:

Response: