Page History
...
The API provides a way to perform searches to the material provided by the organizations (Finnish libraries, archives and museums) participating in Finna.fi. For example the metadata of Fennica - the Finnish National Bibliography and Viola - the Finnish National Discography are included in the API. The Library Network Services unit of the National Library is responsible for the maintenance and development of the interface.
Inquiries and feedback on the API: finna-posti AT helsinki.fi
Terms of Use
See API Terms of Use and Recommendations.
Examples of Use
Documentation in Swagger
The primary and up to date documentation is available in the Swagger UI.
The OpenAPI specification can be loaded from https://api.finna.fi/v1?swagger.
Basic Functionality
The queries are formatted in the following way:
...
The API is not meant for handling large result sets (see the page parameter for more information).
Terms of Use
See API Terms of Use and Recommendations.
Documentation in Swagger
The primary and up to date documentation is available in the Swagger UI.
The OpenAPI specification can be loaded from https://api.finna.fi/v1?swagger.
Example queries
Search for records using the search term "sibelius": | |
Search CDs using the search term "sibelius": | https://api.finna.fi/v1/search?lookfor=sibelius&filter[]=format:"1/Sound/CD/" |
Search online images using the search term "sibelius" | https://api.finna.fi/v1/search?lookfor=sibelius&filter[]=online_boolean:"1"&filter[]=format:"0/Image/"&field[]=title&field[]=images |
Search online images using the search term "sibelius", faceted by organization | |
Search for records from years 1870-1890 | https://api.finna.fi/v1/search?lookfor=&filter[]=search_daterange_mv:"[1870%20TO%201890]" |
Formats of all records | https://api.finna.fi/v1/search?lookfor=&facet[]=format Set limit to 0 if you don't need records: https://api.finna.fi/v1/search?lookfor=&facet[]=format&limit=0 |
All online images | https://api.finna.fi/v1/search?lookfor=&filter[]=online_boolean:"1"&filter[]=format:"0/Image/" |
All records with the allowed use "Modifications allowed, also commercial use" | https://api.finna.fi/v1/search?lookfor=&filter[]=usage_rights_str_mv:usage_B |
All organizations, names in swedish | https://api.finna.fi/v1/search?lookfor=&facet[]=building&lng=sv |
Records with "sibelius" as author | |
Retrieve a single record by ID | |
Retrieve two records by ID | https://api.finna.fi/v1/record?id[]=fennica.123&id[]=fennica.124 |
To return possible field values for a facet field you can perform a query without a search term and filters. | https://api.finna.fi/v1/search?lookfor=&facet[]=format&prettyPrint=1&limit=0 |
A query may be targeted to a specific (non-facet) index field by including the field in the search term. Note: put facet fields in the filter-parameter. For example: ?lookfor=format:0/Book/ (not supported) ?lookfor=&filter[]=format:0/Book/ (use this instead) | |
NOT & AND filters | |
The search term may also include a more complex query, for example a target (non-facet) field or a logical operator. See also 'type' parameter of Search action. Search using search terms "sibelius" and "festival" | https://api.finna.fi/v1/search?lookfor=sibelius+AND+festival |
Examples of Use
...
Additional information on search parameters
...