# Bulk geocode a list of addresses for CRM cleanup

**Use case:** 

Convert a batch of Dutch addresses or coordinates to coordinates, BAG IDs and postcode/gemeente data in one run, with fail-safe per-item error handling.

## Input

```json
{
  "mode": "auto",
  "query": "Damrak 1 Amsterdam",
  "queries": [
    "Damrak 1 Amsterdam",
    "52.3789,4.8952",
    "Utrecht"
  ],
  "concurrency": 5,
  "maxResults": 5,
  "typeFilter": "",
  "distance": 50,
  "enrichWithCbs": false,
  "cbsTableId": "86165NED",
  "cbsFields": [
    "aantal inwoners",
    "gemiddeld inkomen per inwoner",
    "huishoudens totaal",
    "stedelijkheid"
  ],
  "cbsHistoricalTables": {},
  "addSummaryRecord": true
}
```

## Output

```json
{
  "input_query": {
    "label": "Input query",
    "format": "string"
  },
  "mode": {
    "label": "Modus",
    "format": "string"
  },
  "results.weergavenaam": {
    "label": "Weergavenaam"
  },
  "results.type": {
    "label": "Type"
  },
  "results.straatnaam": {
    "label": "Straat"
  },
  "results.huisnummer": {
    "label": "Huisnr",
    "format": "number"
  },
  "results.postcode": {
    "label": "Postcode"
  },
  "results.woonplaats": {
    "label": "Woonplaats"
  },
  "results.gemeente": {
    "label": "Gemeente"
  },
  "results.provincie": {
    "label": "Provincie"
  },
  "results.lat": {
    "label": "Latitude",
    "format": "number"
  },
  "results.lon": {
    "label": "Longitude",
    "format": "number"
  },
  "results.rd_x": {
    "label": "RD X",
    "format": "number"
  },
  "results.rd_y": {
    "label": "RD Y",
    "format": "number"
  },
  "results.buurtcode": {
    "label": "Buurtcode"
  },
  "results.buurtnaam": {
    "label": "Buurt"
  },
  "results.wijkcode": {
    "label": "Wijkcode"
  },
  "results.wijknaam": {
    "label": "Wijk"
  },
  "results.gemeentecode": {
    "label": "Gem.code"
  },
  "results.score": {
    "label": "Score",
    "format": "number"
  },
  "results.id": {
    "label": "PDOK ID"
  }
}
```

## About this Actor

This example demonstrates how to use [NL Adres Geocoding & Buurtdata — PDOK + CBS](https://apify.com/codeclouds/pdok-locatieserver.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/codeclouds/pdok-locatieserver.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
This Task's input is already configured above — use it as-is rather than inventing a new one.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/codeclouds/pdok-locatieserver.md

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).