Publieke API

databuurt API — JSON op de aggregaten en de listings

Eén REST-endpoint per dataset, stabiele schema's, token-authenticatie. Bedoeld voor vastgoed-SaaS, taxatie-tools en interne dashboards.

Vraag een API-token Bekijk een live response

Wat zit er in

€/m² per gemeente — mediaan en spreiding, filterbaar op woningtype, label, m² en kamers.
Energielabel-premium — wat een sprong van label X naar Y oplevert per gemeente.
Prijsverlagingen-feed — recente verlagingen met delta in % en absolute waarde.
Listing-export — paginated, met snapshot-datum, geo en alle publieke velden.
Gemeente-grenzen GeoJSON — CBS-gebaseerd, gecoupled aan onze ID's.

Prijs en limieten

Starter — € 199/maand, tot 10.000 calls. Voor MVP-integraties.
Growth — € 499/maand, tot 100.000 calls + webhook bij snapshots.
Volume — usage-based € 0,003/call boven 100k, of jaarcontract.
Rate-limit standaard 30 req/sec per token, op te schroeven op verzoek.
Versiebeleid: schema-changes minimaal 90 dagen aangekondigd.

Volledige tier-vergelijking

Snelle start

Onderstaand endpoint is nu al publiek beschikbaar als preview, zonder authenticatie. Bij een betaald token krijg je een hogere rate-limit en alle andere endpoints erbij.

# Mediaan €/m² per gemeente, filterbaar
curl -s 'http://localhost:8412/api/price-per-m2/municipality?object_type=apartment&energy=A,A%2B' \
  | jq '.Amsterdam'

Voorbeeld-response (verkort):

{
  "municipality": "Amsterdam",
  "n": 1247,
  "median_price_per_m2": 7820,
  "p25": 6510,
  "p75": 9180,
  "last_snapshot": "2026-05-22"
}

Met een API-token wordt het:

curl -s 'https://api.databuurt.nl/v1/price-per-m2/municipality?object_type=apartment' \
  -H 'Authorization: Bearer fs_live_XXXXXXXXXXXXXXXX' \
  | jq '.[] | select(.n > 200)'

Publieke v1 endpoints (geen authenticatie nodig)

Onderstaand zijn nu publiek beschikbaar onder een CC-BY-4.0 licentie. Cache-Control: public, max-age=3600. CORS staat open.

GET /api/v1/municipalities — lijst gemeenten met mediaan €/m².
GET /api/v1/municipality/{naam} — details per gemeente.
GET /api/v1/wijken — wijken met statistieken.
GET /api/v1/national-overview — landelijk dashboard als JSON.
GET /api/v1/energy-label-premium — premium per gemeente.
GET /api/v1/openapi.json — OpenAPI 3 schema.

Aanvullend: /llms.txt en /llms-full.txt voor LLM-retrieval.

Wat je ermee bouwt

Taxatie-software: automatische comparables-pull op postcode-4 en €/m²-benchmark.
Hypotheek-rekentools: realistische €/m² als invoer voor BKR-checks en haalbaarheids-indicatoren.
Beleggingsdashboards: spreiding van rendementen per gemeente, label-premies in de tijd.
Interne BI: voeg gemeente-marktdata toe naast je eigen pipeline, zonder zelf te scrapen.

Veelgestelde vragen

Is de API gratis?

Een paar publieke aggregaat-endpoints onder /api/v1/ zijn gratis te gebruiken (CC-BY-4.0). Voor authenticated endpoints met hogere rate-limits en de volledige listing-export starten de tarieven bij € 199 per maand.

Welke endpoints zijn nu publiek beschikbaar?

/api/v1/municipalities, /api/v1/municipality/<naam>, /api/v1/wijken, /api/v1/national-overview, /api/v1/energy-label-premium en /api/v1/openapi.json. Alle responses bevatten een meta-block met snapshot-datum en licentie.

Wat is de rate-limit?

Standaard 30 requests per seconde per token. Voor publieke (token-loze) calls gebruiken we per-IP throttling van enkele requests per seconde.

Welk versiebeleid hanteren jullie?

Breaking schema-changes worden minimaal 90 dagen vooraf aangekondigd. Nieuwe velden worden niet als breaking gezien zolang bestaande velden blijven bestaan.

Mag ik de data hergebruiken?

Ja, onder CC-BY-4.0 — graag met attributie naar databuurt en een linkback. Voor commercieel gebruik via de paid tiers geldt de SaaS-EULA die je bij token-uitgifte krijgt.