Kommunkollen

Slå upp postnummer, kommunkod, koordinat eller kommunnamn. Gratis JSON-API utan nyckel.

Vad verktyget gör

Kommunkollen svarar på frågor som: vilken kommun tillhör postnummer 11432? Vad heter kommunen med kod 0180? Vilken kommun innehåller koordinaten 59.33, 18.07?

Postnummer (5 siffror) returnerar postort, kommunkod, länskod och kommungräns på karta.
Kommunkod (4 siffror) returnerar kommunnamn, länsnamn, befolkning och areal.
Kommunnamn söker med prefix- och namnmatchning.
Koordinat (lat, lon i WGS84) returnerar kommunen som innehåller punkten samt närmaste postort.
Adress geokodas via Nominatim och returnerar kommunen för adressen.
Batchläge hanterar upp till 500 rader (postnummer, kommunkod, koordinater och adresser) i ett anrop.
Delningslänk genereras automatiskt via URL-parametern ?q=....

API

Gratis JSON-API, ingen nyckel krävs. Hastighetsbegränsning: 60 anrop/min per IP-adress (adressuppslag: max 10/min).

Typ	URL
Postnummer	`GET /tools/kommunkollen/api/?postnummer=11432`
Kommunkod	`GET /tools/kommunkollen/api/?kommunkod=0180`
Kommunnamn	`GET /tools/kommunkollen/api/?namn=Stockholm`
Koordinat	`GET /tools/kommunkollen/api/?lat=59.329&lon=18.068`
Adress	`GET /tools/kommunkollen/api/?adress=Storgatan+1,+Uppsala`
Batch	`POST /tools/kommunkollen/api/` med body `batch=11432%0A59.33,18.07%0AStockholm&type=auto`
Autocomplete	`GET /tools/kommunkollen/api/?suggest=Stock`

Batchläge

Skicka en POST till /tools/kommunkollen/api/ med fälten batch (rader separerade med radbrytning) och type.

type-värde	Vad som matchar
`auto`	Auto-detekterar typ per rad: 5 siffror = postnummer, 4 siffror = kommunkod, tal,tal = koordinat, text = adress
`postnummer`	Alla rader tolkas som postnummer
`kommunkod`	Alla rader tolkas som kommunkoder
`latlon`	Alla rader tolkas som koordinatpar (lat,lon)
`adress`	Alla rader geokodas via Nominatim. Max 20 nya geokodningar per anrop (cachat = obegränsat).

include=-parametern

Lägg till &include=geom,grannar,postnummer till GET-anrop för att hämta tyngre data. Utan parametern returneras grunddata utan geometri, grannkommuner eller postnummerlista.

GET /tools/kommunkollen/api/?kommunkod=0180&include=geom,grannar
# Returnerar kommungräns (GeoJSON) och lista på grannkommuner.

Exempelsvar: postnummer

GET /tools/kommunkollen/api/?postnummer=11432

{
  "type": "postnummer",
  "postnummer": "11432",
  "postort": "Stockholm",
  "lat": 59.33935,
  "lon": 18.07476,
  "kommunkod": "0180",
  "kommunnamn": "Stockholm",
  "lanskod": "01",
  "lansnamn": "Stockholms län",
  "befolkning": 975551,
  "areal_km2": 188.0,
  "geom": { ... }
}

Felkoder

HTTP	Beskrivning
`200`	Resultat hittades
`400`	Ogiltig inmatning (ogiltigt postnummer, koordinat utanför Sverige, etc.)
`404`	Inget resultat hittades
`429`	För många anrop. Vänta en minut (header `Retry-After: 60`)

Datakällor

Kommungränser: Lantmäteriets öppna geodata (SWEREF99 TM, omprojectat till WGS84)
Postnummer: GeoNames Sverige (CC-BY-4.0)
Befolkning och areal: SCB

CORS

API:t svarar med Access-Control-Allow-Origin: * på alla endpoints, inklusive batch-POST. Det innebär att du kan anropa API:t direkt från en webbläsare på valfri domän utan proxying. Anropen räknas mot hastighetsbegränsningen per IP oavsett origin.

Fetch-exempel

const res = await fetch('https://mackan.eu/tools/kommunkollen/api/?postnummer=41101');
const data = await res.json();
console.log(data.kommunnamn); // "Göteborg"