API för artobservationer från flera dataset

Sidan granskad:  2025-04-29

SLU Artdatabankens API för artobservationer hämtar data från en rad olika svenska dataset, däribland Artportalen. API:et släpptes hösten 2021 och är sedan dess det API som också i första hand gäller för den som vill hämta data ur Artportalens databas.

Jämfört med API:erna för särskild Artportalen-funktionalitet har API:et för artobservationer från flera dataset bättre prestanda och möjliggör snabbare sök.

Om API:et för artobservationer från flera dataset

Sökning kan göras i alla dataset (se längre ner vilka dataset som är aktuella) eller i en för ändamålet anpassad kombination av dataset i en och samma sökning. Resultatet har samma format oavsett vilka dataset som väljs.

Observationssökningar har bland annat stöd för

  • paginering
  • sortering
  • filtervalidering
  • filter som kan kombineras med varandra för önskat resultat. Några exempel är spatiala filter med stöd för polygoner, multipolygoner samt fördefinierade regioner, datumfilter, exkludering av ovaliderade fynd och taxonlistor. Man kan även söka på högre taxa och inkludera all underliggande taxa i sökresultatet.
  • aggregera data till gridrutor. Rutorna beskrivs i WGS84.

För mer information om vilka möjligheter som finns att hämta data från Artportalen, se längre ner under rubriken Artportalen.

Språk

Alla sökresultat går att få presenterade på både svenska och engelska.

Aggregeringar

Sökresultatet kan anpassas på en mängd olika sätt. Ett exempel är gruppering på taxonnivå. Istället för att returnera alla observationer så returneras i detta fall en lista av taxon med en tillhörande siffra som indikerar hur många observationer som påträffats för var och en av arterna i listan. Detta görs via ett separat anrop. Det finns även möjlighet att utöka grupperingen genom att gruppera på rutor i ett rutnät. Detta kan vara hjälpsamt när man vill presentera en översiktlig bild av sökresultatet utan att för den delen rita ut alla observation i kartan på en gång.

Regionsökningar

Fritextsökning på fördefinierade regioner samt nedladdning av dess polygoner erbjuds via separata anrop.

Begränsningar

Max 10 000 poster

En observationssökning är idag begränsad till att returnera högst 10 000 fynd av prestandaskäl. Det är dock möjligt att fråga API:et om antalet fynd som finns i databasen för en specifik sökning och sedan dela upp sökningen i flera frågor om det skulle visa sig att antalet observationer i resultatet överskrider maxgränsen. Vill man ha fler än 10 000 observationer erbjuder vi exporter på upp till två miljoner fynd i formaten: CSV, Excel, GeoJSON och Darwin Core Archive.

 

Taxonomisk information

För att söka observationer av specifika arter kan du använda taxonfiltret. I det filtret används Dyntaxas taxon-id som du kan få tag i genom att använda Dyntaxa Taxon Service API.

Det går också att hämta naturvårdslistor för t.ex. rödlistade arter, fridlysta arter och habitatdirektivsarter, genom att använda API:et för naturvårdslistor, Taxon List Service API.

Exporter

Vi erbjuder exporter i formaten: CSV, Excel, GeoJSON och Darwin Core Archive. API:et kan leverera filer med upp till 50 000 fynd direkt i anropet. Om det är fler än 25 000 fynd och mindre än två miljoner så skapas en asynkon filbeställning. När filen är klar får du då ett mail med en nedladdningslänk.

DOI

Det finns för närvarande inget stöd för skapa beständiga identifierare av typen DOI, men det är planerat att implementeras under hösten 2025 eller början av 2026.

Dataset

Observera att datakällor kan tillkomma eller tas bort. En kontinuerligt uppdaterad lista på dataset för artobservationer finns här. Listan nedan garanteras inte att vara komplett.

Artportalen

Artportalens databas innehåller i dagsläget (februari 2024) ca 110 miljoner observationsuppgifter av vilda arter i Sverige. Datat är främst från de senaste decennierna men historiska data fylls på successivt. Merparten av allt data som finns i Artportalen är öppet och tillgängligt via API:et, undantaget det data som är skyddsklassat. Läs mer om skyddade fynd nedan.

Läs mer om Artportalen

Följande är exempel på möjligheter via API:et när det gäller Artportalen:

  • Söka på specifika arter eller artgrupper inom specifika områden och inom definierade tidsintervall.
  • Filtrera sökresultat på de flesta tillgängliga parametrar i Artportalen.
  • Visa fynduppgifter och deras egenskaper.
  • Söka fram artlistor, t.ex. rödlistade arter, fridlysta arter, främmande arter, habitatdirektivsarter, fågeldirektivsarter, ÅGP-arter o.s.v.
  • Hämta länkar till bilder från Artportalen.
  • Hämta lista över alla projekt med tillhörande projekt-ID:n
  • Inloggning med SLU Artdatabanken-konto vilket möjliggör att hämta skyddade fynd inom den region och inom de taxagrupper användaren har behörighet till.

Skyddade fynd

I Artportalen skyddas fynd av de arter som är upptagna på SLU Artdatabankens lista över skyddsklassade arter genom att de döljs helt eller att de exakta koordinaterna diffuseras i kartvisningar i olika stora rutor beroende på skyddsklass. Användare har även möjligheter att skydda fynd om de anser att skäl finns.

I API:et finns inte möjligheten att hämta skyddade fynd för diffuserad visning. Skyddade fynd kan dock visas för den enskilde användare som loggar in och som då får tillgång till sina egna skyddade fynd samt till de skyddade fynd som användaren eventuellt har behörighet att se.

Läs mer om skyddsklassning av arter

Teknisk dokumentation

Teknisk dokumentation finns på SLU Artdatabankens utvecklarportal, samt på GitHub. På GitHub finns också dokumentation för sökparametrar och autentisering.

Länkar

Kontakt

För frågor och ärenden gällande SLU Artdatabankens API:er, använd kontaktformuläret för API:er.