Explore the workings of the Trove API (v3)
parameter | value |
---|---|
q | weather date:[* TO 1900] |
category | book |
encoding | json |
{
"query" : "weather date:[* TO 1900]",
"category" : [ {
"code" : "book",
"name" : "Books & Libraries",
"records" : {
"s" : "*",
"n" : 20,
"total" : 3853,
"next" : "https://api.trove.nla.gov.au/v3/result?q=weather+date%3A%5B*+TO+1900%5D&category=book&encoding=json&s=AoIIQnehiSpzdTExMzQ1MDc0",
"nextStart" : "AoIIQnehiSpzdTExMzQ1MDc0",
"work" : [ {
"id" : "9066928",
"url" : "https://api.trove.nla.gov.au/v3/work/9066928",
"troveUrl" : "https://trove.nla.gov.au/work/9066928",
"title" : "Monthly weather review",
"contributor" : [ "Australia. Bureau of Meteorology" ],
"issued" : "1900-2024",
"type" : [ "Periodical", "Periodical/Journal, magazine, other", "Government publication" ],
"snippet" : [ "Monthly <b>weather</b> review. Queensland. [electronic resource].", "Monthly <b>weather</b> review. Tasmania (Online)", " Climate Services Centre. \"The Monthly <b>Weather</b> Review - New South Wales is produced twelve times each year", " but informative overview of the temperatures, rainfall and significant <b>weather</b> events in New South" ],
"hasCorrections" : "N",
"relevance" : {
"score" : 119.0534896850586,
"value" : "very relevant"
},
"holdingsCount" : 31,
"versionCount" : 31,
"identifier" : [ {
"type" : "url",
"linktype" : "restricted",
"linktext" : "Find It link",
"value" : "http://mclink.library.mcgill.ca/sfx?url_ver=Z39.88-2004&ctx_ver=Z39.88-2004&ctx_enc=info:ofi/enc:UTF-8&rfr_id=info:sid/sfxit.com:opac_856&url_ctx_fmt=info:ofi/fmt:kev:mtx:ctx&sfx.ignore_date_threshold=1&rft.object_id=1000000000749995&svc_val_fmt=info:ofi/fmt:kev:mtx:sch_svc&"
} ]
}, {
"id" : "8061843",
"url" : "https://api.trove.nla.gov.au/v3/work/8061843",
"troveUrl" : "https://trove.nla.gov.au/work/8061843",
"title" : "A dictionary of weather / Storm Dunlop",
"contributor" : [ "Dunlop, Storm" ],
"issued" : "1900-2024",
"type" : [ "Book", "Book/Illustrated", "Periodical", "Periodical/Journal, magazine, other" ],
"snippet" : [ "Oxford Dictionary of <b>weather</b>.", "A dictionary of <b>weather</b> [electronic resource] /", " Dictionary -- App. A. <b>Weather</b> Records -- App. B. British Climate Data -- App. C. World Climate Data -- App. D", " -- Atmospheric Pressure -- Temperature. Searchable database of <b>weather</b>, forecasting, and climate terminology" ],
"hasCorrections" : "N",
"relevance" : {
"score" : 99.08318328857422,
"value" : "very relevant"
},
"holdingsCount" : 32,
"versionCount" : 15,
"identifier" : [ {
"type" : "url",
"linktype" : "restricted",
"linktext" : "Red Deer College Access",
"value" : "http://www.oxfordreference.com/views/BOOK_SEARCH.html?book=t16"
} ]
}, {
"id" : "5787260",
"url" : "https://api.trove.nla.gov.au/v3/work/5787260",
"troveUrl" : "https://trove.nla.gov.au/work/5787260",
"title" : "Atmosphere, weather and climate / Roger G. Barry and Richard J. Chorley",
"contributor" : [ "Barry, Roger Graham" ],
"issued" : "1900-2010",
"type" : [ "Book", "Book/Illustrated" ],
"snippet" : [ "Atmosphere, <b>weather</b> and climate /", "Atmosphere, <b>weather</b>, and climate (Barry : 8th ed.)", ", climate and <b>weather</b> prediction / T. N. Chase and R. G. Barry -- 9. Mid-latitude synoptic and mesoscale", " systems -- 10. <b>Weather</b> and climate in middle and high latitudes -- 11. Tropical <b>weather</b> and climate -- 12" ],
"hasCorrections" : "N",
"relevance" : {
"score" : 97.45072174072266,
"value" : "very relevant"
},
"holdingsCount" : 53,
"versionCount" : 33,
"identifier" : [ {
"type" : "url",
"linktype" : "restricted",
"linktext" : "Direct link to full text: http://openlibrary.org/details/atmosphereweathe00barr_091",
"value" : "http://openlibrary.org/books/OL23180653M"
} ]
}, {
"id" : "24427334",
"url" : "https://api.trove.nla.gov.au/v3/work/24427334",
"troveUrl" : "https://trove.nla.gov.au/work/24427334",
"title" : "Grassfires : fuel, weather and fire behaviour / Phil Cheney and Andrew Sullivan",
"contributor" : [ "Cheney, N. P. (Noel Phillip), 1940-" ],
"issued" : "1900-2008",
"type" : [ "Book", "Book/Illustrated", "Government publication" ],
"snippet" : [ "Grassfires : fuel, <b>weather</b> and fire behaviour /", "Grassfires fuel, <b>weather</b> and fire behaviour /", ". Available via World Wide Web. Description based upon print version of record. \"Grassfires: Fuel, <b>Weather</b> and", " in spinifex fuels; the effect of <b>weather</b> and topography on fire spread; wildfire suppression" ],
"hasCorrections" : "N",
"relevance" : {
"score" : 93.42568969726562,
"value" : "very relevant"
},
"holdingsCount" : 96,
"versionCount" : 12,
"identifier" : [ {
"type" : "url",
"linktype" : "restricted",
"linktext" : "ProQuest Ebook Central",
"value" : "http://public.ebookcentral.proquest.com/choice/publicfullrecord.aspx?p=408961"
} ],
"firstAustralians" : "Y"
}, {
"id" : "9023511",
"url" : "https://api.trove.nla.gov.au/v3/work/9023511",
"troveUrl" : "https://trove.nla.gov.au/work/9023511",
"title" : "Monthly weather review (Online)",
"contributor" : [ "American Meteorological Society" ],
"issued" : "1872-2024",
"type" : [ "Periodical", "Periodical/Journal, magazine, other" ],
"snippet" : [ "Monthly <b>weather</b> review", "Monthly <b>weather</b> review.", ". 1872-June 1891; by the <b>Weather</b> Bureau, July 1891-July 1966; by United States Environmental Science", ", December 2002. http://purl.oclc.org/DLF/benchrepro0212 MiAaHDL Online version of: Monthly <b>weather</b> review" ],
"hasCorrections" : "N",
"relevance" : {
"score" : 93.2549819946289,
"value" : "very relevant"
},
"holdingsCount" : 26,
"versionCount" : 2,
"identifier" : [ {
"type" : "url",
"linktype" : "restricted",
"linktext" : "Google",
"value" : "http://books.google.com/books?id=RdlGAQAAMAAJ"
} ]
}, {
"id" : "224740018",
"url" : "https://api.trove.nla.gov.au/v3/work/224740018",
"troveUrl" : "https://trove.nla.gov.au/work/224740018",
"title" : "The weather obsession / Lawrie Zion",
"contributor" : [ "Zion, Lawrie" ],
"issued" : "1900-2024",
"type" : [ "Book", "Book/Illustrated", "Book/Large print" ],
"snippet" : [ "The <b>weather</b> obsession /", "The <b>Weather</b> Obsession.", "Description based on print version record The <b>Weather</b> Obsession takes the temperature of modern", " <b>weather</b> media and investigates how it has fuelled our fascination with all things climatic. <b>Weather</b>" ],
"hasCorrections" : "N",
"relevance" : {
"score" : 87.687255859375,
"value" : "very relevant"
},
"holdingsCount" : 67,
"versionCount" : 4,
"identifier" : [ {
"type" : "url",
"linktype" : "restricted",
"linktext" : "ProQuest Ebook Central",
"value" : "https://ebookcentral.proquest.com/lib/qut/detail.action?docID=5683823"
} ]
}, {
"id" : "6325154",
"url" : "https://api.trove.nla.gov.au/v3/work/6325154",
"troveUrl" : "https://trove.nla.gov.au/work/6325154",
"title" : "The weather makers : the history and future impact of climate change / Tim Flannery",
"contributor" : [ "Flannery, Tim F. (Tim Fridtjof), 1956-" ],
"issued" : "1900-2012",
"type" : [ "Book", "Book/Illustrated", "Audio book" ],
"snippet" : [ "The <b>weather</b> makers : the history and future impact of climate change, Text Publishing, Melbourne", "The <b>weather</b> makers : how man is changing the climate and what it means for life on Earth /", " thing in common - we are now the <b>weather</b> makers, and the new climate we are creating threatens the", ": The <b>weather</b> makers. Geoff Bartholomew. Originally published in English: Melbourne : Text Publishing" ],
"hasCorrections" : "N",
"relevance" : {
"score" : 84.53450012207031,
"value" : "very relevant"
},
"holdingsCount" : 120,
"versionCount" : 53,
"identifier" : [ {
"type" : "url",
"linktype" : "thumbnail",
"value" : "https://nla.gov.au/nla.obj-1328975078-t"
}, {
"type" : "url",
"linktype" : "restricted",
"linktext" : "OverDrive",
"value" : "https://www.overdrive.com/search?q=EA30DCDB-80F0-4701-B673-3EA99172C8CC"
} ]
}, {
"id" : "37436514",
"url" : "https://api.trove.nla.gov.au/v3/work/37436514",
"troveUrl" : "https://trove.nla.gov.au/work/37436514",
"title" : "Weather / by Jill Anthony and Beverley Wheat",
"contributor" : [ "Anthony, Jill" ],
"issued" : "1900-2015",
"type" : [ "Book", "Book/Illustrated", "Government publication" ],
"snippet" : [ "<b>Weather</b>. Tells...... ... /", "<b>Weather</b> /" ],
"hasCorrections" : "N",
"relevance" : {
"score" : 81.39363098144531,
"value" : "very relevant"
},
"holdingsCount" : 54,
"versionCount" : 5
}, {
"id" : "232818931",
"url" : "https://api.trove.nla.gov.au/v3/work/232818931",
"troveUrl" : "https://trove.nla.gov.au/work/232818931",
"title" : "Amelia Bedelia under the weather / by Herman Parish ; pictures by Lynne Avril",
"contributor" : [ "Parish, Herman" ],
"issued" : "1900-2020",
"type" : [ "Book", "Book/Illustrated", "Audio book" ],
"snippet" : [ "AMELIA BEDELIA UNDER THE <b>WEATHER</b>.", "Under the <b>weather</b>.", "Guided reading level: K. Guided reading K. \"In Amelia Bedelia Under the <b>Weather</b>, Amelia Bedelia", " wakes up feeling, well, under the <b>weather</b>! But with a little rest, some delicious chicken soup, and a" ],
"hasCorrections" : "N",
"relevance" : {
"score" : 73.85408020019531,
"value" : "very relevant"
},
"holdingsCount" : 71,
"versionCount" : 8
}, {
"id" : "12968766",
"url" : "https://api.trove.nla.gov.au/v3/work/12968766",
"troveUrl" : "https://trove.nla.gov.au/work/12968766",
"title" : "Seasonal weather review, Australia / Commonwealth of Australia, Bureau of Meteorology, Department of the Interior",
"contributor" : [ "Australia. Bureau of Meteorology" ],
"issued" : "1900-2024",
"type" : [ "Periodical", "Periodical/Journal, magazine, other", "Government publication" ],
"snippet" : [ "Seasonal <b>weather</b> review, Australia", "Seasonal <b>weather</b> review, Australia /", " various monthly <b>weather</b> review publications of each state. Incorporates title: The <season> of <year> in" ],
"hasCorrections" : "N",
"relevance" : {
"score" : 73.37217712402344,
"value" : "very relevant"
},
"holdingsCount" : 13,
"versionCount" : 5
}, {
"id" : "6940231",
"url" : "https://api.trove.nla.gov.au/v3/work/6940231",
"troveUrl" : "https://trove.nla.gov.au/work/6940231",
"title" : "All in the blue unclouded weather / Robin Klein",
"contributor" : [ "Klein, Robin, 1936-" ],
"issued" : "1900-2017",
"type" : [ "Book", "Audio book", "Book/Braille" ],
"snippet" : [ "All in the blue unclouded <b>weather</b> [electronic resource] /", "All in the blue unclouded <b>weather</b> [sound recording] /", "All in the Blue Unclouded <b>Weather</b> begins the story of the Melling sisters, four girls growing up in", " 1992\" --cover. All in the Blue Unclouded <b>Weather</b> begins the story of the Melling sisters, four girls" ],
"hasCorrections" : "N",
"relevance" : {
"score" : 72.25382232666016,
"value" : "very relevant"
},
"holdingsCount" : 74,
"versionCount" : 10,
"identifier" : [ {
"type" : "url",
"linktype" : "thumbnail",
"value" : "https://nla.gov.au/nla.obj-1360705860-t"
}, {
"type" : "url",
"linktype" : "restricted",
"linktext" : "National edeposit: Onsite at Libraries Tasmania (Hobart Library)",
"value" : "https://nla.gov.au/nla.obj-1360705860"
} ]
}, {
"id" : "32134461",
"url" : "https://api.trove.nla.gov.au/v3/work/32134461",
"troveUrl" : "https://trove.nla.gov.au/work/32134461",
"title" : "Weather, climate, and society (Online)",
"contributor" : [ "American Meteorological Society" ],
"issued" : "1900-2024",
"type" : [ "Periodical", "Periodical/Journal, magazine, other" ],
"snippet" : [ "<b>Weather</b>, climate, and society.", "<b>Weather</b>, climate, and society (Online)" ],
"hasCorrections" : "N",
"relevance" : {
"score" : 69.05225372314453,
"value" : "very relevant"
},
"holdingsCount" : 8,
"versionCount" : 3,
"identifier" : [ {
"type" : "url",
"linktype" : "restricted",
"linktext" : "JSTOR",
"value" : "http://www.jstor.org/journal/weatclimsoci"
} ]
}, {
"id" : "157114304",
"url" : "https://api.trove.nla.gov.au/v3/work/157114304",
"troveUrl" : "https://trove.nla.gov.au/work/157114304",
"title" : "The Australian weather book : understanding our climate and how it affects us / Keith Colls, Dick Whitaker",
"contributor" : [ "Colls, Keith" ],
"issued" : "1900-2012",
"type" : [ "Book", "Book/Illustrated" ],
"snippet" : [ "The Australian <b>weather</b> book : understanding our climate and how it affects us /", "The Australian <b>weather</b> book : understanding our climate and how it affects us.", " change debates have made meteorology and the <b>weather</b> heated topics of debate. Australia has a unique", " climate. Learn more about it in this third edition of The Australian <b>Weather</b> Book. This book is a" ],
"hasCorrections" : "N",
"relevance" : {
"score" : 67.73118591308594,
"value" : "very relevant"
},
"holdingsCount" : 64,
"versionCount" : 6
}, {
"id" : "209107228",
"url" : "https://api.trove.nla.gov.au/v3/work/209107228",
"troveUrl" : "https://trove.nla.gov.au/work/209107228",
"title" : "Weather",
"contributor" : [ "Dorling Kindersley Limited" ],
"issued" : "1900-2016",
"type" : [ "Book/Illustrated", "Book" ],
"snippet" : [ "Eyewitness <b>weather</b>", "<b>Weather</b>.", " rain? How hot is a bolt of lightning? What makes hurricanes happen? Find out with Eyewitness <b>Weather</b>", ", discover all about a wide-range of <b>weather</b> conditions and how they are created. Eyewitness reference books" ],
"hasCorrections" : "N",
"relevance" : {
"score" : 66.64290618896484,
"value" : "very relevant"
},
"holdingsCount" : 26,
"versionCount" : 2
}, {
"id" : "11822445",
"url" : "https://api.trove.nla.gov.au/v3/work/11822445",
"troveUrl" : "https://trove.nla.gov.au/work/11822445",
"title" : "What days are for / Robert Dessaix",
"contributor" : [ "Dessaix, Robert, 1944-" ],
"issued" : "1900-2014",
"type" : [ "Book", "Book/Illustrated" ],
"snippet" : [ "What's wrong with our <b>weather</b>? the climatic threat of the 21st century", "What's wrong with our <b>weather</b>? the climatic threat of the 21st century [electronic resource]" ],
"hasCorrections" : "N",
"relevance" : {
"score" : 65.44721984863281,
"value" : "very relevant"
},
"holdingsCount" : 98,
"versionCount" : 3,
"identifier" : [ {
"type" : "url",
"linktype" : "restricted",
"linktext" : "Direct link to full text: http://openlibrary.org/details/whatswrongwithwe0000grib",
"value" : "http://openlibrary.org/books/OL4723059M"
} ]
}, {
"id" : "10886605",
"url" : "https://api.trove.nla.gov.au/v3/work/10886605",
"troveUrl" : "https://trove.nla.gov.au/work/10886605",
"title" : "Monthly weather review",
"contributor" : [ "Cuzin, Jean Pierre" ],
"issued" : "1872-2024",
"type" : [ "Periodical", "Periodical/Journal, magazine, other" ],
"snippet" : [ "Monthly <b>weather</b> review", "Monthly <b>weather</b> review.", " articles from the print title: Monthly <b>weather</b> review. Issued by: War Dept., Office of the Chief Signal", " Officer, Oct. 1872-June 1891; by the <b>Weather</b> Bureau, July 1891-July 1966; by United States Environmental" ],
"hasCorrections" : "N",
"relevance" : {
"score" : 65.09880828857422,
"value" : "very relevant"
},
"holdingsCount" : 10,
"versionCount" : 3,
"identifier" : [ {
"type" : "url",
"linktype" : "restricted",
"value" : "http://ams.allenpress.com/cgi-bin/omisapi.dll/ams?request=journal&journid=4"
} ]
}, {
"id" : "20058475",
"url" : "https://api.trove.nla.gov.au/v3/work/20058475",
"troveUrl" : "https://trove.nla.gov.au/work/20058475",
"title" : "Stormy weather / written by Katy Pike",
"contributor" : [ "Pike, Katy, 1965-" ],
"issued" : "1900-2012",
"type" : [ "Book/Illustrated", "Book" ],
"snippet" : [ "Stormy <b>weather</b> /", "Stormy <b>weather</b>.", "Primary school students. Junior primary school age. <b>Weather</b>. Last week we had a storm. The rain" ],
"hasCorrections" : "N",
"relevance" : {
"score" : 63.68947219848633,
"value" : "very relevant"
},
"holdingsCount" : 25,
"versionCount" : 4
}, {
"id" : "21992704",
"url" : "https://api.trove.nla.gov.au/v3/work/21992704",
"troveUrl" : "https://trove.nla.gov.au/work/21992704",
"title" : "Australian weather forecasts : explanation of weather cycles and estimate of probable weather during ... ..",
"contributor" : [ "Jones, Inigo, 1872-1954" ],
"issued" : "1900",
"type" : [ "Periodical", "Periodical/Journal, magazine, other" ],
"snippet" : [ "Australian <b>weather</b> forecasts : explanation of <b>weather</b> cycles and estimate of probable <b>weather</b>" ],
"hasCorrections" : "N",
"relevance" : {
"score" : 62.307945251464844,
"value" : "very relevant"
},
"holdingsCount" : 3,
"versionCount" : 1
}, {
"id" : "18886133",
"url" : "https://api.trove.nla.gov.au/v3/work/18886133",
"troveUrl" : "https://trove.nla.gov.au/work/18886133",
"title" : "Weather review, Western Australia",
"contributor" : [ "Australia. Bureau of Meteorology" ],
"issued" : "1900-2024",
"type" : [ "Periodical", "Periodical/Journal, magazine, other", "Government publication" ],
"snippet" : [ "<b>Weather</b> review, Western Australia.", "<b>Weather</b> review : Western Australia.", "Continued by: Monthly <b>weather</b> review, Western Australia. Jan. 1968-Dec. 1972. At head of title" ],
"hasCorrections" : "N",
"relevance" : {
"score" : 62.02438735961914,
"value" : "very relevant"
},
"holdingsCount" : 10,
"versionCount" : 5
}, {
"id" : "11345074",
"url" : "https://api.trove.nla.gov.au/v3/work/11345074",
"troveUrl" : "https://trove.nla.gov.au/work/11345074",
"title" : "Weather review. Bureau of Meteorology",
"contributor" : [ "Australia. Bureau of Meteorology" ],
"issued" : "1900-2024",
"type" : [ "Periodical", "Periodical/Journal, magazine, other", "Government publication" ],
"snippet" : [ "<b>Weather</b> review : Victoria.", "<b>Weather</b> review. Victoria." ],
"hasCorrections" : "N",
"relevance" : {
"score" : 61.90774917602539,
"value" : "very relevant"
},
"holdingsCount" : 10,
"versionCount" : 4
} ]
}
} ]
}
Version 3 of the API was made available in July 2023. For more information about the changes made in version 3 see the official release notes. I've also created a summary of breaking changes for users wanting to update their code from version 2 to version 3.
Click on any of the examples below to open them in this console, then modify them to suit. If you want to use them in your own code you'll need to get an API key and add the key to your request either using the key
parameter, or setting X-API-KEY
in the request headers.
See the Trove API v3 documentation for a full list of available parameters and detailed information on constructing queries.
For more examples, tools, and hacks using the Trove API see the GLAM Workbench.
See the Trove API v3 status page to check for problems.
https://api.trove.nla.gov.au/v3/result?q=wragge&category=all&encoding=json
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
wragge
|
|
category
|
category(ies) to search in (required) |
all
|
possible values are 'all', 'newspaper', 'magazine', 'image', 'research', 'book', 'diary', 'music', 'people', 'list' |
encoding
|
format of results |
json
|
possible values are 'xml' (default) or 'json' |
https://api.trove.nla.gov.au/v3/result?q=wragge&category=book,newspaper&encoding=json
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
wragge
|
|
category
|
category(ies) to search in (required) |
book,newspaper
|
separate multiple categorys with commas |
encoding
|
format of results |
json
|
possible values are 'xml' (default) or 'json' |
https://api.trove.nla.gov.au/v3/result?q=wragge&category=newspaper&encoding=json
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
wragge
|
|
category
|
category(ies) to search in (required) |
newspaper
|
|
encoding
|
format of results |
json
|
possible values are 'xml' (default) or 'json' |
https://api.trove.nla.gov.au/v3/result?q=wragge&category=newspaper&encoding=json
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query |
wragge
|
|
category
|
category(ies) to search in |
newspaper
|
|
encoding
|
format of results |
json
|
possible values are 'xml' (default) or 'json' |
https://api.trove.nla.gov.au/v3/result?q=wragge&category=newspaper&encoding=json&n=100
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query |
wragge
|
|
category
|
category(ies) to search in |
newspaper
|
|
encoding
|
format of results |
json
|
possible values are 'xml' (default) or 'json' |
n
|
number of results |
100
|
possible values are 0 to 100 (default is 20) |
https://api.trove.nla.gov.au/v3/result?q=wragge&category=newspaper&encoding=json&sortby=dateasc
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query |
wragge
|
|
category
|
category(ies) to search in |
newspaper
|
|
encoding
|
format of results |
json
|
possible values are 'xml' (default) or 'json' |
sortby
|
order of results |
dateasc
|
possible values are 'relevance' (default), 'dateasc', 'datedesc' |
https://api.trove.nla.gov.au/v3/result?q=wragge&category=newspaper&encoding=json&reclevel=full
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
wragge
|
|
category
|
category(ies) to search in (required) |
newspaper
|
|
encoding
|
format of results |
json
|
|
reclevel
|
request additional article metadata |
full
|
Adding reclevel=full
adds a number of additional fields to the article metadata, the actual fields added depends on the category. In newspapers and gazettes it adds illustrated
, wordCount
, correctionCount
, tagCount
, commentCount
, listCount
, trovePageUrl
, and pdf
(which is a link to a PDF of the whole page on which the article is published). In works it adds tagCount
, commentCount
, and listCount
.
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query |
wragge
|
|
category
|
category(ies) to search in |
newspaper
|
|
encoding
|
format of results |
json
|
possible values are 'xml' (default) or 'json' |
include
|
include extra information |
tags
|
possible values include 'tags', 'comments', and 'lists'; repeat parameter for multiple values |
include
|
include extra information |
comments
|
possible values include 'tags', 'comments', and 'lists'; repeat parameter for multiple values |
The accepted values for the include
parameter differ across categorys, but some values, like 'tags' and 'comments', are consistent. Other examples are included below.
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query |
wragge
|
|
category
|
category(ies) to search in |
newspaper
|
you can only harvest from one category at a time, so this must be set to a single category such as 'newspaper' |
encoding
|
format of results |
json
|
possible values are 'xml' (default) or 'json' |
bulkHarvest
|
setting this to 'true' ensures that results will stay in the same order when you request subsequent pages; without it results might be duplicated or missing |
true
|
|
s
|
supply a resumption token to get the next page of results |
*
|
use '*' for the first request, then replace with the value of |
Three parameters are important when harvesting a complete result set: category
must be set to a single category, bulkHarvest
set to 'true', and s
must be updated after each request with the value of nextStart
. Note that the nextStart
value will only appear if there is another page of results to download, so you can use it in your loop as a check to see if you've finished.
https://api.trove.nla.gov.au/v3/result?q=wragge&category=newspaper&encoding=json&l-category=Article
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
wragge
|
|
category
|
category(ies) to search in (required) |
newspaper
|
|
encoding
|
format of results |
json
|
|
l-category
|
category to include |
Article
|
see Trove help documentation, or use the |
This parameter can be used multiple times, however, this will behave like an AND
query and only those articles in all of the specified categories will be returned. So adding &l-category=Article&l-category=Advertising
will return zero results, as no articles are in both the 'Article' and 'Advertising' categories.
https://api.trove.nla.gov.au/v3/result?q=wragge&category=newspaper&encoding=json&l-state=Victoria
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
wragge
|
|
category
|
category(ies) to search in (required) |
newspaper
|
|
encoding
|
format of results |
json
|
|
l-state
|
place in which articles were published |
Victoria
|
possible values are 'ACT', 'International', 'National', 'New South Wales', 'Northern Territory', 'Queensland', 'South Australia', 'Tasmania', 'Victoria' |
This parameter can be used multiple times. Unlike the category
facet, this will behave like an OR
query, returning articles published in any of the specified places. So adding &l-state=Victoria&l-state=ACT
will return articles published in either Victoria or the ACT.
https://api.trove.nla.gov.au/v3/result?q=wragge&category=newspaper&encoding=json&l-decade=192
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
wragge
|
|
category
|
category(ies) to search in (required) |
newspaper
|
|
encoding
|
format of results |
json
|
|
l-decade
|
limit to articles from this decade |
192
|
192 includes the years 1920 to 1929 |
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
wragge
|
|
category
|
category(ies) to search in (required) |
newspaper
|
|
encoding
|
format of results |
json
|
|
l-decade
|
limit to articles from this decade |
192
|
|
l-year
|
limit to articles from this year ( |
1924
|
limit the results to articles from 1924, the |
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
wragge
|
|
category
|
category(ies) to search in (required) |
newspaper
|
|
encoding
|
format of results |
json
|
|
l-decade
|
limit to articles from this decade |
192
|
|
l-year
|
limit to articles from this year ( |
1924
|
limit the results to articles from 1924 |
l-month
|
limit to articles from this month ( |
3
|
limit the results to articles from March 1924, possible values are numbers from 1 to 12 |
https://api.trove.nla.gov.au/v3/result?q=firstpageseq:1&category=newspaper&encoding=json
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
firstpageseq:1
|
use the |
category
|
category(ies) to search in (required) |
newspaper
|
|
encoding
|
format of results |
json
|
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
date:[1942-10-31T00:00:00Z TO 1942-11-30T00:00:00Z]
|
use the |
category
|
category(ies) to search in (required) |
newspaper
|
|
encoding
|
format of results |
json
|
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
wragge date:[1942-11-01T00:00:00Z TO 1942-11-02T00:00:00Z]
|
use the |
category
|
category(ies) to search in (required) |
newspaper
|
|
encoding
|
format of results |
json
|
https://api.trove.nla.gov.au/v3/result?q=wragge&category=newspaper&encoding=json&l-illustrated=true
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
wragge
|
|
category
|
category(ies) to search in (required) |
newspaper
|
|
encoding
|
format of results |
json
|
|
l-illustrated
|
limit to articles with illustrations |
true
|
accepted values are 'true' or 'false' |
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
wragge
|
|
category
|
category(ies) to search in (required) |
newspaper
|
|
encoding
|
format of results |
json
|
|
l-illustrated
|
limit to articles with illustrations |
true
|
accepted values are 'true' or 'false' |
l-illustrationType
|
limit to articles with this type of illustration |
Photo
|
the |
This parameter can be used multiple times, however, this will behave like an AND
query and only those articles with all of the specified illustration types will be returned.
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
wragge
|
|
category
|
category(ies) to search in (required) |
newspaper
|
|
encoding
|
format of results |
json
|
|
l-wordCount
|
filter by number of words in the article |
<100 Words
|
accepted values are '<100 Words', '100 - 1000 Words', or '1000+ Words' |
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
wragge has:tags
|
add |
category
|
category(ies) to search in (required) |
newspaper
|
|
encoding
|
format of results |
json
|
|
include
|
tags
|
you need to specifically |
https://api.trove.nla.gov.au/v3/result?q=wragge&category=newspaper&encoding=json&include=articletext
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
wragge
|
|
category
|
category(ies) to search in (required) |
newspaper
|
|
encoding
|
format of results |
json
|
|
include
|
add additional information to the record |
articletext
|
this adds the full OCRd text to the record, other possible values are 'tags', 'comments' |
The OCRd text is return as HTML, so depending on you use you might need to strip the tags out.
https://api.trove.nla.gov.au/v3/result?q=%00&category=newspaper&encoding=json&facet=category&n=0
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
%00
|
'%00' is an empty search, so will return everything |
category
|
category(ies) to search in (required) |
newspaper
|
|
encoding
|
format of results |
json
|
|
n
|
0
|
we don't need results, just the facets, so we can set |
|
facet
|
include facet data |
category
|
break down results by category; see the Trove API documentation for a full list of facets |
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
%00
|
'%00' is an empty search, so will return everything |
category
|
category(ies) to search in (required) |
newspaper
|
|
encoding
|
format of results |
json
|
|
n
|
number of results |
0
|
we don't need results, just the facets, so we can set |
l-decade
|
set the decade |
192
|
needs to be set to find the totals by year |
facet
|
include facet data |
year
|
break down results by year in the given decade; see the Trove API documentation for a full list of facets |
For more examples using the year
facet see Visualise Trove newspaper searches over time in the GLAM Workbench.
https://api.trove.nla.gov.au/v3/result?q=weather&category=book&encoding=json&l-format=Thesis
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
weather
|
|
category
|
category(ies) to search in (required) |
book
|
|
encoding
|
format of results |
json
|
|
l-format
|
format or type of work |
Thesis
|
see the Trove help documentation for a list of formats |
This parameter can be used multiple times, however, this will behave like an AND
query and only those articles in all of the specified formats will be returned.
https://api.trove.nla.gov.au/v3/result?q=weather NOT format:Book &category=image&encoding=json
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
weather NOT format:Book
|
by adding |
category
|
category(ies) to search in (required) |
image
|
|
encoding
|
format of results |
json
|
You can use the format
index in both the query and as a facet, that means you can say that you don't want works with particular formats. This is handy for filtering out noise.
https://api.trove.nla.gov.au/v3/result?q=weather date:[* TO 1900]&category=book&encoding=json
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
weather date:[* TO 1900]
|
using the |
category
|
category(ies) to search in (required) |
book
|
|
encoding
|
format of results |
json
|
https://api.trove.nla.gov.au/v3/result?q=weather imageInd:thumbnail &category=image&encoding=json
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
weather imageInd:thumbnail
|
set |
category
|
category(ies) to search in (required) |
image
|
|
encoding
|
format of results |
json
|
The actual thumbnail link is included in the identifier
field with a linktype
of 'thumbnail'. To ensure you get all the possible values for identifier
you can also add &include=links
to your query.
https://api.trove.nla.gov.au/v3/result?q=wragge&category=image&encoding=json&include=workversions
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
wragge
|
|
category
|
category(ies) to search in (required) |
image
|
|
encoding
|
format of results |
json
|
|
include
|
format of results |
workversions
|
include the metadata for each individual version of this work |
The way that versions are grouped as works in Trove can be quite confusing. The work level metadata is generally quite consistent, but it can leave out useful metadata that's attached to an individual version. The version metadata is richer, but is also less consistent, so you have to be prepared for some trial and error if you want to extract information from it.
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
weather fullTextInd:y
|
set |
category
|
category(ies) to search in (required) |
magazine
|
|
encoding
|
format of results |
json
|
|
include
|
workversions
|
the full text is buried down in the version-level metadata, so you need to add this parameter if you want to actually get to it |
The fullTextInd
index seems quite misleading as it includes articles from commercial databases where only a truncated sample of the full text is actually available, and electronic legal deposit works where access to the text is restricted. It would seem better to combine this indicator with a search for "nla.obj" or nuc:ANL:DL
to try and limit to resources digitised by the NLA and partners.
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
weather
|
|
category
|
category(ies) to search in (required) |
magazine
|
|
encoding
|
format of results |
json
|
|
l-title
|
limit to this journal title |
The bulletin
|
There's no controlled list of journal titles to use with this facet, so you probably need to get the values from the web interface.
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
weather "https://nla.gov.au/nla.obj-68375465"
|
|
category
|
category(ies) to search in (required) |
magazine
|
|
encoding
|
format of results |
json
|
|
l-format
|
limit to this format |
Article
|
limit the results to articles so we don't get the records for the periodicals themselves |
An alternative to using the title
facet is to include the identifier of the parent journal in the q
parameter. This is how the Trove Digitised Journals app works.
parameter | parameter note | value | value note |
---|---|---|---|
q
|
the search query (optional) |
rights:Free
|
see the Trove help documentation for a full list of possible values for |
category
|
category(ies) to search in (required) |
image
|
|
encoding
|
format of results |
json
|
|
l-format
|
format of work |
Photo
|
|
include
|
workversions
|
the rights statements are attached to versions, so to see them you need to ask for the full versions data |
This facet only works with records where the copyright status is specified in the record. Some out-of-copyright photographs might be missing from results because their status has not been identified. A search for photos created before 1955 using date[* TO 1954]
might find additional out-of-copyright images.
Facets break the result set into sections and can provide a useful overview. Note that there are limits on the number of facets returned, so they might not include the whole result set.
https://api.trove.nla.gov.au/v3/result?category=all&facet=decade&n=0&encoding=json
parameter | parameter note | value | value note |
---|---|---|---|
category
|
category(ies) to search in (required) |
all
|
|
encoding
|
format of results |
json
|
|
facet
|
facet to return |
decade
|
|
n
|
number of results |
0
|
We just want facets, not the list of results. |
https://api.trove.nla.gov.au/v3/result?category=all&facet=partnerNuc&n=0&encoding=json
parameter | parameter note | value | value note |
---|---|---|---|
category
|
category(ies) to search in (required) |
all
|
|
encoding
|
format of results |
json
|
|
facet
|
facet to return |
partnerNuc
|
|
n
|
number of results |
0
|
We just want facets, not the list of results. |
Contributors are identified by NUC identifiers.
Article or work identifiers are supplied as part of the url rather than as a query parameter. For example, https://api.trove.nla.gov.au/v3/newspaper/41697877
returns the details of the article with the identifier 41697877
.
parameter | parameter note | value | value note |
---|---|---|---|
encoding
|
format of results |
json
|
|
reclevel
|
amount of detail in record |
full
|
|
include
|
include extra information |
articletext,tags,comments
|
include the OCRd text, as well as any tags or comments, in the record |
parameter | parameter note | value | value note |
---|---|---|---|
encoding
|
format of results |
json
|
|
reclevel
|
amount of detail in record |
full
|
|
include
|
include extra information |
workversions,tags,comments
|
include metadata from all grouped versions, as well as any tags or comments |
https://api.trove.nla.gov.au/v3/list/43805?encoding=json&reclevel=full&include=listitems
parameter | parameter note | value | value note |
---|---|---|---|
encoding
|
format of results |
json
|
|
reclevel
|
amount of detail in record |
full
|
|
include
|
include extra information |
listitems
|
include details of all items in the list |
You only get the brief record version for each of the list items, so to get extra information, such as OCRd text for a newspaper article, you'll have to request each article individually. Also, the list items are not paginated, so if you have a long list this will return a lot of data.
There's a bug in the API so that a request for newspaper titles also returns the gazette titles. See the GLAM Workbench for a workaround.
https://api.trove.nla.gov.au/v3/newspaper/titles?encoding=json
parameter | parameter note | value | value note |
---|---|---|---|
encoding
|
format of results |
json
|
https://api.trove.nla.gov.au/v3/gazette/titles?encoding=json
parameter | parameter note | value | value note |
---|---|---|---|
encoding
|
format of results |
json
|
https://api.trove.nla.gov.au/v3/newspaper/titles?encoding=json&state=vic
parameter | parameter note | value | value note |
---|---|---|---|
encoding
|
format of results |
json
|
|
state
|
limit to this state |
vic
|
possible values are 'nsw', 'act', 'qld', 'tas', 'sa', 'nt', 'wa', 'vic', 'national' |
https://api.trove.nla.gov.au/v3/newspaper/title/35?encoding=json&include=years
parameter | parameter note | value | value note |
---|---|---|---|
encoding
|
format of results |
json
|
|
include
|
years
|
list the years available on Trove, with the number of issues per year |
The newspaper identifier is included in the url as indicated. This example will return details of the Sydney Morning Herald which has an identifier of '35'.
parameter | parameter note | value | value note |
---|---|---|---|
encoding
|
format of results |
json
|
|
include
|
years
|
this needs to be included to retrieve the full issue information |
|
range
|
date range of issues to return |
18420101-18421231
|
dates are in YYYYMMDD format; this example will return details of all issues of the Sydney Morning Herald published in 1842 |
The issue details include a publication date and a url which redirects to the first page of the issue.
Although this endpoint is included in the technical documention, as of 23 May 2023 it was returning no results. Hopefully it'll start working soon!
https://api.trove.nla.gov.au/v3/magazine/titles?encoding=json
parameter | parameter note | value | value note |
---|---|---|---|
encoding
|
format of results |
json
|
Organisations can be nested under other organisations (as children
), this makes the data structure a bit complex.
https://api.trove.nla.gov.au/v3/contributor?q=&encoding=json
parameter | parameter note | value | value note |
---|---|---|---|
q
|
search query (optional) |
|
leave blank for everything |
encoding
|
format of results |
json
|
https://api.trove.nla.gov.au/v3/contributor/ANL?encoding=json&reclevel=full
parameter | parameter note | value | value note |
---|---|---|---|
encoding
|
format of results |
json
|
|
reclevel
|
amount of detail to return |
full
|
The organisation's identifier is included in the url as indicated. This example retrieves details for the National Library of Australia, whose identifier is 'ANL'.