Slik bruker du APIet til SSB

Slik er URLene satt opp

APIet har en url-struktur av typen http://data.ssb.no/api/ versjon/ dataset /ID.type ?lang= språk der

• Versjon er dagens beta-versjon som er v0
• ID er et firesifret nummer som identifiserer datasettet
• Type er enten «json» eller «csv»
• Språk er enten er «no» eller «en»

Eksempler på url’er

• http://data.ssb.no/api/v0/dataset/1120

• http://data.ssb.no/api/v0/dataset/1120.json?lang=no

• http://data.ssb.no/api/v0/dataset/1120.csv?lang=en

Vi tilbyr ikke url’er for å hente deler av datasett.

CSV-format

Vi tilbyr CSV semikolonseparert. I det norske grensesnittet benyttes komma som desimalskilletegn for filer. De engelske datasettene har komma som separator og punktum som desimalskilletegn.

JSON-format

Vi benytter formatet JSON-stat som er spesielt utviklet for å formidle statistiske datasett. JSON-stat representerer datakuber som et endimensjonalt array. Det viser en trestruktur, med hovedelementene dataset, dimension og value og status, se json-stat  Format viewer. Det finnes ferdige bibliotek i ulike språk for behandling av JSON-stat.

Stikkord beskriver datasettene

Stikkordene, også kalt tagger, beskriver innholdet i datasettet.

For alle datasett vil én tag vise tabellnummeret i Statistikkbanken som datasettet er hentet fra, f.eks. statistikkbanktabell 08801. Én annen tag viser kortnavnet for statistikken, f. eks. bpi (boligprisindeksen) som du finner her: ssb.no/bpi.

Stikkordet tidsserie er brukt på datasett som inneholder lengre tidsserier

Stikkordene kommuner, fylker, bydeler, grunnkrets og region er brukt på datasett som inneholder data på regionalt nivå.

Kontakt oss

Spørsmål om API og datasettene rettes til: Statistikkbanken.

For spørsmål om den enkelte statistikk og variabler se «Kontaktpersoner» i høyre spalte på den enkelte statistikk. «Om statistikken» under hver statistikk vil dessuten ha definisjoner av variabler.

Se også statistikkbanktabellens fane «Informasjon». Noen statistikkbanktabeller vil i tillegg ha lenker videre til klassifikasjoner, variabeldefinisjoner etc.