Introduction
This vignette provides an overview of how to use the finna package.
To make a simple search use the following code.
library(finna)
record <- search_finna("sibelius")
print(record)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 lapinkirjasto.15… Sibe… Sibel… 2001 NA Äänite… orkeste… Lapin … NA
## 2 anders.429115 SIBE… TAWAS… 1997 fin Kirja,… SIBELIUS Anders… NA
## 3 anders.149748 Sibe… Tawas… 1997 fin Kirja,… Sibeliu… Anders… NA
## 4 helka.9916268273… Sibe… Lampi… 1984 fin Kirja,… Sibeliu… Helka-… NA
## 5 arto.000273642 Sibe… Tawas… 2003 fin Kirja,… Sibeliu… Kansal… NA
## 6 kirkes.78220 Sibe… Ringb… 1948 fin Kirja,… Sibeliu… Kirkes… NA
## 7 outi.28693 Sibe… Downe… 1945 fin Kirja,… Sibeliu… OUTI-k… NA
## 8 vaasa.84b5d12b-d… SIBE… Lampi… 1995 fin Kirja,… Sibeliu… Vaasan… NA
## 9 vaasa.91b2ccb1-d… Sibe… Tawas… 2003 fin Kirja,… Sibeliu… Vaasan… NA
## 10 helle.124172 Sibe… Tawas… 1968 swe Kirja,… Sibeliu… Helle-… NA
## # ℹ 90 more rows
Searching as subject
library(finna)
record <- search_finna(query = '"orkesterimusiikki"', type = "Subject", lng = "en-gb")
print(record)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 fikka.1505988 Konsertt… Helsi… 1902 swe Book m… orkeste… The Na… NA
## 2 fikka.1505975 Konsertt… Helsi… 1912 fin Book m… 1910-lu… The Na… NA
## 3 fikka.1505980 Konsertt… Helsi… 1912 fin Book m… 1910-lu… The Na… NA
## 4 fikka.1506009 Konsertt… Helsi… 1916 fin Book m… 1910-lu… The Na… NA
## 5 fikka.1506017 Konsertt… Helsi… 1904 fin Book m… 1900-19… The Na… NA
## 6 fikka.1506016 Konsertt… Helsi… 1904 fin Book m… 1900-19… The Na… NA
## 7 fikka.1505881 Konsertt… Orkes… 1892 swe Book m… 1890-lu… The Na… NA
## 8 fikka.1506019 Konsertt… Helsi… 1907 swe Book m… 1900-19… The Na… NA
## 9 fikka.1505982 Konsertt… Helsi… 1898 fin Book m… 1890-lu… The Na… NA
## 10 fikka.1506018 Konsertt… Helsi… 1902 fin Book m… 1900-19… The Na… NA
## # ℹ 90 more rows
Bulk search
I we need a bulk download we use
search_finna("sibelius", limit = Inf)
where we add the term
limit = Inf
.
Free text search
library(finna)
result <- search_finna("Jansson Tove")
print(result)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 piki.264923 Leht… NA NA fin Muu, K… Jansson… PIKI-k… NA
## 2 helka.9948553435… Tove… Ørjas… 1985 nor Kirja,… Jansson… Helka-… Gylde…
## 3 arto.012790866 Tove… NA 1994 eng Lehti/… Jansson… Kansal… NA
## 4 museovirasto.1b4… Tove… NA 1969 NA Kuva, … kirjail… Museov… NA
## 5 helka.9926903350… Tove… Jones… 1984 eng Kirja,… Jansson… Helka-… Twayn…
## 6 eepos.2909357 Tove… Grave… 2022 eng Kirja,… Jansson… Eepos-… The i…
## 7 arto.013686811 Tove… Koivu… 2005 fin Lehti/… Jansson… Kansal… Suomi…
## 8 uef.991381263370… Tove… Janss… 2016 eng Kirja,… Jansson… Itä-Su… NA
## 9 museovirasto.1ec… Lars… NA 1963 NA Kuva, … HBL; ki… Museov… NA
## 10 museovirasto.708… Lars… NA 1963 NA Kuva, … HBL; ki… Museov… NA
## # ℹ 90 more rows
Search phrase examples
library(finna)
phrase <- search_finna("bicycle")
print(phrase)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 helmet.2088944 Chri… Middl… 2013 eng Kirja,… Nibble,… Helmet… NA
## 2 lastu.234274 Bicy… Byrne… 2010 eng Kirja,… Byrne, … Lastu-… NA
## 3 vaari.565339 Bicy… NA 1900 eng Kirja,… NA Varast… NA
## 4 fikka.5372420 Bicy… NA 2009 NA Äänite… NA Kansal… NA
## 5 vaari.565915 Bicy… Scios… 1983 eng Kirja,… NA Varast… NA
## 6 eepos.2088987 Bicy… Gaddy… 1987 eng Äänite… NA Eepos-… NA
## 7 jamk.99372411640… Bicy… Leagu… 1984 eng Opinnä… Cycling… Jyväsk… NA
## 8 turkuamk_finna.9… Bicy… Sica,… 1981 eng Kirja,… Italia.… Turun … NA
## 9 helmet.1928272 Bicy… Kalim… 2009 zxx Äänite… 2000-20… Helmet… NA
## 10 piki.914540 Bicy… NA 2009 zxx Äänite… NA PIKI-k… NA
## # ℹ 90 more rows
Combining search terms
AND
Use the AND operator to yield search results which feature every term in the search field. If you write several words into the search field and separate them with a space, the space will function as the AND operator.
Example 1
library(finna)
Combination <- search_finna("nutrition AND (diet OR lifestyle)")
print(Combination)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 helka.9917223943… Life… Dwyer… 2001 eng Kirja,… Health … Helka-… Lifes…
## 2 vaari.695619 Diet… Evans… 1984 eng Kirja,… NA Varast… NA
## 3 helka.9914440453… Nutr… Maail… 1999 eng Kirja,… Nutriti… Helka-… NA
## 4 jamk.99377204040… Diet… Assem… 1982 eng Kirja,… Cancer,… Jyväsk… NA
## 5 vaari.1274076 Nutr… Willi… 1985 eng Kirja,… NA Varast… NA
## 6 vaari.304961 Food… Jones… 1970 eng Kirja,… NA Varast… NA
## 7 vaari.948261 Nutr… Willi… 1977 eng Kirja,… ravitse… Varast… NA
## 8 helka.9994309535… Nutr… Gibne… 1986 eng Kirja,… NA Helka-… NA
## 9 jamk.99364076950… Diet… Carro… 1989 eng Kirja,… Nutriti… Jyväsk… NA
## 10 vaari.1390612 Diet… Forse… 1994 eng Kirja,… NA Varast… NA
## # ℹ 90 more rows
Example 2 For example, these two searches will yield the same results:
library(finna)
no_Combination <- search_finna("Karisto Seppälä")
print(no_Combination)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 arto.013569539 Juna… Karis… 2015 fin Lehti/… muusiko… Kansal… Missä…
## 2 hurma.58694 Mauk… Karis… 2004 fin Kirja,… tutkiel… Humani… NA
## 3 helka.9915158073… Tee … Karis… 2000 fin Kirja,… kirjoit… Helka-… Työra…
## 4 arto.012556656 [Kir… Karis… 2000 fin Lehti/… Lehtola… Kansal… NA
## 5 vaasa.acb1e78b-4… Mauk… Karis… 2004 fin Kirja,… arvoste… Vaasan… NA
## 6 uef.991381929370… Lahd… Hiila… 2016 fin Kirja,… Karisto… Itä-Su… NA
## 7 3amk.99605 Mauk… Karis… 2004 fin Kirja,… researc… 3AMK-k… NA
## 8 arto.013629492 [Kir… Ahpon… 2004 fin Lehti/… Karisto… Kansal… NA
## 9 anders.975420 Topi… Seppä… 2010 fin Kirja,… Siru,, … Anders… Koira…
## 10 anders.1119928 Topi… Seppä… 2011 fin Kirja,… Topi,, … Anders… Koira…
## # ℹ 90 more rows
library(finna)
Combination_AND <- search_finna("Karisto AND Seppälä")
print(Combination_AND)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 arto.013569539 Juna… Karis… 2015 fin Lehti/… muusiko… Kansal… Missä…
## 2 hurma.58694 Mauk… Karis… 2004 fin Kirja,… tutkiel… Humani… NA
## 3 helka.9915158073… Tee … Karis… 2000 fin Kirja,… kirjoit… Helka-… Työra…
## 4 arto.012556656 [Kir… Karis… 2000 fin Lehti/… Lehtola… Kansal… NA
## 5 vaasa.acb1e78b-4… Mauk… Karis… 2004 fin Kirja,… arvoste… Vaasan… NA
## 6 uef.991381929370… Lahd… Hiila… 2016 fin Kirja,… Karisto… Itä-Su… NA
## 7 3amk.99605 Mauk… Karis… 2004 fin Kirja,… researc… 3AMK-k… NA
## 8 arto.013629492 [Kir… Ahpon… 2004 fin Lehti/… Karisto… Kansal… NA
## 9 anders.975420 Topi… Seppä… 2010 fin Kirja,… Siru,, … Anders… Koira…
## 10 anders.1119928 Topi… Seppä… 2011 fin Kirja,… Topi,, … Anders… Koira…
## # ℹ 90 more rows
OR
The OR operator expands your search results. The results will show material that feature at least one of the search terms you indicated. For example, if you are looking for information on the Eastern Orthodox Church:
library(finna)
Combination_OR <- search_finna("Eastern Orthodoxy” OR “Orthodox Church")
print(Combination_OR)
## # A tibble: 48 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 uef.991357853370… "Eas… Geffe… 2016 eng Kirja,… Orthodo… Itä-Su… NA
## 2 jamk.99363531200… "The… Papan… 2012 eng Kirja,… Christi… Jyväsk… NA
## 3 savonia.99484867… "Ort… Demac… 2013 eng Kirja,… Orthodo… Savoni… Ortho…
## 4 jamk.99362203330… "Enc… Pabst… 2009 eng Kirja,… Philoso… Jyväsk… NA
## 5 savonia.99485783… "Fun… Apple… 2019 eng Kirja,… Orthodo… Savoni… Ortho…
## 6 uef.991507814010… "The… Denys… 2023 eng Kirja,… Orthodo… Itä-Su… NA
## 7 helka.9931574873… "\"F… Chern… 2017 eng Kirja,… Orthodo… Helka-… NA
## 8 helka.9930669373… "Ort… Demac… 2013 eng Kirja,… ortodok… Helka-… Ortho…
## 9 uef.998661593705… "Ort… Cazac… 2013 eng Kirja,… Thermos… Itä-Su… Europ…
## 10 uef.991391231370… "Pro… Witte… 2009 eng Kirja,… Russkai︠… Itä-Su… NA
## # ℹ 38 more rows
Using the OR operator will return results that feature one or more of your search terms.This example search will find results relating to farms or farming:
library(finna)
phrase <- search_finna("farm OR farming")
print(phrase)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 helka.9914081063… Farm… Ollil… 1999 eng Kirja,… investo… Helka-… Worki…
## 2 vaari.954160 Farm… Boatf… 1983 eng Kirja,… NA Varast… Farmi…
## 3 helka.9960172035… Farm… Bell,… 1985 eng Kirja,… maatalo… Helka-… Farmi…
## 4 helka.9960172435… Farm… Bell,… 1981 eng Kirja,… worksho… Helka-… Farmi…
## 5 vaari.972534 Corp… Great… 1970 eng Kirja,… Farm co… Varast… NA
## 6 vaari.1254801 Farm… Bell,… 1996 eng Kirja,… NA Varast… NA
## 7 helka.9928487835… Farm… Bell,… 1989 eng Kirja,… koneet.… Helka-… NA
## 8 seamk.9999304680… Farm… Nutha… 2011 eng Kirja,… maatila… Seinäj… NA
## 9 vaari.697114 Farm… NA 1981 eng Lehti/… NA Varast… NA
## 10 helka.9918797943… Dair… Slate… 1983 eng Kirja,… Dairy f… Helka-… NA
## # ℹ 90 more rows
NOT
library(finna)
Combination_OR <- search_finna("surrealism NOT (painting OR “visual arts”)")
print(Combination_OR)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 aalto.9975030344… Surr… "Caws… 2004 eng Kirja,… kuvatai… Aalto-… Theme…
## 2 jykdok.352634 Surr… "Schn… 1973 eng Kirja,… NA Jyväsk… The l…
## 3 helka.9937490635… Surr… "Chén… 1990 eng Kirja,… NA Helka-… Europ…
## 4 helmet.1950322 Surr… "Gual… 2008 eng Kirja,… 1900-lu… Helmet… Skira…
## 5 helmet.1578402 Surr… "Wald… 1978 eng Kirja,… surreal… Helmet… NA
## 6 kirjava.41515442… Surr… "edit… 2004 eng Kirja,… surreal… Kansal… NA
## 7 helmet.1956271 Surr… "Klin… 2009 eng Kirja,… surreal… Helmet… NA
## 8 jamk.99362119320… Surr… "Brod… 2018 eng Kirja,… Surreal… Jyväsk… Art o…
## 9 fikka.5586578 Surr… "Lust… 2021 eng Kirja,… surreal… Kansal… Cambr…
## 10 kirjava.41515442… Surr… "Dupl… 1978 eng Kirja,… surreal… Kansal… NA
## # ℹ 90 more rows
Search operators + and !-
In addition to the most common Boolean operators (AND, OR, NOT), Finna uses the + and !- operators.
+
library(finna)
search_oper <- search_finna("+economics Keynes”)")
print(search_oper)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 uef.998588837059… Keyn… Lawso… 1985 eng Kirja,… NA Itä-Su… NA
## 2 abo.991952734059… Keyn… Lawso… 1989 eng Kirja,… NA Åbo Ak… NA
## 3 hanna.29001 The … Harri… 1947 eng Kirja,… Keynes.… Svensk… NA
## 4 vaari.337847 The … Harri… 1950 eng Kirja,… NA Varast… NA
## 5 fikka.567288 The … Harri… 1948 eng Kirja,… Keynes,… Kansal… NA
## 6 utu.991459665540… The … Harri… 1968 eng Kirja,… NA Turun … NA
## 7 vaari.1080451 The … Harri… 1965 eng Kirja,… NA Varast… NA
## 8 tuni.99329737420… The … Harri… 1950 eng Kirja,… Keynes,… Tamper… NA
## 9 ekk.991689954006… The … Harri… 1949 eng Kirja,… keynesi… Edusku… NA
## 10 helka.9916773573… The … Harri… 1952 eng Kirja,… Keynes,… Helka-… NA
## # ℹ 90 more rows
!-
library(finna)
search_oper <- search_finna("economics !-Keynes”)")
print(search_oper)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 oy.9911688653906… Econ… Sloma… 1991 fin Kirja,… nationa… Oulun … NA
## 2 3amk.266286 Econ… Manki… 2014 eng Kirja,… Economi… 3AMK-k… NA
## 3 aalto.9959673644… Econ… Sloma… 2000 eng Kirja,… Kansant… Aalto-… NA
## 4 aalto.9960689844… Econ… Manki… 2006 eng Kirja,… Kansant… Aalto-… NA
## 5 helka.9919326873… Econ… Begg,… 2005 eng Kirja,… Economi… Helka-… NA
## 6 3amk.208341 Econ… Parki… 2017 eng Kirja,… Economi… 3AMK-k… NA
## 7 aalto.9927947644… Econ… Begg,… 1997 eng Kirja,… mikrota… Aalto-… NA
## 8 jykdok.1241916 Econ… Krugm… 2013 eng Kirja,… Economi… Jyväsk… NA
## 9 helka.9964084835… Econ… Begg,… 1994 eng Kirja,… kansant… Helka-… NA
## 10 hanna.2654 Econ… Fisch… 1988 eng Kirja,… Ekonomi… Svensk… NA
## # ℹ 90 more rows
NB! The !- operator cannot be used in single-word searches.
For example, the following search will yield no results:
library(finna)
search_oper <- search_finna("!-economics”)")
print(search_oper)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 3amk.209999 Päihdetila… NA 2013 fin Kirja,… alkohol… 3AMK-k… Suome…
## 2 3amk.211317 Sosiaali- … NA 2019 fin Kirja,… tilasto… 3AMK-k… Suome…
## 3 3amk.211318 Päihdetila… NA 2018 fin Kirja,… alkohol… 3AMK-k… Suome…
## 4 3amk.91452 Kyberturva… Olin,… 2018 fin Kirja,… kybertu… 3AMK-k… Sanas…
## 5 3amk.39381 Teknologia… Markk… 2003 fin Kirja,… teknolo… 3AMK-k… Edusk…
## 6 3amk.55142 Työsuojelu… Sanas… 2006 fin Kirja,… Diction… 3AMK-k… TSK
## 7 3amk.60288 Hyvä tiete… Tutki… 2002 fin Kirja,… tutkimu… 3AMK-k… NA
## 8 3amk.62695 Nuorten te… Rimpe… 2007 fin Kirja,… altistu… 3AMK-k… Sosia…
## 9 3amk.66893 Mahdollisu… Holma… 2008 fin Kirja,… Turun a… 3AMK-k… Turun…
## 10 3amk.68989 Mini-inter… Seppä… 2008 fin Kirja,… Communi… 3AMK-k… Sosia…
## # ℹ 90 more rows
* (Asterisk)
The search term may be truncated at the end with an asterisk. For example, to find search results for the terms competition, competitions, competitor and competitiveness, use the search term:
Example 1
library(finna)
search_Asterisk <- search_finna("competit*”)")
print(search_Asterisk)
## # A tibble: 13 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 fikka.1283497 De j… Nägel… 1826 lat Kirja,… NA Kansal… NA
## 2 fikka.2172129 Hugo… Groti… 1632 lat Kirja,… NA Kansal… NA
## 3 ekk.992074434006… Mare… Groti… 1609 lat Kirja,… NA Edusku… NA
## 4 fikka.1183591 Comm… Lengn… 1722 lat Kirja,… NA Kansal… NA
## 5 fikka.1366484 De c… Mitho… 1656 lat Kirja,… NA Kansal… NA
## 6 fikka.2181926 Geor… Böhme… 1755 lat Kirja,… NA Kansal… NA
## 7 utu.992185078540… Yhte… NA 2019 eng Kirja,… NA Turun … NA
## 8 kamk.99629851606… Adva… Ameri… 1993 eng Opinnä… Competi… Kajaan… NA
## 9 fikka.1934456 Hugo… Groti… 1720 lat Kirja,… NA Kansal… NA
## 10 fikka.3246777 Yhte… NA 1679 fra Kirja,… NA Kansal… NA
## 11 jamk.99362476300… Cons… Berns… 2000 eng Kirja,… Labor m… Jyväsk… SUNY …
## 12 fikka.3250093 Yhte… NA 1739 deu Kirja,… NA Kansal… NA
## 13 tuni.99585593690… Oper… Lahti… 2016 fin Opinnä… liiketo… Tamper… NA
The asterisk may also be used in the middle of a search term to replace one or more characters. For example, to search for both the terms color and colour, use the search term:
Example 2
library(finna)
search_Asterisk <- search_finna("colo*r”)")
print(search_Asterisk)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 uef.994317433705… MCS … Lee, … 2007 eng Kirja,… Image p… "Itä-S… NA
## 2 ekk.994780540062… Expl… Cusac… 1990 eng Kirja,… kansain… "Edusk… NA
## 3 abo.994161833405… Econ… Wick,… 1996 eng Kirja,… NA "Åbo A… NA
## 4 taisto.141587 Fron… Hoxie… 1952 eng Kirja,… NA "Maanp… NA
## 5 taisto.27432 The … Senic… 1988 eng Kirja,… NA "Maanp… NA
## 6 taisto.17657 Sovi… Whiti… 1986 eng Kirja,… NA "Maanp… NA
## 7 ekk.991130664006… Chan… Holst… 1980 eng Kirja,… kansain… "Edusk… NA
## 8 taisto.145762 The … Senic… 1987 eng Kirja,… Assault… "Maanp… NA
## 9 uef.991686063705… The … Miran… 1990 eng Kirja,… Stroess… "Itä-S… NA
## 10 vaari.1521659 The … Wilk,… 1989 eng Kirja,… NA "Varas… NA
## # ℹ 90 more rows
? (Question Mark)
The question mark symbol replaces one character in the search term, enabling the use of different word forms. For example, to find results for both the terms woman and women, use the search term:
ISBN/ISSN search
library(finna)
ISBN <- search_finna("978-951-31-6583-3")
print(ISBN)
## # A tibble: 7 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 vaasa.7d3ae9de-5f… Ties… Koski… 2012 fin Kirja,… linnut;… Vaasan… NA
## 2 anders.1270028 Ties… Koski… 2012 fin Kirja,… linnut;… Anders… NA
## 3 vaasa.e36c4cd9-fc… Para… Lampi… 2009 fin Nuotti hengell… Vaasan… NA
## 4 louna.dcc8dca7-47… Visp… NA 1989 swe Nuotti NA Louna-… NA
## 5 vaasa.41c1c877-68… Säes… Herne… 2002 fin Nuotti NA Vaasan… NA
## 6 vaasa.c319a855-92… Suur… Leske… 2020 fin Nuotti NA Vaasan… NA
## 7 anders.562923 Nuor… Laaks… 2005 fin Nuotti nuoret;… Anders… NA
Sorting
To search all related in descending order
record <- search_finna("sibelius", sort = "main_date_str des")
print(record)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 anders.1945667 He s… Kirve… 2024 fin Kirja,… sotilaa… Anders… NA
## 2 helka.9934642735… Yli-… Frost… 2024 fin Kirja,… Wagner,… Helka-… NA
## 3 anders.1958752 Eero… Järne… 2024 fin Kirja,… Järnefe… Anders… Atene…
## 4 helle.1634933 Eero… Järne… 2024 swe Kirja,… Järnefe… Helle-… Atene…
## 5 helmet.2580197 Eero… Järne… 2024 eng Kirja,… Järnefe… Helmet… Atene…
## 6 anders.1963289 Sola… NA 2024 zxx Äänite… NA Anders… NA
## 7 helmet.2584794 Laul… Klas,… 2024 fin Äänite… 2020-lu… Helmet… NA
## 8 anders.1961626 Nono… Söder… 2024 fin Kirja,… Söderbe… Anders… NA
## 9 uniarts_print.99… Sola… Sibel… 2024 zxx Äänite… NA Taidey… NA
## 10 anders.1963284 A ga… Fishe… 2024 eng Äänite… NA Anders… NA
## # ℹ 90 more rows
To search all related in ascending order
record <- search_finna("sibelius", sort = "main_date_str asc")
print(record)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 kirjava.41515442… Jean… Kurje… 0000 fin Kirja,… Sibeliu… Kansal… NA
## 2 sks.112204227_11… Lyyl… Swan,… 0000 NA Teksti… NA Suomal… NA
## 3 sks.112204227_11… Nelm… Päivä… 0000 NA Teksti… NA Suomal… NA
## 4 sks.112204227_11… Nelm… Sibel… 0000 NA Teksti… NA Suomal… NA
## 5 sks.112204227_11… Kain… NA 0000 NA Teksti… NA Suomal… NA
## 6 sks.112204227_62… BIOG… NA 0000 NA Teksti… NA Suomal… NA
## 7 sks.112204227_62… Nuor… NA 0000 NA Teksti… NA Suomal… NA
## 8 sks.112204227_62… Nuor… NA 0000 NA Teksti… NA Suomal… NA
## 9 sks.112204227_62… Mali… NA 0000 NA Teksti… NA Suomal… NA
## 10 sks.112204227_62… Satu… NA 0000 NA Teksti… NA Suomal… NA
## # ℹ 90 more rows
To search Last modified
record <- search_finna("sibelius", sort = "last_indexed desc")
print(record)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 outi.846785 Cant… Hakul… 2008 mul Nuotti yksinla… OUTI-k… NA
## 2 outi.849707 Cant… Hakul… 2008 mul Nuotti yksinla… OUTI-k… NA
## 3 anders.1925430 Suur… Leske… 2023 fin Nuotti NA Anders… NA
## 4 anders.1902300 Suur… Leske… 2022 fin Nuotti NA Anders… NA
## 5 helmet.1833671 Rats… Lehto… 2007 fin Äänite… puhalli… Helmet… NA
## 6 lapinkirjasto.74… Suom… NA 2006 fin Nuotti yksinla… Lapin … NA
## 7 kirkes.1628922 Kult… Airin… 2018 fin Nuotti joulula… Kirkes… NA
## 8 helmet.1443238 Tie … Paavo… 1947 zxx Nuotti 1940-lu… Helmet… NA
## 9 helmet.2185302 Musi… Jouts… 2014 fin Kirja,… Sibeliu… Helmet… NA
## 10 anders.1932844 Halu… Mikka… 2023 fin Kirja,… Sibeliu… Anders… NA
## # ℹ 90 more rows
To search Last added
record <- search_finna("sibelius", sort = "first_indexed desc")
print(record)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 taju.10024_8335 Kevä… Melar… 1919 fin Nuotti… sovituk… Taidey… NA
## 2 taju.10024_8336 Yli … Melar… 1918 fin Nuotti… sovituk… Taidey… NA
## 3 taju.10024_8337 Nää,… Melar… 1919 fin Nuotti… sovituk… Taidey… NA
## 4 taju.10024_8338 Syys… Melar… 1919 fin Nuotti… sovituk… Taidey… NA
## 5 taju.10024_8339 Kevä… Melar… 1919 fin Nuotti… sovituk… Taidey… NA
## 6 anders.1945667 He s… Kirve… 2024 fin Kirja,… sotilaa… Anders… NA
## 7 taju.10024_8329 Juma… Pulli… 2024 fin Opinnä… jumalan… Taidey… EST-j…
## 8 siirtolaisuusins… Laih… Laiho… 1968 eng Arkist… siirtol… Siirto… NA
## 9 journalfi.articl… Poli… Vihin… 1998 fin Lehti/… NA Journa… Artik…
## 10 arto.019115291 Sibe… Huhta… 2005 fin Lehti/… Sibeliu… Kansal… NA
## # ℹ 90 more rows
Fine-tuning your search
Fuzzy search
Fuzzy search will also yield results that feature words which are similar to your search term.
The search operator ~ will perform a fuzzy search when it is used as the final character of a single-word search.
For example, a fuzzy search with the word roam will also return results with the words foam and roams.
fuzzy_search <- search_finna("roam~")
## No encoding supplied: defaulting to UTF-8.
print(fuzzy_search)
## NULL
Proximity search
Proximity searches look for material in which the search terms are within a specified distance, but not necessarily one after the other.
fuzzy_search <- search_finna("economics Keynes~10")
print(fuzzy_search)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 jamk.99362852690… Keyn… Kurok… 2013 eng Kirja,… Keynesi… Jyväsk… Routl…
## 2 abo.991952734059… Keyn… Lawso… 1989 eng Kirja,… NA Åbo Ak… NA
## 3 uef.998588837059… Keyn… Lawso… 1985 eng Kirja,… NA Itä-Su… NA
## 4 utu.991450079540… Keyn… Gilbe… 1982 eng Kirja,… Keynesi… Turun … NA
## 5 helmet.1199524 KEYN… CODDI… 1983 eng Kirja,… NA Helmet… NA
## 6 ekk.993218740062… On K… Leijo… 1968 eng Kirja,… Keynes,… Edusku… NA
## 7 helka.9916561935… The … Johns… 1978 eng Kirja,… Keynes,… Helka-… NA
## 8 vaari.2696406 The … Johns… 1978 eng Kirja,… Keynes,… Varast… NA
## 9 aalto.9982217144… John… David… 2007 eng Kirja,… Keynes,… Aalto-… Great…
## 10 arto.016710784 J.M.… Stolp… 1932 fin Lehti/… Keynes,… Kansal… NA
## # ℹ 90 more rows
Advanced search: to see available online
record <- search_finna("sibelius", filters = c("free_online_boolean:1"))
print(record)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 jtm.158774447824… Sibe… Tappe… 1967 NA Taidet… NA Jyväsk… NA
## 2 lahdenmuseo.lkm-… Sibe… Favén… NA NA Taidet… kaljuus… Lahden… NA
## 3 sibelius.DF70D25… Evel… NA 1875 NA Kuva, … NA Sibeli… NA
## 4 jarvenpaantaidem… Ruth… Eero … NA NA Taidet… maalaus… Järven… NA
## 5 museovirasto.0E1… Jean… Breit… 1912 NA Kuva, … viikset… Museov… NA
## 6 museovirasto.147… Jean… Helan… 1935 NA Kuva, … miesten… Museov… NA
## 7 museovirasto.429… Jean… Sjöma… 1890 NA Kuva, … viikset… Museov… NA
## 8 museovirasto.69A… Jean… Breit… 1912 NA Kuva, … henkilö… Museov… NA
## 9 museovirasto.6CE… Jean… Rendi… 1900 NA Kuva, … interiö… Museov… NA
## 10 museovirasto.974… Jean… Bonne… 1939 NA Kuva, … miesten… Museov… NA
## # ℹ 90 more rows
search image
record <- search_finna("sibelius", filters = c('~media_type_str_mv:"0/image/"'))
print(record)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 abo.kortkat_0872… Sibe… Ringb… 1948 NA Kirja,… NA Åbo Ak… NA
## 2 jtm.158774447824… Sibe… Tappe… 1967 NA Taidet… NA Jyväsk… NA
## 3 lahdenmuseo.lkm-… Sibe… Favén… NA NA Taidet… kaljuus… Lahden… NA
## 4 abo.kortkat_1535… Sibe… Sugan… 1967 NA Kirja,… NA Åbo Ak… NA
## 5 abo.kortkat_0518… Sibe… Picke… NA NA Kirja,… NA Åbo Ak… NA
## 6 abo.kortkat_0991… Sibe… Schou… 1949 NA Kirja,… NA Åbo Ak… NA
## 7 abo.kortkat_1648… Sibe… Tawas… 1968 NA Kirja,… NA Åbo Ak… NA
## 8 abo.kortkat_0441… Sibe… Ottaw… 1968 NA Kirja,… NA Åbo Ak… NA
## 9 sibelius.DF70D25… Evel… NA 1875 NA Kuva, … NA Sibeli… NA
## 10 jarvenpaantaidem… Ruth… Eero … NA NA Taidet… maalaus… Järven… NA
## # ℹ 90 more rows
Audio book
record <- search_finna("sibelius", filters = c('~format:"1/Book/AudioBook/"'))
print(record)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 eepos.2627672 Aino… Kontt… 2019 fin Kirja,… Sibeliu… Eepos-… NA
## 2 lastu.1707418 Aino… Kontt… 2020 fin Kirja,… Sibeliu… Lastu-… NA
## 3 eepos.2642780 Aino… Kontt… 2019 fin Kirja,… Sibeliu… Eepos-… NA
## 4 ratamo.1632005 Aino… Kontt… 2019 fin Kirja,… NA Ratamo… NA
## 5 siilinjarvi.5680… Aino… Kontt… 2019 fin Kirja,… Sibeliu… Siilin… NA
## 6 lapinkirjasto.80… Sibe… Matti… 1995 NA Kirja,… Illalle… Lapin … NA
## 7 tiekko.901913 The … Sibel… 1994 zxx Kirja,… NA Joki-k… NA
## 8 fikka.5491741 Aino… Kirve… 2020 fin Kirja,… NA Kansal… NA
## 9 heili.1033777 Aino… Kirve… 2015 fin Kirja,… Sibeliu… Heili-… NA
## 10 lastu.298756 Aino… Kirve… 2016 fin Kirja,… Sibeliu… Lastu-… NA
## # ℹ 90 more rows
Year of manufacture
record <- search_finna("sibelius", filters = c('search_daterange_mv:"overlap|[-5000 TO 5000]"'))
print(record)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 lapinkirjasto.15… Sibe… Sibel… 2001 NA Äänite… orkeste… Lapin … NA
## 2 anders.429115 SIBE… TAWAS… 1997 fin Kirja,… SIBELIUS Anders… NA
## 3 anders.149748 Sibe… Tawas… 1997 fin Kirja,… Sibeliu… Anders… NA
## 4 helka.9916268273… Sibe… Lampi… 1984 fin Kirja,… Sibeliu… Helka-… NA
## 5 arto.000273642 Sibe… Tawas… 2003 fin Kirja,… Sibeliu… Kansal… NA
## 6 kirkes.78220 Sibe… Ringb… 1948 fin Kirja,… Sibeliu… Kirkes… NA
## 7 outi.28693 Sibe… Downe… 1945 fin Kirja,… Sibeliu… OUTI-k… NA
## 8 vaasa.84b5d12b-d… SIBE… Lampi… 1995 fin Kirja,… Sibeliu… Vaasan… NA
## 9 vaasa.91b2ccb1-d… Sibe… Tawas… 2003 fin Kirja,… Sibeliu… Vaasan… NA
## 10 helle.124172 Sibe… Tawas… 1968 swe Kirja,… Sibeliu… Helle-… NA
## # ℹ 90 more rows
Search using Geofilter syntax (Geographical region)
record <- search_finna("trump", filters = c('{!geofilt sfield=location_geo pt=61.663987171517796,24.17263895273209 d=212.53603751769646}'))
print(record)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 museovirasto.1E1… naam… NA NA NA Esine naamiai… Suomen… NA
## 2 museovirasto.810… Hels… Hoppa… 2018 NA Kuva, … Helsink… Museov… NA
## 3 museovirasto.276… Hels… Häkki… 2018 NA Kuva, … Helsink… Museov… NA
## 4 museovirasto.B22… Hels… Häkki… 2018 NA Kuva, … Helsink… Museov… NA
## 5 museovirasto.DC1… Hels… Häkki… 2018 NA Kuva, … Helsink… Museov… NA
## 6 museovirasto.160… Hels… Häkki… 2018 NA Kuva, … Helsink… Museov… NA
## 7 museovirasto.28F… Hels… Häkki… 2018 NA Kuva, … Helsink… Museov… NA
## 8 museovirasto.311… Hels… Rauta… 2018 NA Kuva, … Helsink… Museov… NA
## 9 museovirasto.53A… Hels… Rauta… 2018 NA Kuva, … Helsink… Museov… NA
## 10 museovirasto.70B… Hels… Häkki… 2018 NA Kuva, … Helsink… Museov… NA
## # ℹ 90 more rows
geofilter ouside of finland
record <- search_finna("trump", filters = c('{!geofilt sfield=location_geo pt=39.3130504637139,-76.33021295070648 d=281.83790818401854}'))
print(record)
## # A tibble: 8 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 arto.012719646 Kulu… NA 1988 fin Lehti/… Trump, … Kansal… NA
## 2 piki.4957581 A fo… Bunch… 2019 eng Kirja,… Nationa… PIKI-k… NA
## 3 vaski.4340534 Oath… Chene… 2023 eng Kirja,… Cheney,… Vaski-… NA
## 4 helmet.2441982 Mela… Wolko… 2020 eng Kirja,… Wolkoff… Helmet… NA
## 5 tuni.991136661680… The … The J… 2022 eng Kirja,… Trump, … Tamper… NA
## 6 utu.9919927725405… Goth… Stein… 2014 eng Kirja,… Yhdysva… Turun … NA
## 7 fikka.5703672 The … Roman… 2024 eng Kirja,… Village… Kansal… NA
## 8 anders.1706603 Swee… Simol… 2018 fin Kirja,… Simola,… Anders… NA
Narrowing the search
When narrowing search you can use codes as a combination as follows
record <- search_finna("trump", filters = c('{!geofilt sfield=location_geo pt=61.663987171517796,24.17263895273209 d=212.53603751769646},author_facet:"Häkkinen,Hannu"'))
print(record)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 museovirasto.1E1… naam… NA NA NA Esine naamiai… Suomen… NA
## 2 museovirasto.810… Hels… Hoppa… 2018 NA Kuva, … Helsink… Museov… NA
## 3 museovirasto.276… Hels… Häkki… 2018 NA Kuva, … Helsink… Museov… NA
## 4 museovirasto.B22… Hels… Häkki… 2018 NA Kuva, … Helsink… Museov… NA
## 5 museovirasto.DC1… Hels… Häkki… 2018 NA Kuva, … Helsink… Museov… NA
## 6 museovirasto.160… Hels… Häkki… 2018 NA Kuva, … Helsink… Museov… NA
## 7 museovirasto.28F… Hels… Häkki… 2018 NA Kuva, … Helsink… Museov… NA
## 8 museovirasto.311… Hels… Rauta… 2018 NA Kuva, … Helsink… Museov… NA
## 9 museovirasto.53A… Hels… Rauta… 2018 NA Kuva, … Helsink… Museov… NA
## 10 museovirasto.70B… Hels… Häkki… 2018 NA Kuva, … Helsink… Museov… NA
## # ℹ 90 more rows
specific search
record <- search_finna("era:'2010-luku'", filters = c('building:"0/3AMK/"'))
search without removing duplication
In order to search data without removing duplication example
record <- search_finna('era:"2010-luku"', filters = c('~building:"0/3AMK/"', 'finna.deduplication:"1"'))
print(record)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 3amk.71432 Trendejä j… Mella… 2010 fin Kirja,… aluekeh… 3AMK-k… Työ- …
## 2 3amk.300335 Hoivan arv… Hoppa… 2016 fin Kirja,… 2010-lu… 3AMK-k… NA
## 3 3amk.137098 Finns abro… Heikk… 2011 eng Kirja,… 2000-20… 3AMK-k… Migra…
## 4 3amk.211236 Franchisin… Suome… 2018 fin Kirja,… franchi… 3AMK-k… Franc…
## 5 3amk.293263 Sukupolvie… Hämäl… 2021 fin Kirja,… 2010-lu… 3AMK-k… Väest…
## 6 3amk.132507 Toimeentul… Kuiva… 2013 fin Kirja,… 2010-lu… 3AMK-k… Rapor…
## 7 3amk.134144 Tervetuloa… Sjöbl… 2013 fin Kirja,… opiskel… 3AMK-k… Siirt…
## 8 3amk.131653 Erilaisuuk… Saukk… 2013 fin Kirja,… 2010-lu… 3AMK-k… NA
## 9 3amk.85597 Hyvinvoint… Taimi… 2015 fin Kirja,… 2010-lu… 3AMK-k… Rapor…
## 10 3amk.88454 Yksinäiste… Saari… 2016 fin Kirja,… 2010-lu… 3AMK-k… NA
## # ℹ 90 more rows
We can confirm this as follows by checking the count
record <- search_finna('era:"2010-luku"', filters = c('~building:"0/3AMK/"', 'finna.deduplication:"1"'))
result_count <- attr(record, "result_count")
print(result_count)
## [1] 979
Removing duplication can be done as follows
record <- search_finna('era:"2010-luku"', filters = c('~building:"0/3AMK/"', 'finna.deduplication:"0"'))
print(record)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 3amk.132507 Toimeentul… Kuiva… 2013 fin Kirja,… 2010-lu… 3AMK-k… Rapor…
## 2 3amk.293263 Sukupolvie… Hämäl… 2021 fin Kirja,… 2010-lu… 3AMK-k… Väest…
## 3 3amk.85597 Hyvinvoint… Taimi… 2015 fin Kirja,… 2010-lu… 3AMK-k… Rapor…
## 4 3amk.265032 Uudistava … Tutki… 2014 fin Kirja,… 2010-lu… 3AMK-k… NA
## 5 3amk.291790 Medioitunu… Reuna… 2021 fin Kirja,… 2010-lu… 3AMK-k… NA
## 6 3amk.292443 Muuttoliik… Bäckm… 2020 fin Kirja,… 1800-lu… 3AMK-k… Julka…
## 7 3amk.288732 Muuttoliik… Marti… 2020 fin Kirja,… 1800-lu… 3AMK-k… Julka…
## 8 3amk.284506 Virkamiesv… Murto… 2014 fin Kirja,… 1980-lu… 3AMK-k… NA
## 9 3amk.267454 Nuorten pä… Raita… 2016 fin Kirja,… 1995-20… 3AMK-k… Rapor…
## 10 3amk.298602 Hidasta ka… Kivij… 2022 fin Kirja,… 2000-lu… 3AMK-k… Julka…
## # ℹ 90 more rows
To confirm this we can check the count
record <- search_finna('era:"2010-luku"', filters = c('~building:"0/3AMK/"', 'finna.deduplication:"0"'))
result_count <- attr(record, "result_count")
print(result_count)
## [1] 696
Search Finna with multiple filters
To find scholarly journals and digital repository materials regarding music
results <- search_finna(
query = "musiikki OR taide OR tanssi OR teatteri",
filters = c(
'~hierarchy_parent_title:"Institutional Repository"',
'~format_ext_str_mv:"1/Thesis/Gradu/"',
'~format_ext_str_mv:"1/Thesis/Masters/"',
'~format_ext_str_mv:"1/Thesis/MastersPolytechnic/"',
'~format_ext_str_mv:"1/Thesis/Thesis/"',
'~format_ext_str_mv:"1/Thesis/Licentiate/"',
'~format_ext_str_mv:"0/OtherText/"',
'~format_ext_str_mv:"0/Journal/"',
'~format_ext_str_mv:"0/Book/"',
'free_online_boolean:"1"'
),
type = "AllFields",
lng = "en-gb",
prettyPrint = TRUE
)
# Print the results
print(results)
## # A tibble: 100 × 9
## id Title Author Year Language Formats Subjects Library Series
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 journalfi.articl… "Tan… Huota… 2011 fin Journa… Johtaju… Journa… Näkök…
## 2 theseus_oamk.100… "Tan… Hoppu… 2019 fin Journa… tanssi Oulu U… NA
## 3 valto.10024_1603… "Tea… Hakal… 2002 fin Text, … opetusm… Instit… NA
## 4 theseus_oamk.100… "Tea… Kaupp… 2021 fin Journa… tanssi;… Oulu U… NA
## 5 theseus_tuamk.10… "Mus… Suoma… 2017 fin Thesis… musiikk… Turku … NA
## 6 jyx.123456789_80… "Kuu… Veint… 2002 fin Thesis… Etnolog… Univer… NA
## 7 trepo.10024_1006… "Muu… Välim… 2015 fin Text, … musiikk… Tamper… NA
## 8 theseus_tuamk.10… "\"S… Niemi… 2019 fin Thesis… Sovelta… Turku … NA
## 9 theseus_tuamk.10… "Tee… Söder… 2021 fin Thesis… Taiteen… Turku … NA
## 10 tyl.10138_231573 "7 T… Otto … NA fin Text, … NA Librar… NA
## # ℹ 90 more rows