K-samsök skördar metadata från svenska museer, Riksantikvarieämbetet, ideella aktörer m fl. Klicka här för att se samtliga deltagande institutioner. I K-samsök kan du hitta beskrivningar och avbildningar av bl a:

  • Fornminnen, t ex runstenar, gravfält, industrilämningar, vrak, hällristningar mm. Det finns drygt 800 000 objekts varav majoriteten har koordinater och kan visas på en karta.
  • Historisk/k-märkt bebyggelse, t ex kyrkor, slott och annan bebyggelse som anses vara vikttig och värd att bevara. Ca 73 000 av 113 000 har koordinater.
  • Fotografier tagna från andra halvan av 1800-talet fram till idag (drygt 650 000 digitala bilder). Ca 24 000 av dessa har koordinater.
  • Föremålsbeskrivningar och bilder från svenska museer, allt från stenyxor från stenålder till modern teknikhistoria från Sverige och övriga världen.
  • Läs mer om samtliga objektstyper här.

I www.kringla.nu kan du söka i K-samsök och se både innehåll och en exempel-tillämpning på API:et. Supportfrågor skickas till ksamsok (at) raa.se.

Vill du testa?
Vill du testa K-samsöks API utan att ansöka om en API-nyckel kan du använda vår test-nyckel, ange ”x-api=test”. Läs mer nedan.

Riksantikvarieämbetet sparar inte ned någon media (t ex digitala bilder), dessa kan länkas in från respektive institution. Syftet med K-samsök är att göra metadata om kulturarv så tillgänglig som möjligt. Metadata i K-samsök levereras även vidare till den europeiska samsökningsinitiativet Europeana.

Anrop mot K-samsök görs via http och svaret kommer i xml.

Vill du släppa din app publikt ombeds att respektera de upphovsrättsliga begränsningar för media som definieras i form av Creative Commonslicenser (se även http://www.ksamsok.se/resurser/rattigheter/).

Tips

  • Vill du vara säker på att få svar med objekts om har en bild, använd indexet thumbnailExists (thumbnailExists=”j”)
  • Foton med koordinater (drygt 23 000), hittas genom att använda indexet GeoDataExists (GeoDataExists=”j”) och filtrera på objektstypen ”foto”. miljö (se objektstyper http://www.ksamsok.se/resurser/protokoll-och-parametrar/objektstyper/).
  • På samma sätt går det att filtrera fram kulturmiljöobjekts t ex fornlämningar och skyddad bebyggelse med koordinater men filtrera på objektstypen ”miljö” eller ”byggnad”. Filtrera på serviceName=”fmi” (fornlämningar i FMIS) resp serviceName=”bbrb” (byggnader i Bebyggelseregistret) för att endast få fram fornlämningar och skyddad historisk bebyggelse.

För att få fram en viss typ av t ex föremål eller byggnad (t ex kyrkor), filtrera på ”itemClass”.

Obligatoriska parametrar

Det finns ett fåtal parametrar som är gemensamma för samtliga API metoder. Dessa parametrar beskrivs kortfattat här.

method

Parameter som anger vilken API-metod som används. Om denna utelämnas återfår man endast ett felmeddelande. Anger man en metod som ej finns reflekteras även detta i ett felmeddelande. Skall man exempelvis använda metoden search skriver man method=search.

x-api

Vi har infört att man måste använda en API nyckel för att kunna söka i K-samsök. Detta har inget med att vi vill hålla folk från att använda K-samsök utan endast för att kunna samla statistik på användadet. För att få tag på en API nyckel behöver man endast kontakta Riksantikvarieämbetet på ksamsok (at) raa.se. Det finns också en test-nyckel som är tänkt att användas av individer som vill utveckla en sökapplikation. Denna är inte avsedd att användas för färdiga applikationer och vi ser gärna att man använder den så lite som möjligt. Även under utvecklingsstadiet är det ok att be om en API nyckel till sin applikation. För att använda test nyckeln så skriver man x-api=test. Har man en riktig API nyckel är det bara byta ut ”test” mot denna.

Exempel

Grunden till ett anrop till K-samsöks API borde alltså exempelvis se ut på följande sätt:

http://www.kulturarvsdata.se/ksamsok/api?method=[metodnamn]&x-api=[api-nyckel]

Teckenkodning

K-samsöks API använder UTF-8. Att använda annan teckenkodning leder till att en sökning kan ge felaktigt resultat eller inget resultat.

En sida måste ha contentType satt till UTF-8

<meta content=”text/html;charset=UTF-8” http-equiv=”content-type”>

Och det formulär som anropar APIet måste också vara satt till UTF-8

<form action=”www.kulturarvsdata.se/ksamsok/api?…” accept-charset=”UTF-8″>