API voor plaatsen rondom een plaats

Vraag dorpen, steden, buurtschappen, wijken en gemeenten binnen een gekozen straal op als JSON. Handig voor servicegebieden, lokale SEO, regionale lijsten en interne tools.

Endpoint

Gebruik een GET-request met minimaal de parameter plaats.

GET https://www.plaatsenrondom.nl/api/plaatsen-rondom?plaats=Hooghalen&straal=25&types=stad,dorp,gemeente&limit=100

Parameters

Naam	Verplicht	Beschrijving
plaats	Ja	Plaatsnaam of slug, bijvoorbeeld `Hooghalen` of `hooghalen`.
straal	Nee	Afstand in kilometers. Mogelijk: 5, 10, 15, 25, 50. Standaard: 25.
types	Nee	Kommagescheiden lijst. Mogelijk: stad, dorp, buurtschap, wijk, buurt, gemeente.
limit	Nee	Maximaal aantal resultaten. Standaard 100, maximum 1000.

Voorbeeldrespons

{
  "origin": {
    "name": "Hooghalen",
    "slug": "hooghalen",
    "type": "dorp",
    "province": "Drenthe"
  },
  "radius_km": 25,
  "types": ["stad", "dorp", "gemeente"],
  "count": 2,
  "limit": 100,
  "results": [
    {
      "name": "Assen",
      "slug": "assen",
      "type": "stad",
      "distance_km": 9.4,
      "url": "https://www.plaatsenrondom.nl/plaatsen-binnen-25-km/assen"
    }
  ]
}

Afstanden

Afstanden zijn hemelsbreed berekend vanaf het middelpunt van de gekozen plaats. De werkelijke reisafstand over de weg kan dus afwijken.

Foutmeldingen

Een onbekende plaats geeft een 404. Ongeldige parameters, zoals een niet-ondersteunde straal, geven een 422 met validatiefouten.

Geen API-key nodig

Het endpoint is openbaar te gebruiken. Houd requests redelijk en cache resultaten waar dat kan.