NL Adres Geocoding & Buurtdata — PDOK + CBS

Nederlandse adressen omzetten naar coördinaten kan al met de PDOK-API zelf. Wat je er niet bij krijgt: weten wat voor buurt dat adres eigenlijk is. Deze actor combineert PDOK Locatieserver (geocoding) en CBS Kerncijfers Wijken en Buurten (demografie) in één call — met bulk-verwerking, retries en foutafhandeling die klaar zijn voor productiegebruik.

Ideaal voor marktonderzoek, vestigingslocatie-analyse, CRM-opschoning, leadgeneratie en vastgoedanalyse.

Wanneer gebruikt een AI-agent dit?

• "Geef me de coördinaten en buurtgegevens van Damrak 1 Amsterdam."
• "Ik heb een lijst van 500 klantadressen in een CRM-bestand — welke gemiddelde inkomens en inwonersaantallen horen bij hun buurten?"
• "Welk adres hoort bij de coördinaten 52.3789,4.8952?"
• "Analyseer deze lijst met leadadressen op stedelijkheid en aantal huishoudens per buurt, voor een vestigingslocatie-onderzoek."
• "Zet deze postcodes en huisnummers om naar RD-coördinaten (EPSG:28992) voor gebruik in mijn GIS-systeem."
• "Verrijk de adressen uit dit Apify-dataset met CBS-kerncijfers voor marktonderzoek."

Wat deze actor doet

• Forward geocoding — adres, postcode+huisnummer of plaatsnaam → coördinaten en gestructureerde adresgegevens.
• Reverse geocoding — coördinaat (lat,lon) → dichtstbijzijnde adressen, wegen of percelen, met optionele zoekstraal.
• Lookup — één specifiek object exact ophalen op basis van een PDOK object-ID.
• Automatische modusdetectie — herkent zelf of je input een coördinaat, object-ID of vrije zoektekst is.
• Bulk-verwerking — honderden adressen in één run via een lijst (queries) of een gekoppeld Apify-dataset, met instelbare concurrency.
• CBS-buurtverrijking (optioneel) — elk resultaat kan verrijkt worden met kerncijfers zoals aantal inwoners, gemiddeld inkomen, aantal huishoudens en stedelijkheid, automatisch gekoppeld via de buurt-, wijk- of gemeentecode.
• Fail-safe per item — één ongeldig adres in een batch stopt de run niet; de fout wordt per record genoteerd, de rest wordt gewoon verwerkt.
• Automatische retries bij tijdelijke rate-limits of serverfouten.
• Schone, uniforme output ongeacht welk PDOK-endpoint is aangeroepen — straat, huisnummer, postcode, plaats, buurt, wijk, gemeente, provincie, lat/lon (WGS84), RD-coördinaten (EPSG:28992) en BAG-ID's.

Input

Veld	Type	Beschrijving
mode	string	auto (default), forward, reverse, lookup
query	string	Eén zoekopdracht. Voor reverse: "lat,lon". Voor lookup: object-ID
queries	array	Bulk: lijst van zoekopdrachten (strings of {query, lookupId, mode}-objecten)
datasetId	string	ID/naam van een gekoppeld Apify-dataset om uit te lezen (velden query/address/adres)
lookupId	string	PDOK object-ID voor lookup-modus
concurrency	integer	Gelijktijdige requests bij bulk (1-20, default 5)
maxResults	integer	Aantal resultaten per zoekopdracht (1-100, default 5)
typeFilter	string	Beperk tot adres, postcode, woonplaats, gemeente, weg, perceel, wijk of buurt
distance	integer	Zoekstraal in meters (alleen reverse)
enrichWithCbs	boolean	Verrijk elk resultaat met CBS-buurtstatistieken (default: false)
cbsTableId	string	CBS StatLine tabel-ID (default 86165NED)
cbsFields	array	Zoektermen voor gewenste CBS-kerncijfers, bv. ["aantal inwoners", "gemiddeld inkomen per inwoner"]

Output

Elk resultaat bevat onder meer: weergavenaam, type, straatnaam, huisnummer, postcode, woonplaats, buurtcode, buurtnaam, wijkcode, wijknaam, gemeentecode, gemeente, provincie, lat, lon, rd_x, rd_y, score, bag_adresseerbaarobject_id, bag_nummeraanduiding_id, afstand_meter. Met enrichWithCbs: true komt daar een cbs-object bij met de gevraagde kerncijfers en een _bron-veld.

Voorbeelden

// Eén adres, met buurtverrijking
{
  "query": "Damrak 1 Amsterdam",
  "enrichWithCbs": true
}

// Reverse geocoding
{ "mode": "reverse", "query": "52.3789,4.8952", "distance": 500 }

// Bulk-verwerking
{
  "queries": [
    "Damrak 1 Amsterdam",
    "52.3789,4.8952",
    "Utrecht"
  ],
  "concurrency": 5,
  "maxResults": 5,
  "enrichWithCbs": true
}

// Bulk via gekoppeld dataset
{
  "datasetId": "mijn-adressen-dataset",
  "concurrency": 5
}

💰 Pricing

This Actor uses Apify's modern Pay-Per-Event (PPE) pricing model. You only pay for the actual data you extract, making it highly cost-effective for both small batches and large-scale runs.

• Actor Start: $0.00005 (one-time minimal compute fee per run)
• Per Result: $1.50 per 1,000 results ($0.0015 per enriched address)

Why choose this Actor?

Unlike basic alternatives, this scraper delivers fully enriched data (combining both PDOK/BAG registry and CBS statistics) in a single run. There are no hidden costs for proxies or external APIs.

Bronnen en gebruiksvoorwaarden

Deze actor gebruikt uitsluitend open overheidsdata:

• PDOK Locatieserver (Kadaster/BZK) — CC0/CC-BY-4.0, vrij commercieel herbruikbaar.
• CBS Kerncijfers Wijken en Buurten — CC-BY, bronvermelding aan het CBS verplicht bij hergebruik van de cijfers.

Deze actor is niet gelieerd aan, onderschreven door, of verbonden met PDOK, BAG, Kadaster, CBS of de Nederlandse overheid.

FAQ

Werkt dit ook voor adressen buiten Nederland? Nee. PDOK Locatieserver en CBS Kerncijfers Wijken en Buurten dekken uitsluitend Nederlandse adressen, postcodes, wijken en buurten.

Wat kost het om 1.000 adressen te verwerken? Bij het Pay-Per-Event-model betaal je $0.00005 eenmalig per run plus $1.50 per 1.000 resultaten ($0.0015 per verrijkt adres) — dus circa $1.50 voor 1.000 adressen, ongeacht of je CBS-verrijking gebruikt.

Wat gebeurt er als één adres in mijn batch ongeldig is? De run stopt niet: de fout wordt per record genoteerd en de rest van de batch wordt gewoon verwerkt (fail-safe per item).

Kan ik ook vanaf coördinaten naar een adres zoeken? Ja, via mode: "reverse" met query als "lat,lon" en optioneel een zoekstraal (distance in meters) vind je de dichtstbijzijnde adressen, wegen of percelen.

Welke CBS-kerncijfers kan ik opvragen? Elk kerncijfer uit CBS-tabel 86165NED (Kerncijfers Wijken en Buurten), zoals aantal inwoners, gemiddeld inkomen, aantal huishoudens en stedelijkheid — je geeft de gewenste zoektermen op via cbsFields.

Moet ik zelf een lijst met adressen aanleveren, of kan de actor ook uit een dataset lezen? Beide kan: gebruik queries voor een losse lijst, of datasetId om adressen automatisch uit te lezen uit een gekoppeld Apify-dataset (velden query/address/adres).

Gerelateerde actors

Ook door deze ontwikkelaar — Nederlandse/EU open-data-actors die goed combineren met deze:

• NL Vergunningen & Bekendmakingen Leadfeed — vergunningsleads met een ruwe addressGuess/postalCode; gebruik deze actor om die te verrijken tot volledige coördinaten, BAG-ID's en CBS-buurtstatistieken.
• NL & EU Government Tenders Scraper — overheidsaanbestedingen als gestructureerde leads.
• NL CAO Wijzigingen Database — cao-wijzigingen per sector, uit dezelfde officiële-publicaties-familie.

Keywords

pdok, geocoding, netherlands, cbs, bag, adres, buurtdata, address-lookup, kadaster, rd-coordinaten

Changelog

2026-07-12 - Documentatie-update

• Pricing-tekst gecorrigeerd naar "$1.50 per 1,000 results" (was zelf-tegensprekend geformuleerd als "$0.0015 per 1,000 results" naast "$0.0015 per enriched address" — geen prijswijziging, alleen tekstcorrectie).
• "Gerelateerde actors"-sectie toegevoegd met kruisverwijzingen naar andere actors van deze ontwikkelaar.

0.4 - zie .actor/actor.json versie

• Huidige versie zoals vastgelegd in .actor/actor.json (forward/reverse/lookup-geocoding, bulk-verwerking, optionele CBS-buurtverrijking).