Buitje API

Het weer achter Buitje, vrij te gebruiken. Een eigen pijplijn op open data — zonder API-key, zonder kosten. Voor hobbyprojecten, dashboards en alles daartussenin.

Basis-URL

https://api.buitje.nl

Snel starten

Eén GET-request is genoeg. Geen registratie, geen sleutel:

curl 'https://api.buitje.nl/forecast?lat=52.37&lon=4.89'

Endpoints

GET/forecast

Weersverwachting voor een locatie: actueel weer plus ~6 dagen vooruit op uurbasis, genest per dag en dagdeel.

GET/climate

Klimaatnormalen per kalendermaand (1991–2020, ERA5): gemiddelde temperatuur, neerslag en wind.

GET/ports

Havens uit de World Port Index: een lijst (te filteren op grootte) en volledige details per haven.

GET/health

Status van de API en welke datasets beschikbaar zijn.

Voorwaarden

De API is gratis en zonder API-key te gebruiken. We vragen drie dingen:

Naamsvermelding. De onderliggende data valt onder open licenties: vermeld "ECMWF Open Data" (forecast), "Copernicus C3S / ERA5" (klimaat) en "NGA World Port Index" (havens) in je toepassing. De juiste tekst zit in elke respons onder source.attribution. Een linkje naar Buitje stellen we op prijs, maar is niet verplicht.

Cache je responses. De forecast ververst maximaal vier keer per dag, klimaat en havens veel minder vaak; vaker dan eens per paar minuten dezelfde opvraag doen heeft geen zin.

Roep de API server-side aan. CORS staat alleen open voor buitje.nl, dus rechtstreeks vanuit de browser werkt niet — laat je eigen backend de requests doen. Er is geen gegarandeerde uptime of supportvenster; de API wordt aangeboden zoals hij is.