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.

Clear


          {"article":{"id":"41697877","url":"\/newspaper\/41697877","heading":"WRAGGE AND WEATHER CYCLES.","category":"Article","title":{"id":"101","value":"Western Mail (Perth, WA : 1885 - 1954)"},"date":"1922-11-23","page":4,"pageSequence":4,"troveUrl":"https:\/\/trove.nla.gov.au\/ndp\/del\/article\/41697877","illustrated":"N","wordCount":1054,"correctionCount":1,"listCount":0,"tagCount":0,"commentCount":0,"lastCorrection":{"by":"*anon*","lastupdated":"2016-09-12T07:08:57Z"},"identifier":"https:\/\/nla.gov.au\/nla.news-article41697877","trovePageUrl":"https:\/\/trove.nla.gov.au\/ndp\/del\/page\/3522839","pdf":"https:\/\/trove.nla.gov.au\/ndp\/imageservice\/nla.news-page3522839\/print","articleText":"<p><span>  WRAGGE  ÁNP  WEATHER  CYCLES.<\/span><\/p> <p><span>  \"W.E.H.,\"  Kendenup,  writes:-Your<\/span><span>    interesting  article  in  last    \"Mail\"  re<\/span><\/p> <p><span>  Clement  Wragge  and  forecasts,  is<\/span><span>  much  to  the  point.  I  once  heard<\/span><span>    him  lecture,  he  seemed  very  eccen<\/span><\/p> <p><span>  tric,  but  there  was  a  strain  of  com-<\/span><span>  mon  sense  running  through  his  lec-<\/span><span>  ture,  as  he  continually  reminded<\/span><\/p> <p><span>  his  hearers  that  they  should  con-<\/span><span>    serve  water  for  dry  periods,  and<\/span><\/p> <p><span>  concluded  his  address  with  the<\/span><span>  words,  \"Dam!  Dam!!  Dam!!!<\/span><\/p> <p><span>  Some  years  ago  I  read  an  article  on<\/span><span>    weather  records  for,  I  think,  New<\/span><\/p> <p><span>  South  Wales.  The  writer  had  an-<\/span><span>  alysed  the  records  as  far  back  as<\/span><span>  they  went,  and  his  conclusions  were<\/span><span>  that  all  years  ending  in  2  and  8<\/span><span>  were  more  or  less  dry.  .  My  'own<\/span><span>  experience  goes  back  lo    1888,  and<\/span><\/p> <p><span>  1  can  corroborate  his  statement.  ln<\/span><span>  '88  1  was  on  the  Darling,  and  we<\/span><span>  had  1  inch  and  4  points  of  rain  for<\/span><span>    the  year;  '92  was  dry,  '98  dry,  1902<\/span><\/p> <p><span>  dry,  1908  dry;    I  don't  remember<\/span><span>  about  1912.  but  1918  was  dry,  and<\/span><span>  1922  is  a  disastrous  year  in  parts<\/span><span>  of  New  South  Wales  and  Queens-<\/span><span>  land.  Can  you  tell  us  how  West-<\/span><span>  ern  Australian  records  compare<\/span><span>  with  those  dates?  lt  would  be  in-<\/span><span>  teresting  to  know.<\/span><\/p> <p><span>  The  above  letter  is  very  Interesting,<\/span><span>  and  I  am  pleased  to  see  that  \"W.E.H.\"<\/span><span>  supports  me,  and  emphasises  the  point<\/span><span>  I  desired  to  impress  upon  readers,  viz.,<\/span><span>  while  it  would  be  very  foolish  for  a<\/span><span>  farmer  to  try  and  farm  according  to  the<\/span><span>  predictions  of  Mr.  Wragge,  all  will  be<\/span><span>  acting  wisely  by  attending  to  his  sound<\/span><span>  advice  in  regard  to  thc  conservation  of<\/span><span>  fodder  and  moisture.  The  wise  man<\/span><span>  many,  many  centuries  ago  said  in  effect:<\/span><span>  **He  that,  observeth  the  wind  shall  not<\/span><span>  sow.  and  he  that  regardeth  the  clouds<\/span><span>  shall  not  reap''  (Eccles.  11,  iv.).  He  that<\/span><span>  regardeth.  Mr.  Wragge's  prediction  will<\/span><span>  be  in  a  simliar  position;  but  he  that<\/span><span>  regardeth  his  advice  to  Dam!  Dam!'.<\/span><span>  Dam!!.!  and  to  conserve  fodder  will  sow<\/span><span>  and  reap  consistently  year  by  year,  in<\/span><span>  average  years,  and  will  not  fear  an  oc-<\/span><span>  casional  dry  season.<\/span><\/p> <p><span>  About  Cycles.<\/span><\/p> <p><span>  Wi  til  regard  to  the  years  ending  in  2<\/span><span>  and  8,  I  have  looked  .up  tho  records  since<\/span><span>  1878  for  Perth,  arid  for  Northampton<\/span><span>  since  1S82.  There  is  nothing  in  the<\/span><span>  records  to  indicate  that,  any  such  rule  as<\/span><span>  that  mentioned  by  \"W.E.H.\"  will  hold.<\/span><span>  The  years  ending  in  2  und  S  do  not  iu<\/span><span>  1  elude  any  of  the  bad  years.  Taking<\/span><\/p> <p><span>  Perth,  three  ol'  tho  years  are  consider-<\/span><span>  ably  over  the  average,  and  six  are<\/span><span>  slightly  under,  but  they  aro  not  bad<\/span><span>  years.  The  same  general  remark<\/span><span>  holds  with  regard  to  Northampton.<\/span><\/p> <p><span>  I  may  herc  mention  that  when  1  lived<\/span><span>  in  Adelaide.  I  very  frequently  met  my<\/span><span>  friend  Mr.  Griffiths,  the  State  Meteorolo-<\/span><span>  gist,  who  was  afterwards  the  Chief  of<\/span><span>  Staff  at  the  Federal  Weather  Bureau.<\/span><span>  At  one  time  Mr.  Bussell,  astronomer<\/span><span>  in  charge'  of  the  'Sydney  Observatory,<\/span><span>  published  a  paper  hi  whick  he  en-<\/span><span>  deavoured  to  show  that,  the  W'cather  of<\/span><span>  Now  South  Wales  was  dominated  by  a<\/span><span>  cycle  of,  1  think,  13  years.  Mr.  Grif-<\/span><span>  fiths  occupied  his  snare  time  for  a  con-<\/span><span>  siderable  period  tabulating  tho  rainfall<\/span><span>  figures-  for  South  Australia,  which  ex-<\/span><span>  tend  over  a  greater  period  than  auy  ot<\/span><span>  the  other  States.  He  arranged  them<\/span><span>  in  every  manner  ho  could  think  of,  but<\/span><span>  no  arrangement  indicated  the  existence<\/span><span>  of  a  definite  cyclo.  1  remember  his<\/span><\/p> <p><span>  saying  very  distinctly;  \"Thc  figures  given<\/span><span>  toy  Sir.  Russell  seem  to  be  conclusive,\"<\/span><span>  but  if  other  sets  of  stations  in  New<\/span><span>  South  Wales  be  taken,  different  results<\/span><span>  would  be  suggested,  and  it  looks  very<\/span><span>  much  as  though  Mr.  Russell  had  follow-<\/span><span>  ed  a  common  practice  of  forming  a<\/span><span>  theory  and  then  looking  for  records<\/span><span>  which  would  support  it.\"  With  regard<\/span><span>  to  Knuth  Australia,  Mr.  Griffiths  could<\/span><span>  obtain  no  evidence  of  the  existence  of<\/span><span>  a  definite  cycle,  either  -  of  7  years,  13<\/span><span>  years,  or  any  other  period.<\/span><\/p> <p><span>  I  have  on  my  shelves  a  book  called<\/span><span>  Egerson's  \"Weather  System  .  of  Sun<\/span><span>  '  Spot  Causality.\"  Mr.  Egerson  was  a<\/span><span>  member  of  the  staff  of  thc  Sydney  Ob-<\/span><span>  servatory,  and  endeavoured  to  show  how<\/span><span>  forecasting  may  be  done  for  periods  of.<\/span><span>  a  week,  for  several  months,  fer  a  few<\/span><span>  years,  and  for  a  series  of  years  iu  ad-<\/span><span>  vance,  and  he  speaks  of  cycles.  1  will<\/span><span>  not,  however,  go  further  into  this  mitt-<\/span><span>  ler  now  than  to  say  that,  while  looking<\/span><span>  at  (he  subject  from  an  unbiassed  point<\/span><span>  !  of  view,  I  have  come  to  the  conclusion<\/span><span>  j  that  no  one  has  definitely  proved  the  cx<\/span><span>  .  istence  of  any  definite  cycle.  At  the<\/span><\/p> <p><span>  same  time,  there  may  be,  and  probably<\/span><span>  is,  a  general  periodicity  in  regard  to  the<\/span><span>  seasons,  but  the  periods  arc  more  or<\/span><span>  less  irregular,  and  our  evidence  at  pre-<\/span><span>  sent  does  not  enable  us  to  go  further<\/span><span>  than  to  speak  in  very  general  terms.<\/span><span>  We  are  perfectly  safe  in  concluding<\/span><span>  that  after  a  scries  of  good  years  we  aro<\/span><span>  sure  to  get  some  bad  ones,  and  after<\/span><span>  the  bad  years  wc  are.  sure  to  get  good<\/span><span>  ones.  Tuuo  we  como  back  again  to  thc  one<\/span><span>  safe  rule  for  tho.  farmer,  that  he  should<\/span><span>  curry  on  his  work  for  average  condi-<\/span><span>  tions,  and  thou  lie  will  get  average,  re-<\/span><span>  sults.  If  ho  conserves  water  and  fod-<\/span><span>  der  ¡ti  (he  good  periods  he  will  havc_  a<\/span><span>  reserve  for  the  dry  periods,  and,  like<\/span><span>  Joseph,  ho  will  be  able  to  sell  his  re-<\/span><span>  serves  lo  his  loss,  thrifty  neighbours.<\/span><\/p> <p><span>  Fruit  '  Prices.<\/span><\/p> <p><span>  I  duly  received  (he  clipping  about-the<\/span><span>  orange  prices.  I  do  not  think  that  you<\/span><span>  should  attach  very  much  importance  to<\/span><span>  the  article  you  sent.  As  a  matter  of<\/span><span>  fact,  experience  in  different  markets  and<\/span><span>  different  places  contradict  ono  another<\/span><span>  very  considerably.  It  is  .only  a  little<\/span><span>  while  ago  that  1  read  aa  article  urging<\/span><span>  that  people  should  grow  Valencias,  be-<\/span><span>  cause  certain  shipments  of  those  had<\/span><span>  realised  higher  prices  than  Navels.<\/span><span>  Sometimos  it  is  one  way  and  sometimes<\/span><span>  tho  other.  With  regard  to  the  brown<\/span><span>  heart  in  the  apple.  1  think  the  trouble<\/span><span>  I  has  boen  duo  to  want  of  cave  on  the<\/span><\/p> <p><span>  part  of  tho  ship  engineers,  and  I  am  iu<\/span><span>  1  dined  to  think  (hat  the  trouble  xviii  be<\/span><\/p> <p><span>  largely  overcome  next  year.<\/span><\/p> "}}
        

Examples

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 &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.

For more examples, tools, and hacks using the Trove API see the GLAM Workbench.

Basic search

Search all zones

https://api.trove.nla.gov.au/v2/result?q=wragge&zone=all

parameter parameter note value value note
q

the search query (required)

wragge

use a space or a '+' to get everything

zone

zone(s) to search in (required)

all

possible values are 'all', 'newspaper', 'gazette', 'book', 'article', 'picture', 'music', 'map', 'collection', 'list', 'people'

Search in multiple zones

https://api.trove.nla.gov.au/v2/result?q=wragge&zone=book,newspaper

parameter parameter note value value note
q

the search query (required)

wragge
zone

zone(s) to search in (required)

book,newspaper

separate multiple zones with commas

Search in a single zone

https://api.trove.nla.gov.au/v2/result?q=wragge&zone=newspaper

parameter parameter note value value note
q

the search query (required)

wragge
zone

zone(s) to search in (required)

newspaper

Change the results format

https://api.trove.nla.gov.au/v2/result?q=wragge&zone=newspaper&encoding=json

parameter parameter note value value note
q

the search query

wragge
zone

zone(s) to search in

newspaper
encoding

format of results

json

possible values are 'xml' (default) or 'json'

Change the number of results

https://api.trove.nla.gov.au/v2/result?q=wragge&zone=newspaper&encoding=json&n=100

parameter parameter note value value note
q

the search query

wragge
zone

zone(s) 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)

Change the sort order

https://api.trove.nla.gov.au/v2/result?q=wragge&zone=newspaper&encoding=json&sort_by=dateasc

parameter parameter note value value note
q

the search query

wragge
zone

zone(s) 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'

Get the full metadata for each record

https://api.trove.nla.gov.au/v2/result?q=wragge&zone=newspaper&encoding=json&reclevel=full

parameter parameter note value value note
q

the search query (required)

wragge
zone

zone(s) 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 zone. 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.

Include extra information in each record

https://api.trove.nla.gov.au/v2/result?q=wragge&zone=newspaper&encoding=json&include=tags,comments

parameter parameter note value value note
q

the search query

wragge
zone

zone(s) to search in

newspaper
encoding

format of results

json

possible values are 'xml' (default) or 'json'

include

include extra information

tags,comments

possible values include 'tags' and 'comments'; separate multiple values with commas

The accepted values for the include parameter differ across zones, but some values, like 'tags' and 'comments', are consistent. Other examples are included below.

Harvesting a complete result set

https://api.trove.nla.gov.au/v2/result?q=wragge&zone=newspaper&encoding=json&bulkHarvest=true&s=*

parameter parameter note value value note
q

the search query

wragge
zone

zone(s) to search in

newspaper

you can only harvest from one zone at a time, so this must be set to a single zone 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 nextStart for subsequent results

Three parameters are important when harvesting a complete result set: zone must be set to a single zone, 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.

Searching newspapers or gazettes

Limit results by article category

https://api.trove.nla.gov.au/v2/result?q=wragge&zone=newspaper&encoding=json&l-category=Article

parameter parameter note value value note
q

the search query (required)

wragge
zone

zone(s) to search in (required)

newspaper
encoding

format of results

json
l-category

category to include

Article

see Trove help documentation, or use the category facet for full list of possible values

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.

Limit results by place of publication

https://api.trove.nla.gov.au/v2/result?q=wragge&zone=newspaper&encoding=json&l-state=Victoria

parameter parameter note value value note
q

the search query (required)

wragge
zone

zone(s) 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.

Limit results by decade

https://api.trove.nla.gov.au/v2/result?q=wragge&zone=newspaper&encoding=json&l-decade=192

parameter parameter note value value note
q

the search query (required)

wragge
zone

zone(s) 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

Limit results by year

https://api.trove.nla.gov.au/v2/result?q=wragge&zone=newspaper&encoding=json&l-decade=192&l-year=1924

parameter parameter note value value note
q

the search query (required)

wragge
zone

zone(s) 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 (l-decade must also be set)

1924

limit the results to articles from 1924, the l-decade parameter must be set to 192

Limit results by month

https://api.trove.nla.gov.au/v2/result?q=wragge&zone=newspaper&encoding=json&l-decade=192&l-year=1924&l-month=3

parameter parameter note value value note
q

the search query (required)

wragge
zone

zone(s) 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 (l-decade must also be set)

1924

limit the results to articles from 1924

l-month

limit to articles from this month (l-decade and l-year must also be set)

3

limit the results to articles from March 1924, possible values are numbers from 1 to 12

Find articles on a specific page of a newspaper

https://api.trove.nla.gov.au/v2/result?q=firstpageseq:1&zone=newspaper&encoding=json

parameter parameter note value value note
q

the search query (required)

firstpageseq:1

use the firstpageseq index in the query to specify a page number, firstpageseq:1 will find articles on page 1

zone

zone(s) to search in (required)

newspaper
encoding

format of results

json

Find newspaper articles within a specific date range

https://api.trove.nla.gov.au/v2/result?q=date:[1942-10-31T00:00:00Z TO 1942-11-30T00:00:00Z]&zone=newspaper&encoding=json

parameter parameter note value value note
q

the search query (required)

date:[1942-10-31T00:00:00Z TO 1942-11-30T00:00:00Z]

use the date index to specify a date range; the first date in the range is not included in the query, so this example searches for articles from November 1942

zone

zone(s) to search in (required)

newspaper
encoding

format of results

json

Find newspaper articles from a particular day

https://api.trove.nla.gov.au/v2/result?q=date:[1942-11-01T00:00:00Z TO 1942-11-02T00:00:00Z]&zone=newspaper&encoding=json

parameter parameter note value value note
q

the search query (required)

wragge date:[1942-11-01T00:00:00Z TO 1942-11-02T00:00:00Z]

use the date index to specify a date range; the first date in the range is not included in the query, so this example searches for articles from 2 November 1942

zone

zone(s) to search in (required)

newspaper
encoding

format of results

json

Limit to articles with illustrations

https://api.trove.nla.gov.au/v2/result?q=wragge&zone=newspaper&encoding=json&l-illustrated=true

parameter parameter note value value note
q

the search query (required)

wragge
zone

zone(s) to search in (required)

newspaper
encoding

format of results

json
l-illustrated

limit to articles with illustrations

true

accepted values are 'true' or 'false'

Limit to articles with photographs

https://api.trove.nla.gov.au/v2/result?q=wragge&zone=newspaper&encoding=json&l-illustrated=true&l-illtype=Photo

parameter parameter note value value note
q

the search query (required)

wragge
zone

zone(s) 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-illtype

limit to articles with this type of illustration

Photo

the l-illustrated facet must be set to 'true'; common values include 'Photo', 'Cartoon', 'Map', and 'Illustration', set facet to 'illtype' to see all possible values

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.

Filter articles by number of words

https://api.trove.nla.gov.au/v2/result?q=wragge&zone=newspaper&encoding=json&l-word=<100 Words

parameter parameter note value value note
q

the search query (required)

wragge
zone

zone(s) to search in (required)

newspaper
encoding

format of results

json
l-word

filter by number of words in the article

<100 Words

accepted values are '<100 Words', '100 - 1000 Words', or '1000+ Words'

Limit to articles with tags (or comments)

https://api.trove.nla.gov.au/v2/result?q=wragge has:tags&zone=newspaper&encoding=json&include=tags

parameter parameter note value value note
q

the search query (required)

wragge has:tags

add has:tags to limit to articles with tags; has:comments will similarly limit to articles with comments

zone

zone(s) to search in (required)

newspaper
encoding

format of results

json
include tags

you need to specifically include tags to see the tag values; change to 'comments' to include any comments

Get the OCRd text for each article

https://api.trove.nla.gov.au/v2/result?q=wragge&zone=newspaper&encoding=json&include=articletext

parameter parameter note value value note
q

the search query (required)

wragge
zone

zone(s) 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.

Get the number of articles in each category

https://api.trove.nla.gov.au/v2/result?q=+&zone=newspaper&encoding=json&facet=category&n=0

parameter parameter note value value note
q

the search query (required)

+

'+' is an empty search, so will return everything

zone

zone(s) to search in (required)

newspaper
encoding

format of results

json
n 0

we don't need results, just the facets, so we can set n to 0

facet

include facet data

category

break down results by category; see the Trove API documentation for a full list of facets

Get the number of articles per year in a decade

https://api.trove.nla.gov.au/v2/result?q=+&zone=newspaper&encoding=json&l-decade=192&facet=year&n=0

parameter parameter note value value note
q

the search query (required)

+

'+' is an empty search, so will return everything

zone

zone(s) 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 n to 0

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.

Searching other zones

Limit to works with a particular format

https://api.trove.nla.gov.au/v2/result?q=weather&zone=book&encoding=json&l-format=Thesis

parameter parameter note value value note
q

the search query (required)

weather
zone

zone(s) 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.

Exclude works with a particular format

https://api.trove.nla.gov.au/v2/result?q=weather NOT format:Book &zone=picture&encoding=json

parameter parameter note value value note
q

the search query (required)

weather NOT format:Book

by adding NOT format:Book to the query we should filter out books

zone

zone(s) to search in (required)

picture
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.

Limit to works created within a particular date range

https://api.trove.nla.gov.au/v2/result?q=weather date:[* TO 1900]&zone=book&encoding=json

parameter parameter note value value note
q

the search query (required)

weather date:[* TO 1900]

using the date index you can specify a range of years; use '*' to indicate the earliest or latest possible dates, this example will return all works published in 1900 or before

zone

zone(s) to search in (required)

book
encoding

format of results

json

Limit to works with a thumbnail image

https://api.trove.nla.gov.au/v2/result?q=weather imageInd:thumbnail &zone=picture&encoding=json

parameter parameter note value value note
q

the search query (required)

weather imageInd:thumbnail

set imageInd to 'thumbnail' to limit results to works that include a thumbnail link

zone

zone(s) to search in (required)

picture
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.

Include metadata from all versions of a work

https://api.trove.nla.gov.au/v2/result?q=wragge&zone=picture&encoding=json&include=workversions

parameter parameter note value value note
q

the search query (required)

wragge
zone

zone(s) to search in (required)

picture
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.

Find works with full text

https://api.trove.nla.gov.au/v2/result?q=weather fullTextInd:y&zone=article&encoding=json&include=workversions

parameter parameter note value value note
q

the search query (required)

weather fullTextInd:y

set fullTextInd to 'y' to return only articles with full text

zone

zone(s) to search in (required)

article
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.

Limit to articles from a specific digitised journal (using facets)

https://api.trove.nla.gov.au/v2/result?q=weather&zone=article&encoding=json&l-title=The bulletin

parameter parameter note value value note
q

the search query (required)

weather
zone

zone(s) to search in (required)

article
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.

Limit to articles from a specific digitised journal (using identifiers)

https://api.trove.nla.gov.au/v2/result?q=weather "https://nla.gov.au/nla.obj-68375465"&zone=article&encoding=json&l-format=Article

parameter parameter note value value note
q

the search query (required)

weather "https://nla.gov.au/nla.obj-68375465"
zone

zone(s) to search in (required)

article
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.

https://api.trove.nla.gov.au/v2/result?q=rights:Free&zone=picture&encoding=json&include=workversions

parameter parameter note value value note
q

the search query (required)

rights:Free

see the Trove help documentation for a full list of possible values for rights

zone

zone(s) to search in (required)

picture
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.

Get individual records

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/v2/newspaper/41697877 returns the details of the article with the identifier 41697877.

Get a newspaper or gazette article

https://api.trove.nla.gov.au/v2/newspaper/41697877?encoding=json&reclevel=full&include=articletext,tags,comments

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

Get a work record

https://api.trove.nla.gov.au/v2/work/1144040?encoding=json&reclevel=full&include=workversions,tags,comments

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

Get a list

https://api.trove.nla.gov.au/v2/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.

Get newspaper and gazette titles

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.

Get a list of all newspaper titles

https://api.trove.nla.gov.au/v2/newspaper/titles?encoding=json

parameter parameter note value value note
encoding

format of results

json

Get a list of all gazette titles

https://api.trove.nla.gov.au/v2/gazette/titles?encoding=json

parameter parameter note value value note
encoding

format of results

json

Get a list of newspapers from a particular state

https://api.trove.nla.gov.au/v2/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'

Get the number of issues per year for a particular newspaper

https://api.trove.nla.gov.au/v2/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'.

Get details of newspaper issues within a date range

https://api.trove.nla.gov.au/v2/newspaper/title/35?encoding=json&include=years&range=18420101-18421231

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.

Get Trove contributors

Organisations can be nested under other organisations (as children), this makes the data structure a bit complex.

Get a list of organisations contributing data to Trove

https://api.trove.nla.gov.au/v2/contributor?encoding=json

parameter parameter note value value note
encoding

format of results

json

Get full details of an organisation contributing to Trove

https://api.trove.nla.gov.au/v2/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'.