Trove API Console

Explore the workings of the Trove API

Enter an API query to view the results (no key required), or start with one of the examples below.

          {"response":{"query":"yellow","zone":[{"name":"picture","records":{"s":"0","n":"20","total":"63859","next":"\/result?q=yellow&encoding=json&zone=picture&s=20","work":[{"id":"11189502","url":"\/work\/11189502","troveUrl":"http:\/\/trove.nla.gov.au\/work\/11189502","title":"Yellow","contributor":["BALSAITIS, Jonas VICTORIAN PRINT WORKSHOP"],"issued":1982,"type":["Art work","Photograph"],"holdingsCount":1,"versionCount":2,"relevance":{"score":"22.917336","value":"very relevant"},"identifier":[{"type":"url","linktype":"fulltext","value":"http:\/\/artsearch.nga.gov.au\/Detail.cfm?IRN=124726&PICTAUS=TRUE"},{"type":"url","linktype":"thumbnail","value":"http:\/\/artsearch.nga.gov.au\/Images\/SML\/124726.jpg"}]},{"id":"192272093","url":"\/work\/192272093","troveUrl":"http:\/\/trove.nla.gov.au\/work\/192272093","title":"Yellow","contributor":["Mimi_K"],"issued":2011,"type":["Photograph"],"holdingsCount":1,"versionCount":1,"relevance":{"score":"16.875475","value":"very relevant"},"identifier":[{"type":"url","linktype":"fulltext","value":"https:\/\/www.flickr.com\/photos\/96878569@N00\/5380000418"},{"type":"url","linktype":"thumbnail","value":"https:\/\/farm6.staticflickr.com\/5243\/5380000418_1e2bde2c80_t.jpg"}]},{"id":"192312208","url":"\/work\/192312208","troveUrl":"http:\/\/trove.nla.gov.au\/work\/192312208","title":"Yellow","contributor":["bruce-p"],"issued":2007,"type":["Photograph"],"holdingsCount":1,"versionCount":1,"relevance":{"score":"16.800514","value":"very relevant"},"identifier":[{"type":"url","linktype":"fulltext","value":"https:\/\/www.flickr.com\/photos\/13378589@N00\/1851106190"},{"type":"url","linktype":"thumbnail","value":"https:\/\/farm3.staticflickr.com\/2247\/1851106190_146c8169a2_t.jpg"}]},{"id":"185737310","url":"\/work\/185737310","troveUrl":"http:\/\/trove.nla.gov.au\/work\/185737310","title":"Yellow","contributor":["Ian Campbell"],"issued":2013,"type":["Photograph"],"holdingsCount":1,"versionCount":1,"relevance":{"score":"11.074983","value":"very relevant"},"snippet":"<b>Yellow<\/b> ","identifier":[{"type":"url","linktype":"fulltext","value":"https:\/\/www.flickr.com\/photos\/78518702@N04\/8560231945"},{"type":"url","linktype":"thumbnail","value":"https:\/\/farm9.staticflickr.com\/8086\/8560231945_4da08bcdb8_t.jpg"}]},{"id":"192289389","url":"\/work\/192289389","troveUrl":"http:\/\/trove.nla.gov.au\/work\/192289389","title":"Yellow","contributor":["John White"],"issued":2009,"type":["Photograph"],"holdingsCount":1,"versionCount":1,"relevance":{"score":"11.072444","value":"very relevant"},"identifier":[{"type":"url","linktype":"fulltext","value":"https:\/\/www.flickr.com\/photos\/88198131@N00\/4199896610"},{"type":"url","linktype":"thumbnail","value":"https:\/\/farm3.staticflickr.com\/2705\/4199896610_875ed01f74_t.jpg"}]},{"id":"209679345","url":"\/work\/209679345","troveUrl":"http:\/\/trove.nla.gov.au\/work\/209679345","title":"Yellow","contributor":["Tony TUCKSON"],"issued":1973,"type":["Art work"],"holdingsCount":1,"versionCount":1,"relevance":{"score":"11.071507","value":"very relevant"},"snippet":"<b>Yellow<\/b> As deputy director of the Art Gallery of New South Wales, Tony Tuckson was reticent about","identifier":[{"type":"url","linktype":"fulltext","value":"http:\/\/www.ngv.vic.gov.au\/explore\/collection\/work\/61993\/"},{"type":"url","linktype":"thumbnail","value":"http:\/\/content.ngv.vic.gov.au\/retrieve.php?type=image&size=small&vernonID=61993"}]},{"id":"46247041","url":"\/work\/46247041","troveUrl":"http:\/\/trove.nla.gov.au\/work\/46247041","title":"Yellow","contributor":["Harvey, Dennis"],"issued":1997,"type":["Article\/Review","Photograph","Article"],"isPartOf":"Variety","holdingsCount":0,"versionCount":1,"relevance":{"score":"11.070634","value":"very relevant"},"snippet":".\n\n   An \"Asian-American Graffiti\" following eight\nhigh-schoolers during their eventful graduation night'\n\"<b>Yellow<\/b>"},{"id":"192305363","url":"\/work\/192305363","troveUrl":"http:\/\/trove.nla.gov.au\/work\/192305363","title":"Y-e-l-l-o-w","contributor":["aka Gerald"],"issued":2008,"type":["Photograph"],"holdingsCount":1,"versionCount":1,"relevance":{"score":"5.085361","value":"very relevant"},"snippet":"Y-e-l-l-o-w Look at the sunLook how it shines for youAnd everything you doYeah they were all <b>yellow<\/b>","identifier":[{"type":"url","linktype":"fulltext","value":"https:\/\/www.flickr.com\/photos\/8773698@N03\/2649742844"},{"type":"url","linktype":"thumbnail","value":"https:\/\/farm4.staticflickr.com\/3042\/2649742844_6b83f0d2de_t.jpg"}]},{"id":"28924274","url":"\/work\/28924274","troveUrl":"http:\/\/trove.nla.gov.au\/work\/28924274","title":"[Collection of posters relating to Yellow Glass Theatre Inc.]","contributor":["Yellow Glass Theatre"],"issued":1900,"type":["Poster, chart, other"],"holdingsCount":1,"versionCount":1,"relevance":{"score":"2.8620448","value":"very relevant"}},{"id":"187615640","url":"\/work\/187615640","troveUrl":"http:\/\/trove.nla.gov.au\/work\/187615640","title":"Yellow Waters Cruise","contributor":["Suttor, Tony"],"type":["Photograph"],"holdingsCount":1,"versionCount":22,"relevance":{"score":"2.7115684","value":"very relevant"},"snippet":"Croc spotted on <b>Yellow<\/b> Waters Cruise. Date: Unknown Crocodile spotted on <b>Yellow<\/b> Waters Cruise. Date","identifier":[{"type":"url","linktype":"fulltext","value":"http:\/\/hdl.handle.net\/10070\/66447"},{"type":"url","linktype":"thumbnail","value":"http:\/\/www.territorystories.nt.gov.au\/bitstream\/10070\/64079\/8\/058-0032.JPG.jpg"}]},{"id":"213170357","url":"\/work\/213170357","troveUrl":"http:\/\/trove.nla.gov.au\/work\/213170357","title":"Sweet Yellow House","contributor":["Ryan Smith"],"issued":2016,"type":["Photograph"],"holdingsCount":1,"versionCount":8,"relevance":{"score":"1.6087526","value":"likely to be relevant"},"snippet":"Sweet <b>Yellow<\/b> House American Style Colonial House57 Elizabeth St, Banksia Park.Year Built","identifier":[{"type":"url","linktype":"fulltext","value":"https:\/\/www.flickr.com\/photos\/49428593@N08\/29679204346"},{"type":"url","linktype":"thumbnail","value":"https:\/\/farm9.staticflickr.com\/8102\/29088023994_5dbfdcded9_t.jpg"}]},{"id":"198060966","url":"\/work\/198060966","troveUrl":"http:\/\/trove.nla.gov.au\/work\/198060966","title":"Yellow House - Opening","contributor":["Yellow House"],"issued":1971,"type":["Photograph"],"holdingsCount":1,"versionCount":1,"relevance":{"score":"1.4771036","value":"likely to be relevant"},"snippet":"<b>Yellow<\/b> House - Opening <b>Yellow<\/b> House Opening, 7.30, Nov. 12th, black and white drawing \/ collage. No","identifier":[{"type":"url","linktype":"fulltext","value":"http:\/\/ro.uow.edu.au\/yhgallery\/8"},{"type":"url","linktype":"thumbnail","value":"http:\/\/ro.uow.edu.au\/yhgallery\/1007\/thumbnail.jpg"}]},{"id":"6319944","url":"\/work\/6319944","troveUrl":"http:\/\/trove.nla.gov.au\/work\/6319944","title":"Aida Tomescu","contributor":["Tomescu, Aida, 1955-"],"issued":"1997-2004","type":["Book","Book\/Illustrated","Photograph"],"holdingsCount":20,"versionCount":8,"relevance":{"score":"1.466704","value":"likely to be relevant"},"snippet":" September - 3 October ; Martin Browne Fine Art at the <b>Yellow<\/b> House and Martin Browne Fine Art at 22 Macleay"},{"id":"11189916","url":"\/work\/11189916","troveUrl":"http:\/\/trove.nla.gov.au\/work\/11189916","title":"Yellow screen with yellow [Yellow screen with yellow]","contributor":["PARTOS, Paul"],"issued":1968,"type":["Photograph"],"holdingsCount":1,"versionCount":1,"relevance":{"score":"1.4155728","value":"likely to be relevant"},"identifier":[{"type":"url","linktype":"fulltext","value":"http:\/\/artsearch.nga.gov.au\/Detail.cfm?IRN=81554&PICTAUS=TRUE"},{"type":"url","linktype":"thumbnail","value":"http:\/\/artsearch.nga.gov.au\/Images\/SML\/81554.jpg"}]},{"id":"37221741","url":"\/work\/37221741","troveUrl":"http:\/\/trove.nla.gov.au\/work\/37221741","title":"Untitled [Yellow]","contributor":["LEXIER, Micah KEMPSON, Michael CICADA PRESS"],"issued":2005,"type":["Art work"],"holdingsCount":1,"versionCount":1,"relevance":{"score":"1.246189","value":"likely to be relevant"},"identifier":[{"type":"url","linktype":"fulltext","value":"http:\/\/artsearch.nga.gov.au\/Detail.cfm?IRN=172536&PICTAUS=TRUE"},{"type":"url","linktype":"thumbnail","value":"http:\/\/artsearch.nga.gov.au\/Images\/SML\/172536.jpg"}]},{"id":"11189681","url":"\/work\/11189681","troveUrl":"http:\/\/trove.nla.gov.au\/work\/11189681","title":"Yellow command","contributor":["RISKE, Jan"],"issued":1988,"type":["Art work"],"holdingsCount":1,"versionCount":1,"relevance":{"score":"1.2452788","value":"likely to be relevant"},"identifier":[{"type":"url","linktype":"fulltext","value":"http:\/\/artsearch.nga.gov.au\/Detail.cfm?IRN=127878&PICTAUS=TRUE"},{"type":"url","linktype":"thumbnail","value":"http:\/\/artsearch.nga.gov.au\/Images\/SML\/127878.jpg"}]},{"id":"11189898","url":"\/work\/11189898","troveUrl":"http:\/\/trove.nla.gov.au\/work\/11189898","title":"(Yellow print)","contributor":["KINGSTON, Amie"],"issued":1930,"type":["Photograph"],"holdingsCount":1,"versionCount":1,"relevance":{"score":"1.2452788","value":"likely to be relevant"},"identifier":[{"type":"url","linktype":"fulltext","value":"http:\/\/artsearch.nga.gov.au\/Detail.cfm?IRN=45384&PICTAUS=TRUE"},{"type":"url","linktype":"thumbnail","value":"http:\/\/artsearch.nga.gov.au\/Images\/SML\/45384.jpg"}]},{"id":"11189790","url":"\/work\/11189790","troveUrl":"http:\/\/trove.nla.gov.au\/work\/11189790","title":"Yellow flute","contributor":["LINCOLN, Kevin AUSTRALIAN PRINT WORKSHOP"],"issued":1991,"type":["Art work"],"holdingsCount":1,"versionCount":1,"relevance":{"score":"1.243835","value":"likely to be relevant"},"identifier":[{"type":"url","linktype":"fulltext","value":"http:\/\/artsearch.nga.gov.au\/Detail.cfm?IRN=123372&PICTAUS=TRUE"},{"type":"url","linktype":"thumbnail","value":"http:\/\/artsearch.nga.gov.au\/Images\/SML\/123372.jpg"}]},{"id":"11189794","url":"\/work\/11189794","troveUrl":"http:\/\/trove.nla.gov.au\/work\/11189794","title":"Yellow guitar","contributor":["LINCOLN, Kevin AUSTRALIAN PRINT WORKSHOP"],"issued":1991,"type":["Art work"],"holdingsCount":1,"versionCount":1,"relevance":{"score":"1.243835","value":"likely to be relevant"},"identifier":[{"type":"url","linktype":"fulltext","value":"http:\/\/artsearch.nga.gov.au\/Detail.cfm?IRN=123371&PICTAUS=TRUE"},{"type":"url","linktype":"thumbnail","value":"http:\/\/artsearch.nga.gov.au\/Images\/SML\/123371.jpg"}]},{"id":"11189958","url":"\/work\/11189958","troveUrl":"http:\/\/trove.nla.gov.au\/work\/11189958","title":"Yellow square","contributor":["HICKEY, Dale WESTCOTT, Kim AUSTRALIAN PRINT WORKSHOP"],"issued":1993,"type":["Art work"],"holdingsCount":1,"versionCount":1,"relevance":{"score":"1.243835","value":"likely to be relevant"},"identifier":[{"type":"url","linktype":"fulltext","value":"http:\/\/artsearch.nga.gov.au\/Detail.cfm?IRN=123358&PICTAUS=TRUE"},{"type":"url","linktype":"thumbnail","value":"http:\/\/artsearch.nga.gov.au\/Images\/SML\/123358.jpg"}]}]}}]}}
        

Examples

Click on any of the examples below to open them in this console. If you want to use them in your own code you'll need to get an API key and add '&key=[Your API key]' to the url.

See the Trove API documentation for a full list of available parameters and detailed information on constructing queries.

Search everything

Parameters url
  • zone: all
  • q (query): wragge
  • encoding: xml (default)
  • n (number of results): 20 (default)
http://api.trove.nla.gov.au/result?q=wragge&zone=all
  • zone: all
  • q (query): wragge
  • encoding: json
  • n (number of results): 50
http://api.trove.nla.gov.au/result?q=wragge&zone=all&encoding=json&n=50
  • zone: all
  • q (query): nuc:ANL (contributor id)
  • encoding: json
  • n (number of results): 50
http://api.trove.nla.gov.au/result?q=nuc:ANL&zone=all&encoding=json
  • zone: all
  • q (query): wragge
  • encoding: json
  • n (number of results): 20 (default)
  • l-australian: y (in Australia or by Australians)
  • l-availability: y/f (freely accessible online)
http://api.trove.nla.gov.au/result?q=wragge&zone=all&encoding=json&l-australia=y&l-availability=y/f

Search newspapers

Parameters url
  • zone: newspaper
  • q (query): wragge AND weather
  • encoding: json
  • n (number of results): 20 (default)
http://api.trove.nla.gov.au/result?q=wragge+AND+weather&zone=newspaper&encoding=json
  • zone: newspaper
  • q (query): wragge AND weather
  • encoding: json
  • l-year: 1903
  • l-category: Article
  • n (number of results): 20 (default)
http://api.trove.nla.gov.au/result?q=wragge AND weather&zone=newspaper&encoding=json&l-year=1903
  • zone: newspaper
  • q (query): wragge AND weather
  • encoding: json
  • l-decade: 190
  • facet: year
  • n (number of results): 0
http://api.trove.nla.gov.au/result?q=wragge AND weather&zone=newspaper&encoding=json&l-decade=190&facet=year&n=0

Search other zones

Parameters url
  • zone: book,picture
  • q (query): wragge AND weather
  • encoding: json
  • n (number of results): 20 (default)
http://api.trove.nla.gov.au/result?q=wragge AND weather&zone=book,picture&encoding=json
  • zone: book
  • q (query): weather
  • encoding: json
  • l-format: Thesis
  • n (number of results): 20 (default)
http://api.trove.nla.gov.au/result?q=weather&zone=book&encoding=json&l-format=Thesis
  • zone: book
  • q (query): weather
  • encoding: json
  • facet: format
  • n (number of results): 0
http://api.trove.nla.gov.au/result?q=weather&zone=book&encoding=json&facet=format&n=0
  • zone: list
  • q (query): war memorials
  • encoding: json
http://api.trove.nla.gov.au/result?q=war memorials&zone=list&encoding=json

Get record

Parameters url
  • type: newspaper
  • article id: 41697877
  • reclevel: full
  • encoding: json
http://api.trove.nla.gov.au/newspaper/41697877?encoding=json&reclevel=full
  • type: newspaper
  • article id: 146871507
  • reclevel: full
  • include: articletext
http://api.trove.nla.gov.au/newspaper/41697877?reclevel=full&include=articletext
  • type: work
  • article id: 36904481
  • reclevel: full
  • encoding: json
http://api.trove.nla.gov.au/work/36904481?encoding=json&reclevel=full
  • type: work
  • article id: 34769014
  • reclevel: full
  • include: workVersions,holdings
  • encoding: json
http://api.trove.nla.gov.au/work/34769014?encoding=json&include=workVersions,holdings&reclevel=full
  • type: list
  • list id: 1442
  • reclevel: full
  • include: listItems
  • encoding: json
http://api.trove.nla.gov.au/list/1442?encoding=json&reclevel=full&include=listItems

List/get newspaper titles

Parameters url
  • state: vic
http://api.trove.nla.gov.au/newspaper/titles?state=vic
  • title id: 35
  • encoding: json
http://api.trove.nla.gov.au/newspaper/title/35?encoding=json
  • title id: 35
  • include: years
  • encoding: json
http://api.trove.nla.gov.au/newspaper/title/35?encoding=json&include=years

List/get Trove contributors

Parameters url
  • encoding: json
http://api.trove.nla.gov.au/contributor?encoding=json
  • NUC identifier: ANL
  • reclevel: full
  • encoding: json
http://api.trove.nla.gov.au/contributor/ANL?encoding=json&reclevel=full