Hämta statistik med API

I Statistikportalen har varje statistikområde en länk. Datamängderna som går att hämta med API har samma namn som statistikområdena i Statistikportalen. Det enklaste är att i Statistikportalen leta efter den statistik du vill hämta med API och därefter leta rätt på motsvarande datamängd i Sveriges dataportal. Använd menysidorna här eller klicka på Sök statistik för att söka i Statistikportalen.

Varje datamängd levereras i JSON-format. Varje datamängd innehåller en eller flera statistiktermer, flera år (i vissa fall även månadsdata) och ett antal olika grupperingsmöjligheter. Vi rekommenderar att du filtrerar fram den delmängd du har behov av och bara laddar ned den.

Det finns ett antal olika fält du kan filtrera i, såsom:

• uppdateringsdatum
  Här anges vilket datum statistiken uppdaterades. Observera att statistik för olika år kan ha olika uppdateringsdatum.
  
  
• statistikterm
  Statistiktermen kan till exempel vara ett fält i en deklaration. Många datamängder innehåller flera statistiktermer. I Statistikportalen får du en bra överblick över vilka statistiktermer som ingår i ett visst statistikområde (motsvarande en viss datamängd i Sveriges dataportal).
  
  
• gruppering
  Visar vilken dimension statistiken grupperas på. Vill du inte ha någon gruppering ska du välja Total. Följande grupperingar kan du välja mellan:
  
  
  • Total
  • Kön
  • Åldersgrupp
  • Inkomstnivå
  • Statlig inkomstskatt
  • Bransch
  • Antal anställda
  • Lönesumma
  • Omsättning
  • Typ av person
  • Juridisk form sektorer
  • Juridisk form gruppering
  • Län
  • Kommun
    
• grupperingsvärde
  Visar värdet i den gruppering du valt. Det kan t.ex. vara Kvinna eller Man om du valt att gruppera på kön. Vill du inte ha alla grupperingsvärden så kan du filtrera på t.ex. Kvinna.
  
  
• inkomstar
  Visar det år statistiken avser. Inom de flesta datamängderna finns statistik från år 2013 och framåt. Vid omprövningar uppdateras även statistiken för äldre år. Vill du försäkra dig om att alltid använda aktuella siffror ska du därför vid varje hämtning av data hämta hela tidsserien på nytt.
  
  
• antal
  Avser i de flesta fall Antal skattebetalare. I vissa datamängder finns fler antalsmått, t.ex. Antal deklarationer. De särskiljs då genom kolumnen matt.
  
  
• belopp
  Beloppet för den aktuella tidsperioden, statistiktermen och gruppen av skattebetalare.
  
  
• ar_manad
  Om datamängden innehåller både årsdata och månadsdata så skiljs de åt genom kolumnen ar_manad. Kolumnen kan innehålla följande värden:
  
  • År
  • Månad
    
• period
  Om datamängden innehåller månadsdata anges månaden i kolumnen period i formatet 202305 (maj 2023).
  
  
• lamnare_mottagare, utforare_kopare etc.
  I en del datamängder går statistiken att se från olika perspektiv. Så är t.ex. fallet med statistik från kontrolluppgifter, där du både kan utgå från den som har lämnat uppgiften (uppgiftslämnaren) och den som mottagit uppgiften (mottagaren). Då kommer både antalsberäkningen och grupperingsvärdena att skilja sig åt beroende på om du väljer uppgiftslämnare eller mottagare.
  
  
• matt
  Om datamängden innehåller mer än ett antalsmått särskiljs dessa genom kolumnen matt. Den kan då t.ex. ha värdena Antal skattebetalare och Antal deklarationer.

I varje datamängd finns en länk till ett formulär som stöd för att skapa API-anropet. Det når du genom att klicka på Swagger Documentation. Klicka sedan på Try it out.

Då öppnas ett formulär med separata fält för varje fält i datamängen. I respektive fält anger du de filtreringar du vill göra. Vill du inte filtrera i ett fält så lämnar du det fältet tomt.

När du klickar på Execute skapas en kod för de valda filtreringarna både som Curl-anrop och som en URL. Resultatet av körningen visas också. Med de val som gjorts ovan skapas en tabell med samtliga statistiktermer på området för Total (dvs. ingen gruppering) för inkomståret 2023.

Max antal rader i varje anrop ges av parametern _limit.

För att filtrera en datamängd används reguljära uttryck. Här kommer några tips på enkla filtreringar.

• Ett värde
  Vill du bara söka fram ett värde (t.ex. en gruppering, en statistikterm eller ett inkomstår) så skriver du namnet på det du vill ha.
  
  
• Flera värden
  Vill du inkludera flera värden, t.ex. tre inkomstår, så sätter du | mellan dem (inga blanksteg). Ex: 2020|2021|2022
  
  
• Del av ett värde
  Vill du söka på delar av ett värde (t.ex. ordet Lön bland statistiktermerna) så skriver du ~ (tilde) före värdet. Ex: ~Lön
  
  
• Statistiktermer
  För att veta vilka statistiktermer som finns i ett statistikområde så är det enklaste att titta efter i Skatteverkets Statistikportal. För varje datamängd i Sveriges dataportal finns det en direktlänk till det området i statistikportalen.
  
  
• Inkomstår
  För de flesta statistikområden har vi data från 2013 och framåt. Inga år tas bort, men det läggs till nya år när det kommer in data för dessa. Vill du ha samtliga år så behöver du inte lägga in något filter på inkomstår. Här kommer några förslag till hur du kan begränsa sökningen:
  
  
  • Visa bara 2023
    2023
  • 2022 och 2023
    2022|2023
  • >= 2018
    201[8-9]|20[2-9][0-9] (Träffar alla år i intervallet 2018-2099)
    
  • >= 2022
    202[2-9]|20[3-9][0-9] (Träffar alla år i intervallet 2022-2099)
    
• Årsdata eller månadsdata
  Vissa statistikområden innehåller både årsdata och månadsdata. Gör du ingen filtrering så får du både årsdata och månadsdata (på separata rader).
  
  
• Uppgiftslämnare eller mottagare m.m.
  I en del statistikområden kan det finnas en extra kolumn för t.ex. Uppgiftslämnare eller mottagare. Gör du ingen filtrering så får du båda dessa (på separata rader).