Skip to contents

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 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Sibelius favourites : … Sibel… 2001  NA       Äänite… orkeste… Lapin … NA    
##  2 Sibelius                Tappe… 1967  NA       Taidet… NA       Jyväsk… NA    
##  3 Sibelius                Favén… NA    NA       Taidet… kaljuus… Lahden… NA    
##  4 Sibelius                Tawas… 2003  fin      Kirja,… Sibeliu… Anders… NA    
##  5 Sibelius                Ringb… 1948  fin      Kirja,… Sibeliu… Eepos-… NA    
##  6 SIBELIUS                TÖRNE… 1945  fin      Kirja,… SIBELIU… Helle-… NA    
##  7 Sibelius                Lampi… 1995  fin      Kirja,… Sibeliu… Kansal… NA    
##  8 Sibelius                Lampi… 2005  fin      Kirja,… Sibeliu… Kansal… NA    
##  9 Sibelius                Lampi… 1984  fin      Kirja,… Sibeliu… Kansal… NA    
## 10 Sibelius                Tawas… 1997  fin      Kirja,… Sibeliu… Kansal… NA    
## # ℹ 90 more rows

I we need a bulk download we use search_finna("sibelius", limit = Inf) where we add the term limit = Inf.

library(finna)
result <- search_finna("Jansson Tove")
print(result)
## # A tibble: 100 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Lehtileikkeet : Jansso… NA     NA    fin      Muu/Mä… Jansson… PIKI-k… NA    
##  2 Tove Jansson            Ørjas… 1985  nor      Kirja,… Jansson… Helka-… Gylde…
##  3 Tove Jansson            NA     1994  eng      Lehti/… Jansson… Kansal… NA    
##  4 Tove Jansson            Janss… 2016  eng      Kirja,… Jansson… Itä-Su… NA    
##  5 Tove Jansson            NA     1969  NA       Kuva, … kirjail… Museov… NA    
##  6 Tove Jansson            NA     1953  NA       Kuva, … seinäma… Museov… NA    
##  7 Tove Jansson            NA     1962  NA       Kuva, … HBL; di… Museov… NA    
##  8 Tove Jansson            Brand… 1953  NA       Kuva, … kirjail… Museov… NA    
##  9 Tove Jansson : [Vem oc… Tampe… 1994  fin      Kirja,… Jansson… Helka-… Tampe…
## 10 Tove Jansson            Karja… 2020  fin      Kirja,… NA       Kansal… NA    
## # ℹ 90 more rows

Search phrase examples

library(finna)
phrase <- search_finna("bicycle")
print(phrase)
## # A tibble: 100 × 8
##    Title                 Author   Year  Language Formats Subjects Library Series
##    <chr>                 <chr>    <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Bicycle rider         Sciosci… 1983  eng      Kirja,… NA       Varast… NA    
##  2 Bicycle boogie        Gaddy, … 1987  eng      Äänite… NA       Eepos-… NA    
##  3 Bicycle USA           League … 1984  eng      Opinnä… Cycling… Jyväsk… NA    
##  4 Bicycle thieves       Sica, V… 1981  eng      Kirja,… Italia.… Turun … NA    
##  5 Bicycle revolution    Kalima,… 2009  zxx      Äänite… 2000-20… Helmet… NA    
##  6 Bicycle revolution    NA       2009  zxx      Äänite… NA       PIKI-k… NA    
##  7 Christopher's bicycle Middlet… 2013  eng      Kirja,… Nibble,… Helmet… NA    
##  8 Bicycle diaries       Byrne, … 2010  eng      Kirja,… Byrne, … Lastu-… NA    
##  9 Bicycle safety        NA       1900  eng      Kirja,… NA       Varast… NA    
## 10 Bicycle revolution    NA       2009  NA       Äänite… NA       Kansal… 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 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Lifestyle nutrition     Dwyer… 2001  eng      Kirja,… Health … Helka-… Lifes…
##  2 Diet and nutrition      Evans… 1984  eng      Kirja,… NA       Varast… NA    
##  3 Nutrition and lifestyl… Maail… 1999  eng      Kirja,… Nutriti… Helka-… NA    
##  4 Diet, nutrition, and c… Assem… 1982  eng      Kirja,… Cancer,… Jyväsk… NA    
##  5 Nutrition and diet the… Willi… 1985  eng      Kirja,… NA       Varast… NA    
##  6 Foods, diet, and nutri… Jones… 1970  eng      Kirja,… NA       Varast… NA    
##  7 Nutrition and diet the… Willi… 1977  eng      Kirja,… ravitse… Varast… NA    
##  8 Nutrition and diet the… Lutz,… 2001  eng      Kirja,… ruokava… Turun … NA    
##  9 Nutrition and diet the… Lutz,… 2011  eng      Kirja,… Nutriti… Jyväsk… NA    
## 10 Nutrition & diet thera… Lutz,… 2011  eng      Kirja,… Nutriti… 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 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Junan viemä : muusikko… Karis… 2015  fin      Lehti/… muusiko… Kansal… Missä…
##  2 Maukas gradu : valmist… Karis… 2004  fin      Kirja,… tutkiel… Humani… NA    
##  3 Tee se! : sosiaalipoli… Karis… 2000  fin      Kirja,… kirjoit… Helka-… Työra…
##  4 [Kirja-arvostelu]       Karis… 2000  fin      Lehti/… Lehtola… Kansal… NA    
##  5 Maukas gradu / valmist… Karis… 2004  fin      Kirja,… arvoste… Vaasan… NA    
##  6 Lahden, Kariston ja va… Hiila… 2016  fin      Kirja,… Karisto… Itä-Su… NA    
##  7 Maukas gradu : valmist… Karis… 2004  fin      Kirja,… researc… 3AMK-k… NA    
##  8 Topin talvipuuhia       Seppä… 2010  fin      Kirja,… Siru,, … Anders… Koira…
##  9 Topi karkuteillä        Seppä… 2011  fin      Kirja,… Topi,, … Anders… Koira…
## 10 [Kirja-arvostelu:Mauka… Kuusi… 2004  fin      Lehti/… Karisto… Kansal… NA    
## # ℹ 90 more rows
library(finna)
Combination_AND <- search_finna("Karisto AND Seppälä")
print(Combination_AND)
## # A tibble: 100 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Junan viemä : muusikko… Karis… 2015  fin      Lehti/… muusiko… Kansal… Missä…
##  2 Maukas gradu : valmist… Karis… 2004  fin      Kirja,… tutkiel… Humani… NA    
##  3 Tee se! : sosiaalipoli… Karis… 2000  fin      Kirja,… kirjoit… Helka-… Työra…
##  4 [Kirja-arvostelu]       Karis… 2000  fin      Lehti/… Lehtola… Kansal… NA    
##  5 Maukas gradu / valmist… Karis… 2004  fin      Kirja,… arvoste… Vaasan… NA    
##  6 Lahden, Kariston ja va… Hiila… 2016  fin      Kirja,… Karisto… Itä-Su… NA    
##  7 Maukas gradu : valmist… Karis… 2004  fin      Kirja,… researc… 3AMK-k… NA    
##  8 Topin talvipuuhia       Seppä… 2010  fin      Kirja,… Siru,, … Anders… Koira…
##  9 Topi karkuteillä        Seppä… 2011  fin      Kirja,… Topi,, … Anders… Koira…
## 10 [Kirja-arvostelu:Mauka… Kuusi… 2004  fin      Lehti/… Karisto… Kansal… NA    
## # ℹ 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 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 "Eastern Orthodox Chri… Geffe… 2016  eng      Kirja,… Orthodo… Itä-Su… NA    
##  2 "The mystical as polit… Papan… 2012  eng      Kirja,… Christi… Jyväsk… NA    
##  3 "Orthodox construction… Demac… 2013  eng      Kirja,… Orthodo… Savoni… Ortho…
##  4 "Encounter between Eas… Pabst… 2009  eng      Kirja,… Philoso… Jyväsk… NA    
##  5 "Fundamentalism or Tra… Apple… 2019  eng      Kirja,… Orthodo… Savoni… Ortho…
##  6 "The church's unholy w… Denys… 2023  eng      Kirja,… Orthodo… Itä-Su… NA    
##  7 "\"For I am wonderfull… Chern… 2017  eng      Kirja,… Orthodo… Helka-… NA    
##  8 "Orthodox construction… Demac… 2013  eng      Kirja,… ortodok… Helka-… Ortho…
##  9 "Orthodoxy and psychoa… Cazac… 2013  eng      Kirja,… Thermos… Itä-Su… Europ…
## 10 "Proselytism and Ortho… 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 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Farm families and fami… Ollil… 1999  eng      Kirja,… investo… Helka-… Worki…
##  2 Farm crops              Boatf… 1983  eng      Kirja,… NA       Varast… Farmi…
##  3 Farm machinery          Bell,… 1985  eng      Kirja,… maatalo… Helka-… Farmi…
##  4 Farm workshop           Bell,… 1981  eng      Kirja,… worksho… Helka-… Farmi…
##  5 Corporate farming and … Great… 1970  eng      Kirja,… Farm co… Varast… NA    
##  6 Farm machinery          Bell,… 1996  eng      Kirja,… NA       Varast… NA    
##  7 Farm machinery          Bell,… 1989  eng      Kirja,… koneet.… Helka-… NA    
##  8 Farm business manageme… Nutha… 2011  eng      Kirja,… maatila… Seinäj… NA    
##  9 Farm computer news      NA     1981  eng      Lehti/… NA       Varast… NA    
## 10 Dairy farm business ma… 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 × 8
##    Title      Author              Year  Language Formats Subjects Library Series
##    <chr>      <chr>               <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Surrealism Klingsöhr-Leroy, C… 2009  eng      Kirja,… surreal… Helmet… NA    
##  2 Surrealism Brodskai͡a, N. V.    2018  eng      Kirja,… Surreal… Jyväsk… Art o…
##  3 Surrealism Lusty, Natalya      2021  eng      Kirja,… surreal… Kansal… Cambr…
##  4 Surrealism Duplessis, Yves, Y… 1978  eng      Kirja,… surreal… Kansal… NA    
##  5 Surrealism Pierre, José        1979  eng      Kirja,… NA       Varast… NA    
##  6 Surrealism Waldberg, Patrick   1978  eng      Kirja,… surreal… Helmet… NA    
##  7 Surrealism edited by Mary Ann… 2004  eng      Kirja,… surreal… Kansal… NA    
##  8 Surrealism Dempsey, Amy        2019  eng      Kirja,… taidehi… Eepos-… Art e…
##  9 Surrealism Read, Herbert, Bre… 1971  eng      Kirja,… surreal… Jyväsk… NA    
## 10 Surrealism Waldberg, Patrick,… 1968  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 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Keynes' economics : me… Lawso… 1985  eng      Kirja,… NA       Itä-Su… NA    
##  2 Keynes' economics : me… Lawso… 1989  eng      Kirja,… NA       Åbo Ak… NA    
##  3 The new economics : Ke… Harri… 1947  eng      Kirja,… Keynes.… Svensk… NA    
##  4 The new economics : Ke… Harri… 1950  eng      Kirja,… NA       Varast… NA    
##  5 The new economics : Ke… Harri… 1950  eng      Kirja,… Keynes,… Tamper… NA    
##  6 The New Economics : Ke… Harri… 1949  eng      Kirja,… keynesi… Edusku… NA    
##  7 The new economics : Ke… Harri… 1952  eng      Kirja,… Keynes,… Helka-… NA    
##  8 The new economics : Ke… Harri… 1949  eng      Kirja,… NA       Varast… NA    
##  9 The new economics : Ke… Harri… 1948  eng      Kirja,… Keynes,… Kansal… NA    
## 10 The new economics : Ke… Harri… 1968  eng      Kirja,… NA       Turun … NA    
## # ℹ 90 more rows

!-

library(finna)
search_oper <- search_finna("economics !-Keynes”)")
print(search_oper)
## # A tibble: 100 × 8
##    Title     Author               Year  Language Formats Subjects Library Series
##    <chr>     <chr>                <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Economics Mankiw, N. Gregory,… 2011  eng      Kirja,… kansant… Aalto-… NA    
##  2 Economics Acemoglu, Daron, La… 2016  eng      Kirja,… Economi… 3AMK-k… NA    
##  3 Economics Parkin, Michael, Ma… 2005  eng      Kirja,… Economi… Helka-… NA    
##  4 Economics Acemoglu, Daron, La… 2019  eng      Kirja,… Economi… 3AMK-k… NA    
##  5 Economics Parkin, Michael      2019  eng      Kirja,… Economi… 3AMK-k… NA    
##  6 Economics Hubbard, R. Glenn, … 2010  eng      Kirja,… Economi… HAMK, … NA    
##  7 Economics Parkin, Michael, Po… 2003  eng      Kirja,… Economi… Itä-Su… NA    
##  8 Economics Stiglitz, Joseph E.… 2000  eng      Kirja,… kansant… 3AMK-k… NA    
##  9 Economics Lipsey, Richard G.,… 1975  eng      Kirja,… Economi… Tamper… NA    
## 10 Economics Samuelson, Paul A.   1973  eng      Kirja,… economi… Tilast… 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 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Päihdetilastollinen vu… NA     2013  fin      Kirja,… alkohol… 3AMK-k… Suome…
##  2 Sosiaali- ja terveysal… NA     2019  fin      Kirja,… tilasto… 3AMK-k… Suome…
##  3 Päihdetilastollinen vu… NA     2018  fin      Kirja,… alkohol… 3AMK-k… Suome…
##  4 Kyberturvallisuuden sa… Olin,… 2018  fin      Kirja,… kybertu… 3AMK-k… Sanas…
##  5 Teknologian arviointej… Markk… 2003  fin      Kirja,… teknolo… 3AMK-k… Edusk…
##  6 Työsuojelusanasto = Ar… Sanas… 2006  fin      Kirja,… Diction… 3AMK-k… TSK   
##  7 Hyvä tieteellinen käyt… Tutki… 2002  fin      Kirja,… tutkimu… 3AMK-k… NA    
##  8 Nuorten terveystapatut… Rimpe… 2007  fin      Kirja,… altistu… 3AMK-k… Sosia…
##  9 Mahdollisuuksien ikkun… Holma… 2008  fin      Kirja,… Turun a… 3AMK-k… Turun…
## 10 Mini-intervention jalk… Seppä… 2008  fin      Kirja,… Communi… 3AMK-k… Sosia…
## # ℹ 90 more rows

The use of wildcards in search terms

Use of wildcards

NB! The wildcard symbols (* and ?) cannot be the first character of a search term

* (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 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 De jure vitae et necis… Nägel… 1826  lat      Kirja,… NA       Kansal… NA    
##  2 Hugonis Grotii Mare li… Groti… 1632  lat      Kirja,… NA       Kansal… NA    
##  3 Mare Liberum sive de I… Groti… 1609  lat      Kirja,… NA       Edusku… NA    
##  4 Commentatio de norma r… Lengn… 1722  lat      Kirja,… NA       Kansal… NA    
##  5 De controversiis Sveco… Mitho… 1656  lat      Kirja,… NA       Kansal… NA    
##  6 Georgii Ludovici Boehm… Böhme… 1755  lat      Kirja,… NA       Kansal… NA    
##  7 Yhteissidos =  Samling… NA     2019  eng      Kirja,… NA       Turun … NA    
##  8 Advances in competitiv… Ameri… 1993  eng      Opinnä… Competi… Kajaan… NA    
##  9 Hugonis de Grotii De j… Groti… 1720  lat      Kirja,… NA       Kansal… NA    
## 10 Yhteissidos = Samlings… NA     1679  fra      Kirja,… NA       Kansal… NA    
## 11 Constructing boundarie… Berns… 2000  eng      Kirja,… Labor m… Jyväsk… SUNY …
## 12 Yhteissidos = Samlings… NA     1739  deu      Kirja,… NA       Kansal… NA    
## 13 Operation mode strateg… 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 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 MCS '07 : ninth Intern… Lee, … 2007  eng      Kirja,… Image p… "Itä-S… NA    
##  2 Exploring Realpolitik … Cusac… 1990  eng      Kirja,… kansain… "Edusk… NA    
##  3 Economics and cultures  Wick,… 1996  eng      Kirja,… NA       "Åbo A… NA    
##  4 Frontiers for freedom   Hoxie… 1952  eng      Kirja,… NA       "Maanp… NA    
##  5 The complete book of U… Senic… 1988  eng      Kirja,… NA       "Maanp… NA    
##  6 Soviet air power        Whiti… 1986  eng      Kirja,… NA       "Maanp… NA    
##  7 Change in the internat… Holst… 1980  eng      Kirja,… kansain… "Edusk… NA    
##  8 The German assault rif… Senic… 1987  eng      Kirja,… Assault… "Maanp… NA    
##  9 The Stroessner era : a… Miran… 1990  eng      Kirja,… Stroess… "Itä-S… NA    
## 10 Revolution, armies, an… Adelm… 1985  eng      Kirja,… NA       "Maanp… 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:

library(finna)
ISBN <- search_finna("978-951-31-6583-3")
print(ISBN)
## # A tibble: 5 × 8
##   Title                    Author Year  Language Formats Subjects Library Series
##   <chr>                    <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
## 1 Tiesitkö tämän linnuist… Koski… 2012  fin      Kirja,… linnut;… Vaasan… NA    
## 2 Tiesitkö tämän linnuist… Koski… 2012  fin      Kirja,… linnut;… Anders… NA    
## 3 Parasta on laulaa laulu… Lampi… 2009  fin      Nuotti  hengell… Vaasan… NA    
## 4 Säestäjän selkolaulukir… Herne… 2002  fin      Nuotti  NA       Vaasan… NA    
## 5 Suuri toivelaulukirja /… Leske… 2020  fin      Nuotti  NA       Vaasan… NA

Sorting

record <- search_finna("sibelius", sort = "main_date_str des")
print(record)
## # A tibble: 100 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 He selvisivät sodasta   Kirve… 2024  fin      Kirja,… sotilaa… Anders… NA    
##  2 Yli-ihmisiä ja traagis… Frost… 2024  fin      Kirja,… Wagner,… Helka-… NA    
##  3 Eero Järnefelt          Järne… 2024  fin      Kirja,… Järnefe… Anders… Atene…
##  4 Eero Järnefelt          Järne… 2024  swe      Kirja,… Järnefe… Helle-… Atene…
##  5 Eero Järnefelt          Järne… 2024  eng      Kirja,… Järnefe… Helmet… Atene…
##  6 Solace                  NA     2024  zxx      Äänite… NA       Anders… NA    
##  7 Laulun juhlaa           Klas,… 2024  fin      Äänite… 2020-lu… Helmet… NA    
##  8 Solace                  Sibel… 2024  zxx      Äänite… NA       Taidey… NA    
##  9 A gardener's world : f… Fishe… 2024  eng      Äänite… NA       Anders… NA    
## 10 Sibelius, Prokofiev 1,… Janse… 2024  zxx      Äänite… NA       Eepos-… NA    
## # ℹ 90 more rows
record <- search_finna("sibelius", sort = "main_date_str asc")
print(record)
## # A tibble: 100 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Jean Sibelius : mestar… Kurje… 0000  fin      Kirja,… Sibeliu… Kansal… NA    
##  2 Lyyli Swanin kirje Nel… Swan,… 0000  NA       Teksti… NA       Suomal… NA    
##  3 Nelma Sibeliuksen kirj… Päivä… 0000  NA       Teksti… NA       Suomal… NA    
##  4 Nelma Sibeliuksen kirj… Sibel… 0000  NA       Teksti… NA       Suomal… NA    
##  5 Kaino Nelma Swanin mui… NA     0000  NA       Teksti… NA       Suomal… NA    
##  6 BIOGRAFICA              NA     0000  NA       Teksti… NA       Suomal… NA    
##  7 Nuorten- ja lastenkirj… NA     0000  NA       Teksti… NA       Suomal… NA    
##  8 Nuorten Kirja ry:n aiv… NA     0000  NA       Teksti… NA       Suomal… NA    
##  9 Malin-suvun sukupuu     NA     0000  NA       Teksti… NA       Suomal… NA    
## 10 Satujen käsikirjoituks… 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 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Kiitos soi laulussani   NA     2014  fin      Äänite… NA       Lapin … NA    
##  2 LAULA KANSSAMME (NUOTT… LAULA  1988  fin      Nuotti  NA       Anders… NA    
##  3 Ihanat ikivihreät : 12… Henri… 1989  fin      Nuotti  1920-lu… Anders… Laula…
##  4 Mandariinipäivä         NA     2020  fin      Äänite… NA       Anders… NA    
##  5 Kortistot ja kokoelmal… Kansa… 2024  mul      Muu/Mä… kokoelm… Kansal… NA    
##  6 International book art… Bergm… 2016  eng      Kirja,… Sibeliu… Vanamo… NA    
##  7 Great joy : Sibelius-o… NA     2016  NA       Äänite… NA       Vanamo… NA    
##  8 Aamuyö                  NA     2011  fin      Äänite… 2000-20… Vanamo… NA    
##  9 Great performances      Sibel… 2015  NA       Äänite… NA       Taidey… NA    
## 10 Hauhon Sotaveteraanit … NA     2004  fin      Äänite… NA       Vanamo… NA    
## # ℹ 90 more rows

To search Last added

record <- search_finna("sibelius", sort = "first_indexed desc")
print(record)
## # A tibble: 100 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Hämyn lapsi             Merik… 2024  fin      Äänite… NA       Taidey… NA    
##  2 Nuottikirja : hengelli… NA     2014  zxx      Nuotti  NA       Kansal… NA    
##  3 Onneni saari = Min lyc… Melar… 1961  fin      Nuotti  NA       Kansal… NA    
##  4 Turisteja Sibelius-mon… Sipil… 2024  NA       Kuva, … matkail… Helsin… NA    
##  5 Turisteja Sibelius-mon… Sipil… 2024  NA       Kuva, … matkail… Helsin… NA    
##  6 Turisteja Sibelius-mon… Sipil… 2024  NA       Kuva, … matkail… Helsin… NA    
##  7 Jean Sibelius           Järne… 1906  NA       Taidet… NA       Kansal… NA    
##  8 Nordic Influences in V… Silén… 2024  fin      Lehti/… NA       Journa… Artik…
##  9 The Musical Anthropolo… Abram… 2024  eng      Opinnä… ethnogr… Taidey… EST-j…
## 10 Kortistot ja kokoelmal… Kansa… 2024  mul      Muu/Mä… kokoelm… Kansal… NA    
## # ℹ 90 more rows

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 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 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Keynes and modern econ… Kurok… 2013  eng      Kirja,… Keynesi… Jyväsk… Routl…
##  2 Keynes' economics : me… Lawso… 1985  eng      Kirja,… NA       Itä-Su… NA    
##  3 Keynes' economics : me… Lawso… 1989  eng      Kirja,… NA       Åbo Ak… NA    
##  4 Keynes's impact on mon… Gilbe… 1982  eng      Kirja,… Keynesi… Turun … NA    
##  5 KEYNESIAN ECONOMICS     CODDI… 1983  eng      Kirja,… NA       Helmet… NA    
##  6 On Keynesian economics… Leijo… 1968  eng      Kirja,… Keynes,… Edusku… NA    
##  7 The shadow of Keynes :… Johns… 1978  eng      Kirja,… Keynes,… Helka-… NA    
##  8 The shadow of Keynes :… Johns… 1978  eng      Kirja,… Keynes,… Varast… NA    
##  9 John Maynard Keynes     David… 2007  eng      Kirja,… Keynes,… Aalto-… Great…
## 10 J.M.Keynes ja sodanjäl… 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 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Sibelius                Tappe… 1967  NA       Taidet… NA       Jyväsk… NA    
##  2 Sibelius                Favén… NA    NA       Taidet… kaljuus… Lahden… NA    
##  3 Evelina Sibelius, Jean… NA     1875  NA       Kuva, … NA       Sibeli… NA    
##  4 Aino Sibelius           Järne… 1895  NA       Taidet… NA       Kansal… NA    
##  5 Jean Sibelius           Eero … 1908  NA       Taidet… maalaus… Järven… NA    
##  6 Aino Sibelius           Järne… NA    NA       Taidet… NA       Kansal… NA    
##  7 SIBELIUS-MONUMENTTI     NA     1961  NA       Taidet… NA       Valkea… NA    
##  8 Jean Sibelius           NA     1904  NA       Kuva, … postiko… Loviis… NA    
##  9 Jean Sibelius           Linsé… 1880  NA       Kuva, … henkilö… Loviis… NA    
## 10 Pehr Sibelius           NA     NA    NA       Kuva, … muotoku… Loviis… NA    
## # ℹ 90 more rows

search image

record <- search_finna("sibelius", filters = c('~media_type_str_mv:"0/image/"'))
print(record)
## # A tibble: 100 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Sibelius                Tappe… 1967  NA       Taidet… NA       Jyväsk… NA    
##  2 Sibelius                Favén… NA    NA       Taidet… kaljuus… Lahden… NA    
##  3 Sibelius                Sugan… 1967  NA       Kirja,… NA       Åbo Ak… NA    
##  4 Sibelius.               Tawas… 1968  NA       Kirja,… NA       Åbo Ak… NA    
##  5 Sibelius.               Ringb… 1948  NA       Kirja,… NA       Åbo Ak… NA    
##  6 Sibelius.               Picke… NA    NA       Kirja,… NA       Åbo Ak… NA    
##  7 Sibelius.               Schou… 1949  NA       Kirja,… NA       Åbo Ak… NA    
##  8 Sibelius.               Ottaw… 1968  NA       Kirja,… NA       Åbo Ak… NA    
##  9 Evelina Sibelius, Jean… NA     1875  NA       Kuva, … NA       Sibeli… NA    
## 10 Aino Sibelius           Järne… 1895  NA       Taidet… NA       Kansal… NA    
## # ℹ 90 more rows

Audio book

record <- search_finna("sibelius", filters = c('~format:"1/Book/AudioBook/"'))
print(record)
## # A tibble: 100 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Aino Sibelius           Kontt… 2020  fin      Kirja,… Sibeliu… Lastu-… NA    
##  2 Aino Sibelius           Kontt… 2019  fin      Kirja,… Sibeliu… Eepos-… NA    
##  3 Aino Sibelius           Kontt… 2019  fin      Kirja,… Sibeliu… Eepos-… NA    
##  4 Aino Sibelius           Kontt… 2019  fin      Kirja,… NA       Ratamo… NA    
##  5 Aino Sibelius           Kontt… 2019  fin      Kirja,… Sibeliu… Siilin… NA    
##  6 Sibelius Songs (cd)     Matti… 1995  NA       Kirja,… Illalle… Lapin … NA    
##  7 The Sibelius collection Sibel… 1994  zxx      Kirja,… NA       Joki-k… NA    
##  8 Aino Sibelius : Ihmeel… Kirve… 2020  fin      Kirja,… NA       Kansal… NA    
##  9 Aino Sibelius : ihmeel… Kirve… 2016  fin      Kirja,… Sibeliu… Lastu-… NA    
## 10 Aino Sibelius : ihmeel… Kirve… 2015  fin      Kirja,… Sibeliu… Eepos-… 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 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Sibelius favourites : … Sibel… 2001  NA       Äänite… orkeste… Lapin … NA    
##  2 Sibelius                Tappe… 1967  NA       Taidet… NA       Jyväsk… NA    
##  3 Sibelius                Tawas… 2003  fin      Kirja,… Sibeliu… Anders… NA    
##  4 Sibelius                Ringb… 1948  fin      Kirja,… Sibeliu… Eepos-… NA    
##  5 SIBELIUS                TÖRNE… 1945  fin      Kirja,… SIBELIU… Helle-… NA    
##  6 Sibelius                Lampi… 1995  fin      Kirja,… Sibeliu… Kansal… NA    
##  7 Sibelius                Lampi… 2005  fin      Kirja,… Sibeliu… Kansal… NA    
##  8 Sibelius                Lampi… 1984  fin      Kirja,… Sibeliu… Kansal… NA    
##  9 Sibelius                Tawas… 1997  fin      Kirja,… Sibeliu… Kansal… NA    
## 10 Sibelius                Downe… 1945  fin      Kirja,… Sibeliu… Heili-… 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 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 naamio; Donald Trump -… NA     NA    NA       Esine   naamiai… Suomen… NA    
##  2 Helsinki 2018 -tapaami… Hoppa… 2018  NA       Kuva, … Helsink… Museov… NA    
##  3 Helsinki 2018 - tapaam… Häkki… 2018  NA       Kuva, … Helsink… Museov… NA    
##  4 Helsinki 2018 - tapaam… Häkki… 2018  NA       Kuva, … Helsink… Museov… NA    
##  5 Helsinki 2018 - tapaam… Häkki… 2018  NA       Kuva, … Helsink… Museov… NA    
##  6 Helsinki 2018 - tapaam… Häkki… 2018  NA       Kuva, … Helsink… Museov… NA    
##  7 Helsinki 2018 - tapaam… Rauta… 2018  NA       Kuva, … Helsink… Museov… NA    
##  8 Helsinki 2018 - tapaam… Rauta… 2018  NA       Kuva, … Helsink… Museov… NA    
##  9 Helsinki 2018 - tapaam… Häkki… 2018  NA       Kuva, … kansain… Museov… NA    
## 10 Helsinki 2018 - tapaam… 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 × 8
##   Title                    Author Year  Language Formats Subjects Library Series
##   <chr>                    <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
## 1 Kulutusjuhlan vuokraisä… NA     1988  fin      Lehti/… Trump, … Kansal… NA    
## 2 A fool's errand : creat… Bunch… 2019  eng      Kirja,… Nationa… PIKI-k… NA    
## 3 Oath and honor : a memo… Chene… 2023  eng      Kirja,… Cheney,… Vaski-… NA    
## 4 Melania and me : the ri… Wolko… 2020  eng      Kirja,… Wolkoff… Helmet… NA    
## 5 The January 6 report : … The J… 2022  eng      Kirja,… Trump, … Tamper… NA    
## 6 Gotham unbound : the ec… Stein… 2014  eng      Kirja,… Yhdysva… Turun … NA    
## 7 The freaks came out to … Roman… 2024  eng      Kirja,… Village… Kansal… NA    
## 8 Sweet Manhattan : kohta… Simol… 2018  fin      Kirja,… Simola,… Anders… NA

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 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 naamio; Donald Trump -… NA     NA    NA       Esine   naamiai… Suomen… NA    
##  2 Helsinki 2018 -tapaami… Hoppa… 2018  NA       Kuva, … Helsink… Museov… NA    
##  3 Helsinki 2018 - tapaam… Häkki… 2018  NA       Kuva, … Helsink… Museov… NA    
##  4 Helsinki 2018 - tapaam… Häkki… 2018  NA       Kuva, … Helsink… Museov… NA    
##  5 Helsinki 2018 - tapaam… Häkki… 2018  NA       Kuva, … Helsink… Museov… NA    
##  6 Helsinki 2018 - tapaam… Häkki… 2018  NA       Kuva, … Helsink… Museov… NA    
##  7 Helsinki 2018 - tapaam… Rauta… 2018  NA       Kuva, … Helsink… Museov… NA    
##  8 Helsinki 2018 - tapaam… Rauta… 2018  NA       Kuva, … Helsink… Museov… NA    
##  9 Helsinki 2018 - tapaam… Häkki… 2018  NA       Kuva, … kansain… Museov… NA    
## 10 Helsinki 2018 - tapaam… Häkki… 2018  NA       Kuva, … Helsink… Museov… NA    
## # ℹ 90 more rows
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 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Trendejä ja visioita 2… Mella… 2010  fin      Kirja,… aluekeh… 3AMK-k… Työ- …
##  2 Hoivan arvoiset : vaiv… Hoppa… 2016  fin      Kirja,… 2010-lu… 3AMK-k… NA    
##  3 Finns abroad : new for… Heikk… 2011  eng      Kirja,… 2000-20… 3AMK-k… Migra…
##  4 Franchising Suomessa 2… Suome… 2018  fin      Kirja,… franchi… 3AMK-k… Franc…
##  5 Sukupolvien suhteet : … Hämäl… 2021  fin      Kirja,… 2010-lu… 3AMK-k… Väest…
##  6 Tervetuloa Suomeen? : … Sjöbl… 2013  fin      Kirja,… opiskel… 3AMK-k… Siirt…
##  7 Erilaisuuksien Suomi :… Saukk… 2013  fin      Kirja,… 2010-lu… 3AMK-k… NA    
##  8 Yksinäisten Suomi       Saari… 2016  fin      Kirja,… 2010-lu… 3AMK-k… NA    
##  9 Hyvinvointivaltio 2010… Taimi… 2015  fin      Kirja,… 2010-lu… 3AMK-k… Rapor…
## 10 Toimeentulotuki 2010-l… Kuiva… 2013  fin      Kirja,… 2010-lu… 3AMK-k… Rapor…
## # ℹ 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] 976

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 × 8
##    Title                   Author Year  Language Formats Subjects Library Series
##    <chr>                   <chr>  <chr> <chr>    <chr>   <chr>    <chr>   <chr> 
##  1 Sukupolvien suhteet : … Hämäl… 2021  fin      Kirja,… 2010-lu… 3AMK-k… Väest…
##  2 Hyvinvointivaltio 2010… Taimi… 2015  fin      Kirja,… 2010-lu… 3AMK-k… Rapor…
##  3 Toimeentulotuki 2010-l… Kuiva… 2013  fin      Kirja,… 2010-lu… 3AMK-k… Rapor…
##  4 Uudistava Suomi : tutk… Tutki… 2014  fin      Kirja,… 2010-lu… 3AMK-k… NA    
##  5 Muuttoliikkeiden vuosi… Marti… 2020  fin      Kirja,… 1800-lu… 3AMK-k… Julka…
##  6 Medioitunut valta ja p… Reuna… 2021  fin      Kirja,… 2010-lu… 3AMK-k… NA    
##  7 Muuttoliikkeiden vuosi… Bäckm… 2020  fin      Kirja,… 1800-lu… 3AMK-k… Julka…
##  8 Hidasta kasvua ja lisä… Kivij… 2022  fin      Kirja,… 2000-lu… 3AMK-k… Julka…
##  9 Nuorten päihteiden käy… Raita… 2016  fin      Kirja,… 1995-20… 3AMK-k… Rapor…
## 10 Virkamiesvaltaa? : min… Murto… 2014  fin      Kirja,… 1980-lu… 3AMK-k… NA    
## # ℹ 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] 694