Finnan avoin rajapinta

Finnan hakuindeksin kentät.  

• kenttä (Sarake Core Fields)
• voi käyttää fasetoinnissa (Sarake Facet Field = Yes)

• Hierarkisten fasettien (format, building, sector_str_mv, category_str_mv) tulokset palautetaan kokonaisuudessaan. Muiden fasettien osalta ensimmäiset 30.
• Sisältää kentät:

  • value: koodi

  • translated: käännös

  • count: tietueiden lukumäärä

  • isApplied: 1 jos fasettia on käytetty kyselyn filter-parametrissa

  • href: AND-rajaus päälle tai pois (riippuen siitä onko fasetin koodia käytetty kyselyn filter-parametrissa). Muut operaattorit, ks. 'filter' -kentän ohje.

  • children

"facets": {
  "format": [
  {
    "value": "0\/MusicalScore\/",
    "translated": "Noter",
    "count": 96,
    "isApplied": false,
    "href": "?lookfor=notbok&type=AllFields&limit=2&filter%5B%5D=building%3A%220%2FVaski%2F%22&filter%5B%5D=format%3A%220%2FMusicalScore%2F%22"
  },

• facetFilter[]=<fasetti>:"<säännöllinen lauseke>"

• Mahdollistaa palautettavien fasettiarvojen rajaamisen sännöllisten lausekkeiden avulla. 
• Huom: Rajattava fasetti tulee olla palautettavien fasettien joukossa.
  Esimerkkejä:
  • Sijainti-fasetin arvoista vain Jyväskylän yliopiston päätaso:

    • facetFilter[]=building:"0/JYU"

  • Sijainti-fasetin arvoista vain Jyväskylän yliopistoon kuuluvat:

    • facetFilter[]=building:"\d/JYU"

  • Aineistotyyppi-fasetin arvoista vain esnimmäiselle tasolle kuuluvat:

    • facetFilter[]=format:"^0/"

  • Aineistotyyppi-fasetin arvoista vain e-kirjat ja CD-levyt:

    • facetFilter[]=format:"(1/Book/eBook/|1/Sound/CD)"

• Mikäli säännöllinen lauseke kohdistuu hierakisen fasetin päätasoa alemmille tasoille, palautetaan kohdefasetin lisäksi hierarkiassa tätä edeltävät fasetit.
  Esimerkiksi kun rajataan Aineistotyyppi-fasetista e-kirjat (facetFilter[]=format:"1/Book/eBook/"), tulos sisältää myös päätason fasetin Kirja (o/Book):

"facets": {
    "format": [
        {
            "value": "0\/Book\/",
            "translated": "Kirja",
            "count": 4893,
            "href": "?lookfor=sibelius&type=AllFields&filter%5B%5D=format%3A%220%2FBook%2F%22",
            "children": [
                {
                    "value": "1\/Book\/eBook\/",
                    "translated": "E-kirja",
                    "count": 237,
                    "href": "?lookfor=sibelius&type=AllFields&filter%5B%5D=format%3A%221%2FBook%2FeBook%2F%22"
                }
            ]
        }
    ]
}

• <fasetti>="<arvo>".

• Rajauksissa käytettävissä olevat fasetit ks. yllä. 
• Fasettien arvot saa selville tekemällä kyselyn ilman hakusanaa ja rajauksia. Esimerkki: listataan kaikki aineistotyypit:

  • https://api.finna.fi/v1/search?lookfor=&facet[]=format&prettyPrint=1&limit=0

• Rajaukset ovat oletuksena AND-rajauksia. OR tai NOT-rajausta voi käyttää lisäämällä fasetin eteen '~' (OR) tai '-' (NOT).
  Esimerkkejä:
  • Ei kirjoja: 

    • filter[]=-format:"0:/Book"

  • Kirja tai CD-levy: 

    • filter[]=~format:"0/Book/"&filter[]=~format:"1/Sound/CD/"

• AllFields (perushaku, oletus)

• Title (nimeke)

• Author (tekijä)

• Subject (asiasana)

• year (vuosi)

• JournalTitle (lehden nimeke)

• CallNumber (kirjastoaineiston hyllypaikka). Huomaa että jos hakee esim. luokalla 84 rajapinta ei palauta alaluokkaa 84.2 edustavia tuloksia.

• publisher (julkasija)

• Series (sarja)

• toc (sisällysluettelo)

• ISN (lehden ISN-numero)

• Classification (luokitus)
  • Esim:

    • Classification="ykl+35.6"

Voit myös kohdistaa haun suoraan indeksin haettaviin kenttiin (ks. Finnan hakuindeksin kentät, sarake Search) määrittelemällä kohdekentän hakulausekkeessa.
Esimerkki: kohdistetaan haku kenttään publication_place_txt_mv:

?lookfor=publication_place_txt_mv:pomarkku&field[]=id&field[]=publication_place_str_mv&field[]=placesOfPublication&field[]=publicationInfo&prettyPrint=1

• Relevance (relevanssi, oletus)
• title (nimeke)
• author (tekijä)
  • Jos tekijöitä on useita, lajitellaan päätekijän mukaan
• last_indexed desc (viimeksi indeksoidut)
• main_date_str desc (uusimmat ensin)
• main_date_str asc (vanhimmat ensin)
• callnumber (kirjastoaineiston hyllypaikka)
  • Jos tietueessa on useita callnumbereita, lajittelu tehdään ensimmäisen perusteella.

0-100 (oletus 20). Jos 0, ei tietueita palauteta ollenkaan.

• fi (suomi, oletus)
• sv (ruotsi)
• en-gb (englanti)

Ks. tuetut kentät allaolevassa taulukossa. Jos ei määritelty, palautetaan alla olevassa kenttäluettelossa korostetut kentät. Jos tyhjä, ei tietueita palauteta ollenkaan.

 Ks. tuetut kentät allaolevassa taulukossa. Jos ei määritelty, palautetaan alla olevassa kenttäluettelossa korostetut kentät. Jos tyhjä, ei tietueita palauteta ollenkaan.

Lista

Aineiston käyttörajoitukset, mikäli tiedossa

"accessRestrictions": [
    "University of Turku local network, remote access with Univ. of Turku username",
    "Turun yliopiston verkossa, et\u00e4k\u00e4ytt\u00f6 TY:n tunnuksilla"
]

Joskus lisenssi:

"accessRestrictions": [
    "ELEKTRA-lisenssi"
]

Joskus ikäraja:

"accessRestrictions": [
    "K11"
]

Vaihtoehtoiset nimekkeet

"alternativeTitles": [
    "Miehet mustissa",
    "MIB"
]

Kaikki tekijät

• main: päätekijä (jos on)
• corporate: yhteisötekijä (jos on)
• secondary: muut tekijät (jos on)

"authors": {
    "main": "Bowie, David",
    "secondary": [
        "Spiders from Mars"
    ]
}

"authors": {
    "main": "Ozric Tentacles",
    "corporate": "Ozric Tentacles,"
}

Palkinnot. Merkitty varsin harvoin.

"awards": [
    "Tieto-Finlandia-palkinto 2013."
]

Julkaisun tyyppi. Tyyppejä ainakin Monograph (monografia), MonographPart (monografian osa), Serial (sarjajulkaisu), SerialPart (sarjajulkaisun osa) ja Unknown (tuntematon).

"bibliographicLevel": "Monograph"

Sijainti (hierarkkinen). Sisältää kentät:

• value: sijainnin koodi, käytetään fasetoinnissa
• translated: sijainnin käännös

"buildings": [
    {
        "value": "0\/TAIY\/",
        "translated": "Taideyliopisto"
    },
    {
        "value": "1\/TAIY\/tea\/",
        "translated": "Teatterikorkeakoulun kirjasto"
    },
    {
        "value": "2\/TAIY\/tea\/1\/",
        "translated": "Lainattavat"
    }
]

Kirjastoaineiston hyllypaikat. Merkintätapa vaihtelee kirjastoittain.

"callNumbers": [
    "84.5",
    "KAUHU"
]

Tietueen lapsitietueiden lukumäärä. Tämän tiedon pyytäminen voi kasvattaa vasteaikaa merkittävästi.

"childRecordCount": 0

Luokitukset eri luokitusjärjestelmissä.

"classifications": {
 "udk": [
   "001.81",
   "001.818",
 ],
 "ykl": [
   "16.7",
   "38.3",
  ]

}

Pelkkä ISBN-tunnus ilman ulkoasua tms. Ks. myös isbns

"cleanIsbn": "1402087179"

Pelkkä ISSN-tunnus. Ks. myös issns

"cleanIssn": "0065-2164"

Kokoelmat. Käytössä ainakin museoaineistossa.

"collections": [
    "Riuttalan talonpoikaismuseo"
]

Sisältävän julkaisun numero

"containerIssue": "4"

Viite sisältävään julkaisuun

"containerReference": "s. 191-201"

Alkusivu sisältävässä julkaisussa

"containerStartPage": "191"

Sisältävän julkaisun nimeke

"containerTitle": "Finland : an introduction"

Sisältävän julkaisun volyymi (vuosikerta / kirjasarjan osa)

"containerVolume": "25"

Yhteisötekijä

"corporateAuthor": "Valtiontalouden tarkastusvirasto."

Muista lähteistä tulleiden samaa sisältöä edustavien tietueiden id:t

"dedupIds": [
    "alma.678448",
    "oula.894534",
    "tamcat.399614"
]

Opinnäytteen huomautus

"dissertationNote": "Pro gradu -ty\u00f6 : Tampereen yliopisto, historiatieteen laitos, yleinen historia."

Painos, laitos tai versio

"edition": "10. osin uud. laitos"

"edition": "Pidennetty versio"

Tietueeseen sisältyvät osakohteet. Tämän tiedon pyytäminen voi kasvattaa vastauksen kokoa ja vasteaikaa merkittävästi. Käytössä ainakin äänitteissä.

"embeddedComponentParts": [
    {
        "id": "viola.305175",
        "title": "Juppihippipunkkari",
        "authors": [
            "Koistinen, Petteri, s\u00e4velt\u00e4j\u00e4",
            "Alanko, Ilkka, sanoittaja",
            "Nelj\u00e4 Ruusua, esitt\u00e4j\u00e4"
        ],
        "otherAuthors": [
            "Koistinen, Petteri, s\u00e4velt\u00e4j\u00e4",
            "Alanko, Ilkka, sanoittaja",
            "Nelj\u00e4 Ruusua, esitt\u00e4j\u00e4"
        ]
    },
    {
        "id": "viola.305176",

jne. (esimerkki katkaistu)

Tietueeseen liittyvät tapahtumat, kuten valmistus, käyttö, muotoilu ja näyttely (museoaineisto)

"events": {
    "valmistus": [
        {
            "type": "valmistus",
            "date": "800 - 1050, viikinkiaika, rautakausi",
            "materials": [
                "metalli",
                "hopea"
            ]
        }
    ],
    "n\u00e4yttely": [
        {
            "type": "n\u00e4yttely",
            "name": "Raision museo -ja kulttuurikeskus Harkon arkeologinen n\u00e4yttely",
            "description": "26.5.2004 - 31.12.2006"
        }

    ]

}

Tietueen aineistotyypit (hierarkkinen). Usein aineistotyyppi on datassa virheellisesti "Other", vaikka kyse olisi esim. cd-levystä, jolle löytyisi oma aineistotyyppikin.

• value: aineistotyypin koodi
• translated: aineistotyypin käännös

Esimerkki: e-kirja on kirjan alalaji. Rajapinta palauttaa koko hierarkian ylhäältä alas:

"formats": [
    {
        "value": "0\/Book\/",
        "translated": "Kirja"
    },
    {
        "value": "1\/Book\/eBook\/",
        "translated": "E-kirja"
    }
]

Yleiset huomautukset.

"generalNotes": [
    "Ainoastaan verkkolehden vuoden viimeinen numero ilmestyy painettuna.",
    "Ei ilmestynyt lainkaan painettuna 2005."
]

Aineiston "genret". Ei käytetä fiktion ja musiikin lajityypin tai tyylilajin kuvaamiseen. Katso myös subjects.

"genres": [
    "Electronic books",
    "Conference proceedings"
]

"genres": [
    "DVD-levyt"
]

"genres": [
    "kirja-arvostelut"
]

Emotietueen ID, jos tietue kuuluu hierarkiaan. Käytössä ainakin arkisto- ja kirjastoaineistossa.

"hierarchyParentId": [
    "narc.VAKKA-192941.KA_VAKKA-62641.KA"
]

Emotietueen nimeke, jos tietue kuuluu hierarkiaan. Käytössä ainakin arkisto- ja kirjastoaineistossa.

"hierarchyParentTitle": [
    "Aa Diaarit"
]

"hierarchyParentTitle": [
    "The rise and fall of Ziggy Stardust and the spiders from Mars"
]

Hierarkian päätietueen ID, jos tietue kuuluu hierarkiaan. Käytössä ainakin arkistoaineistossa.

"hierarchyTopId": [
    "narc.VAKKA-192941.KA"
]

Hierarkian päätietueen nimeke, jos tietue kuuluu hierarkiaan. Käytössä ainakin arkistoaineistossa.

"hierarchyTopTitle": [
    "Viipurin provinssikanslian arkisto"
]

Julkaisuajankohdat ihmisen luettavassa muodossa.

"humanReadablePublicationDates": [
    "1983-2006."
]

Tietueen yksilöivä tunniste

"id": "alma.757000"

Merkkijono

Tietueen tunniste, ei yksilöivä. Käytössä ainakin museoaineistoissa ja tietokannoissa.

Museoaineistossa inventaarionumero:

"identifierString": "201190a20"

Tietokannoissa tunniste:

"identifierString": "FSD"

Kuvien käyttöoikeudet:

• copyright: Käyttöoikeus lyhyessä muodossa

• link: Linkki lisenssiin

• description: Käyttöoikeuden mahdollinen pidempi kuvaus ja/tai lisätietoja

"imageRights": {
    "copyright": "CC BY 4.0",
    "link": "http:\/\/creativecommons.org\/licenses\/by\/4.0\/deed.fi",
        "description": [
            "Finna-palvelussa julkaistuja Helsingin kaupunginmuseon kuvia voi k\u00e4ytt\u00e4\u00e4 vapaasti, my\u00f6s kaupallisessa k\u00e4yt\u00f6ss\u00e4.

             Kuvaa ei saa muunnella ilman lupaa ja kuvan yhteydess\u00e4 on mainittava kuvaaja(jos tiedossa) ja Helsingin kaupunginmuseo.

             Finnassa n\u00e4ytett\u00e4v\u00e4t kuvat lisensoidaan Nime\u00e4 4.0 Kansainv\u00e4linen (CC BY 4.0) -lisenssill\u00e4.

             Palvelussa n\u00e4ytett\u00e4v\u00e4t kuvat eiv\u00e4t ole painolaatuisia. Jos tarvitset painolaatuisen kuvan tai sinulla on muuta kysytt\u00e4v\u00e4\u00e4,

             ota yhteytt\u00e4 Helsingin kaupunginmuseon kuva-arkistoon: http:\/\/www.helsinginkaupunginmuseo.fi\/kuva-arkisto"

        ]
}

(description-kohtaan lisätty rivinvaihdot esimerkin lukemisen helpottamiseksi)

Linkit tietueen kuviin. Kirjojen tietuekuvan linkki palauttaa 10x10 pikselin kokoisen läpinäkyvän .gif-kuvan mikäli oikeaa kuvaa ei löydy.

"images": [
    "https:\/\/www.finna.fi\/Cover\/Show?id=hkm.HKMS000005%3Akm002w3s&fullres=1&index=0"
]

Organisaatio. Katso myös buildings

• value: organisaation koodi
• translated: organisaation nimi käännettynä

"institutions": [
    {
        "value": "LUC",
        "translated": "Lapin korkeakoulukirjasto"
    }
]

ISBN-tunnukset (ks. myös cleanIsbn)

"isbns": [
    "951-0-31435-8 (sid.)",
    "978-951-0-31435-7 (sid.)"
]

Onko tietue kokoelma (arkistoaineisto)

"isCollection": true

Onko tietue osa arkistosarjaa (arkistoaineisto)

"isPartOfArchiveSeries": true

ISSN-tunnukset. Ks. myös cleanIssn

"issns": [
    "1913-4711"
]

Aineiston kielet. Kielet palautetaan koodeina ja ne ovat usein mutteivät aina MARC-muodossa. Katso myös originalLanguages.

"languages": [
    "fin",
    "swe"
]

Library of Congress Control Number

"lccn": "2010252176"

Valmistaja

"manufacturer": "([Myllykoski] : Myllykosken kirjap.)"

Joskus data on epämääräisempää:

"manufacturer": "(Porvoo)"

Kuvailun kohteen fyysiset mitat

"measurements": [
    "Pituus: 42 cm",
    "Leveys: helma 22 cm; rinta 34 cm; olka+hiha 14,5+32,5 cm",
    "Lis\u00e4mitta: Koko 110"
]

Tekijät ilman esittäjiä (ks. myös presenters)

• name: tekijän nimi
• role: tekijän rooli (jos on)

"nonPresenterAuthors": [
    {
        "name": "Doyle, Arthur Conan",
    },
    {
        "name": "Attwood, David",
        "role": "ohj."
    }
]

Online-linkit (kirjastoaineisto). Sisältää kentät:

• url: linkin URL
• text: linkin teksti (ei käännetty)
• source: tietueen tietolähde (organisaatio)
  • value: organisaation koodi
  • translated: nimi käännettynä

"onlineUrls": [
    {
        "url": "http:\/\/eca.europa.eu\/portal\/page\/portal\/publications\/Journal",
        "text": "Elektroninen julkaisu (PDF)",
        "source": {
            "value": "selma",
            "translated": "Eduskunnan kirjasto - Selma"
        }
    }
]

OpenURL (kirjastoaineisto). Esimerkki jätetty pois pituuden takia.

Aineiston alkuperäiskielet. Katso myös languages.

"originalLanguages": [
    "jpn"
]

Muut tietueen linkit. Käytetään ainakin arvosteltujen teosten merkitsemiseen.

"otherLinks": [
    {
        "heading": "Arvosteltu teos",
        "title": "Viimeiset runonlaulajat",
        "author": "Martti Haavio"
    }
]

Aineiston fyysinen kuvaus. Käytössä ainakin arkistotietueissa.

"physicalDescriptions": [
    "0,01 hyllmeter",
    "1 arkivenheter"
]

Fyysiset sijainnit. Vain arkistotietueilla.

"physicalLocations": [
    "Historiska och litteraturhistoriska arkivet",
    "Helsingfors, Nationalbiblioteket"
]

Lista

Julkaisupaikka

"placesOfPublication": [
    "New York, NY  :"
]

Toistoaika. Käytetään ainakin äänitteiden yksittäisissä kappaleissa ja äänikirjoissa.

"playingTimes": [
    "00:06:42"
]

Esittäjät (ks. myös nonPresenterAuthors). Datan laatu ja merkintätavat vaihtelevat, esittäjät saattavat olla esim. pelkästään details-kentässä.

• presenters (lista)
  • name: esittäjän nimi
  • role: esittäjän rooli
• details (lista): lisätietoja

"presenters": {
    "presenters": [
        {
            "name": "Carola",
            "role": "esitt."
        },
        {
            "name": "Sarmanto, Heikki",
            "role": "esitt."
        },
        {
            "name": "Heikki Sarmanto Trio",
            "role": "esitt."
        }
    ],
    "details": [
        "Carola (voc), Heikki Sarmanto Trio: Heikki Sarmanto (p), Tapani Tamminen (b), Reino Laine (dr), Esa Pethman (fl, ts)"
    ]
}

Tuotannon tekijätiedot. Käytetään ainakin joissakin äänitteissä.

"productionCredits": [
    "Miikka Huttunen (\u00e4\u00e4nitt\u00e4j\u00e4, miksaaja), Jukkis Uotila (tuottaja), Klaus Suonsaari (tuottaja), Svante Forsb\u00e4ck (masteroija)."
]

Arvioitu julkaisuajankohta

"projectedPublicationDate": "12\/2015"

Julkaisuajankohta

"publicationDates": [
    "1972"
]

Viimeinen julkaisuajankohta (kausijulkaisuissa) tai ensi-illan ajankohta (elokuvissa).

"publicationEndDate": "2003"

Edelleen jatkuva julkaisu merkitään usein vuotena 9999:

"publicationEndDate": "9999"

Julkaisutiheys. Ilmoitettu yleensä sanallisesti suomeksi.

"publicationFrequency": [
    "Kerran kuukaudessa."
]

Tietoa julkaisusta. Sisältää yleensä julkaisupaikan.

"publicationInfo": [
    "Dortmund"
]

Lista

Julkaisijat

"publishers": [
    "Published by E. & F.N. Spon for the Royal Institute of British Architects"
]

Käyttäjien julkaisulle antamien arvostelujen keskiarvo ja lukumäärä. Arvostelut eivät ole käytössä kaikissa aineistotyypeissä.

• average: keskiarvo, 0-5 tähteä, pyöristettynä alaspäin lähimpään puoleen tähteen.

• count: arvostelujen lukumäärä

"rating": {
    "average": 2.5,
    "count": 3
}

Raaka metadata käsittelemättömänä. Esimerkkiä ei esitetä tässä suuren koon vuoksi.

Tietueiden väliset linkit. Linkki voidaan muodostaa ainakin nimekkeen tai isn:n perusteella.

• value
• link
  • type: linkin muodostamisperuste, kuten title tai isn
  • value: tieto linkin muodostamiseksi
  • exclude
• translated: käännetty kuvaus tietueen suhteesta linkitettyyn tietueeseen

"recordLinks": [
    {
        "value": "Baskervillen koira",
        "link": {
            "type": "isn",
            "value": "978-951-1-22851-6",
            "exclude": "arto.1567282"
        },
        "translated": "Muu suhde"
    }
]

"recordLinks": [
    {
        "value": "Julkisuuden salaisuudet : pakinoita ja satiireja journalismin ja julkisuuden kiehtovasta maailmasta",
        "link": {
            "type": "title",
            "value": "Julkisuuden salaisuudet : pakinoita ja satiireja journalismin ja julkisuuden kiehtovasta maailmasta"
        },
        "translated": "Muu suhde"
    }
]

Sarjatiedot

• name: sarjan nimi
• additional (valinnainen)
• number: järjestysluku (valinnainen)
• issn: issn-numero (valinnainen)

"series": [
    {
        "name": "Ursan julkaisuja",
        "additional": "0357-7937;",
        "number": "28",
        "issn": "0357-7937"
    }
]

"series": [
    {
        "name": "Laatukirjasto"
    }
]

SFX-tietueen tunniste

"sfxObjectId": "1000000000310928"

Päänimeke. Katso myös title ja subTitle.

"shortTitle": "Parhaat ruokasienet"

Lista

Tietueen lähde

• value: organisaation koodi
• translated: organisaation käännetty nimi

"source": [
    {
        "value": "keski",
        "translated": "Keski-kirjastot"
    }
]

Asiasanat/aiheet. Lista koostuu listoista, joissa on ensimmäisenä yläkäsite ja sen jälkeen mahdolliset alakäsitteet. Esim:

"subjects": [
    [
        "Holmes, Sherlock,",
        "fikt."
    ],
    [
        "elokuvat",
        "Iso-Britannia",
        "2000-2009"
    ],
    [
        "j\u00e4nnityselokuvat"
    ],
    [
        "rikoselokuvat"
    ]

]

Alanimeke. Katso myös title ja shortTitle.

"subTitle": "sieniopas"

Yhteenveto/tiivistelmä (pituus vaihtelee). Kaikkia Finnassa olevia tiivistelmiä ei tarjota rajapinnan kautta tekijänoikeudellisista syistä johtuen. Mikäli rajapinta palauttaa tiivistelmän, sen käyttö on sallittua rajapinnan käyttöehtojen mukaisesti.

"summary": [
    "Provides essential ideas of the new science of nanotechnology and mathematics. Covers contemporary topics in the areas of the environment, food safety, medicine and healthcare, consumer goods, agriculture, homeland security, and energy supply."
]

Aineiston käyttöön tarvittava järjestelmä.

"systemDetails": [
    "Internet-yhteys; www-selain."
]

Koko nimeke. Katso myös shortTitle ja subTitle

"title": "Parhaat ruokasienet : sieniopas"

Nimekkeeseen liittyvä osan numero, jos nimeke kuuluu sarjaan. Katso myös series.

"titleSection": "3."

Nimekkeeseen liittyvää lisätietoa. Sisältää usein tietoja tekijöistä.

"titleStatement": "directed by Ridley Scott ; screenplay by Hampton Fancher and  David Peoples"

Sisällysluettelo. Sisältää usein sisällysluettelon lisäksi tai sijasta muutakin kuvailutietoa ja jopa tiivistelmiä.

"toc": [
    "1 CD-\u00e4\u00e4nilevy + esiteliite",
    "Kappale Midnight in a perfect world sis. selke\u00e4n s\u00e4mplen Pekka Pohjolan kappaleesta Sekoilu seestyy",
    "Best foot forward. Building steam with a grain of salt. The number song. Changeling. What does your soul look like (part 4). Stem\/Long stem. Mutual slump. Organ donor. Why hip hop sucks in '96. Midnight in a perfect world. Napalm brain\/Scatter brain. What does your soul look like (part 1 - Blue sky revisit)",
    "DJ Shadow",
    "englanti"
]

Yhtenäistetyt nimekkeet (kirjastoaineisto). Yhtenäisyys ei välttämättä toteudu eri organisaatioiden välillä.

"uniformTitles": [
    "On the origin of species"
]

Arkistoyksikön tunniste (arkistoaineisto)

"unitId": "Aa:6"

Linkit (tietueeseen liittyvät resurssit ja toiminnot ulkoisissa järjestelmissä. Sisältää myös kentän images kuvalinkit). Sisältää kentät:

• url: linkin URL
• desc: kuvaus käännettynä (jos on)

"urls": [
    {
        "url": "http:\/\/www.makupalat.fi\/",
        "desc": "Tietokannan k\u00e4ytt\u00f6liittym\u00e4"
    },
    {
        "url": "http:\/\/www.makupalat.fi\/fi-FI\/Info\/",
        "desc": "Tietokantaopas"
    }
]

Vuosi (esimerkiksi julkaisuvuosi, valmistusvuosi). Käytetään myös main_date_str-fasetissa.

"year": "1761"

https://api.finna.fi/v1/search?lookfor=sibelius

https://api.finna.fi/v1/search?lookfor=sibelius&filter[]=format:"1/Sound/CD/"

https://api.finna.fi/v1/search?lookfor=sibelius&filter[]=online_boolean:"1"&filter[]=format:"0/Image/"

https://api.finna.fi/v1/search?lookfor=sibelius&filter[]=online_boolean:"1"&filter[]=format:"0/Image/"&facet[]=building

https://api.finna.fi/v1/search?facet[]=format

https://api.finna.fi/v1/search?filter[]=online_boolean:"1"&filter[]=format:"0/Image/"

https://api.finna.fi/v1/search?filter[]=usage_rights_str_mv:usage_B

https://api.finna.fi/v1/search?facet[]=building&lng=sv

https://api.finna.fi/v1/search?lookfor=sibelius&type=Author

https://api.finna.fi/v1/record?id=fennica.123

https://api.finna.fi/v1/record?id[]=fennica.123&id[]=fennica.124

https://api.finna.fi/v1/search?lookfor=id:vaski.2667110+OR+local_ids_str_mv:vaski.2667110
https://api.finna.fi/v1/record?id=vaski.2667110

https://api.finna.fi/v1/search?lookfor=sibelius+AND+festival