DAM-API

You can get metadata info of all available, free material with query like:

https://digi.kansalliskirjasto.fi/api/dam/binding-search?formats=NEWSPAPER&formats=JOURNAL&formats=PRINTING&formats=BOOK&formats=MANUSCRIPT&formats=MAP&formats=MUSIC_NOTATION&formats=PICTURE&formats=CARD_INDEX

The parameters match the parameters that can be given via Digi.kansalliskirjasto user interface. So, you can search via year, publication date etc.

The scrollId is the way to progress through the result set.

Example of use

Do the initial query:

https://digi.kansalliskirjasto.fi/api/dam/binding-search?formats=NEWSPAPER&formats=JOURNAL&formats=PRINTING&formats=BOOK&formats=MANUSCRIPT&formats=MAP&formats=MUSIC_NOTATION&formats=PICTURE&formats=CARD_INDEX

Get the scrollId from the result and add it  to the following queries e.g.

ja sieltä pomitaan scrollId ja lisätään se seuraaviin kyselyihin, esim: https://digi.kansalliskirjasto.fi/api/dam/binding-search/DnF1ZXJ5VGhlbkZldGNoHgAAAAAL0rRwFmI1VkFMR1ZIUVQ2OW03ZWFTUTh0OXcAAAAAC9K0cRZiNVZBTEdWSFFUNjltN2VhU1E4dDl3AAAAAAv4sOoWZVVWZHY3NENUdnFjVmUtT0hQRzZzUQAAAAAL-LDrFmVVVmR2NzRDVHZxY1ZlLU9IUEc2c1EAAAAAC9K0chZiNVZBTEdWSFFUNjltN2VhU1E4dDl3AAAAAAnTm94WMGdfeGJmWF9SMU9icTQ5bmdmV3YwdwAAAAAL0rRzFmI1VkFMR1ZIUVQ2OW03ZWFTUTh0OXcAAAAAC9K0dBZiNVZBTEdWSFFUNjltN2VhU1E4dDl3AAAAAAv4sO4WZVVWZHY3NENUdnFjVmUtT0hQRzZzUQAAAAAL-LDvFmVVVmR2NzRDVHZxY1ZlLU9IUEc2c1EAAAAACdOb3xYwZ194YmZYX1IxT2JxNDluZ2ZXdjB3AAAAAAnTm-AWMGdfeGJmWF9SMU9icTQ5bmdmV3YwdwAAAAAL-LDyFmVVVmR2NzRDVHZxY1ZlLU9IUEc2c1EAAAAACdOb4hYwZ194YmZYX1IxT2JxNDluZ2ZXdjB3AAAAAAnTm-MWMGdfeGJmWF9SMU9icTQ5bmdmV3YwdwAAAAAJ05vvFjBnX3hiZlhfUjFPYnE0OW5nZld2MHcAAAAACWWlMBZBOW5EN2s3NVRtaVF4M1d2bzVrVDVBAAAAAAvStHoWYjVWQUxHVkhRVDY5bTdlYVNROHQ5dwAAAAAJZaUvFkE5bkQ3azc1VG1pUXgzV3ZvNWtUNUEAAAAAC_iw9RZlVVZkdjc0Q1R2cWNWZS1PSFBHNnNRAAAAAAllpTIWQTluRDdrNzVUbWlReDNXdm81a1Q1QQAAAAAL0rR7FmI1VkFMR1ZIUVQ2OW03ZWFTUTh0OXcAAAAAC9K0fBZiNVZBTEdWSFFUNjltN2VhU1E4dDl3AAAAAAllpTEWQTluRDdrNzVUbWlReDNXdm81a1Q1QQAAAAAL0rR9FmI1VkFMR1ZIUVQ2OW03ZWFTUTh0OXcAAAAACdOb8BYwZ194YmZYX1IxT2JxNDluZ2ZXdjB3AAAAAAvStIUWYjVWQUxHVkhRVDY5bTdlYVNROHQ5dwAAAAAJ05vxFjBnX3hiZlhfUjFPYnE0OW5nZld2MHcAAAAACdOb8hYwZ194YmZYX1IxT2JxNDluZ2ZXdjB3AAAAAAnTm_MWMGdfeGJmWF9SMU9icTQ5bmdmV3Ywdw==

Continue via scrollId until there are no further results.

Digi download tool utilizes DAM-API, if you like to see how the API is used:

• https://github.com/NatLibFi/digidownloadtool 

Notes

• Currently page limit is 20, so it might be useful to limit query. (Target is to enlarge this value during November 2023)
• pageNumber is always 1 when you get whole bindings as result. (First page)

Acknowledgements