# Dutch CBS Statistics Scraper (`parseforge/dutch-cbs-statistics-scraper`) Actor

Scrapes Dutch CBS statistics tables and catalog entries. Returns flat rows with table IDs, themes, and OData-filtered values. No API key needed.

- **URL**: https://apify.com/parseforge/dutch-cbs-statistics-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Business, Other, Education
- **Stats:** 2 total users, 1 monthly users, 89.7% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $14.00 / 1,000 result items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **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 usage examples, see the [API](#api) section below.

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).

# README

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

### Dutch CBS Statistics Scraper

**Scrape Dutch CBS statistics tables and the full catalog, up to a million datasets per run.** Every row comes with its official table ID, themes, modification dates, and OData-filtered values. No API key or registration. Export to CSV, JSON, Excel, or XML.

Statistics Netherlands (CBS) publishes thousands of official datasets, but the web portal is built for browsing one table at a time. This Actor reads the public OData feeds directly, so you can pull the entire table catalog or filter any table's rows by region, period, or value in one run.

| Who uses it | What they scrape Dutch CBS Statistics for |
|---|---|
| Market researchers | Pull demographic or economic tables for trend analysis |
| Data journalists | Get official statistics for fact-checking and stories |
| Policy analysts | Monitor regional indicators across municipalities |
| Academic researchers | Build datasets for social science studies |
| Business intelligence teams | Enrich internal data with official CBS figures |

### What it does

This Actor collects CBS catalog entries or rows from a specific CBS table, and returns each record as a flat row.

- 📚 **Catalog mode:** list every CBS table with its ID, title, themes, and modification date.
- 📊 **Table mode:** pull rows from a specific table, with OData filters, column selection, and sorting.
- 🔍 **OData filtering:** narrow rows with expressions like "AantalInwoners\_4 gt 100000".
- 📁 **Flat output:** each record becomes one row, ready for CSV, JSON, Excel, or XML.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with Dutch CBS Statistics data

**📈 Track regional demographics.**

A policy analyst pulls population figures for all Dutch municipalities and compares growth rates to allocate funding.

**📰 Fact-check economic claims.**

A journalist retrieves the latest unemployment table and filters by province to verify a politician's statement.

**🎓 Build a research dataset.**

An academic collects housing price indices over several years and joins them with income data for a regression model.

**📊 Monitor business indicators.**

A BI team schedules weekly pulls of retail turnover tables to feed a dashboard.

### Why choose this scraper

|  | What you get |
|---|---|
| **Official source** | Data comes directly from CBS OData feeds, not scraped HTML |
| **No API key** | Uses the public endpoint, no registration or token needed |
| **Flexible queries** | Full OData filter, select, and orderBy support |
| **Scalable** | Collect up to 1,000,000 datasets per run |

### How it compares

This Actor focuses on official CBS statistics, while the Nationalevacaturebank scraper targets job listings, a different data source.

| Feature | ParseForge | Nationalevacaturebank Jobs Search Scraper |
|---|---|---|
| Scrapes CBS statistics | Yes | Not listed |
| Catalog mode for all tables | Yes | Not listed |
| OData filter support | Yes | Not listed |
| No API key required | Yes | Not listed |
| Scrapes job listings | Not listed | Yes |

### Configure the run

Drive the Actor with a mode, a table ID, and optional OData filter, select, and orderBy expressions. Filters run server-side so only matching rows reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

```json
{
  "maxItems": 10,
  "mode": "table",
  "tableId": "82931NED"
}
```

A larger pull:

```json
{
  "maxItems": 200,
  "mode": "table",
  "tableId": "82931NED"
}
```

### Pricing

Pay-per-result: **$0.01867 per result** collected. You pay only for the results written to your dataset.

| Results collected | Approximate cost |
|---|---|
| 100 results | $1.87 |
| 1,000 results | $18.67 |
| 10,000 results | $186.70 |

New Apify accounts start with $5 in free credit.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [Dutch CBS Statistics Scraper](https://apify.com/parseforge/dutch-cbs-statistics-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to Dutch CBS Statistics through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com/?tools=parseforge/dutch-cbs-statistics-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**Why am I getting no results?**

Check your OData filter expression. A wrong field name or value will return zero rows. Run in 'catalog' mode first to see available fields, or leave the filter empty to get all rows.

**The table ID is invalid.**

Table IDs are case-sensitive and must match exactly. Run 'catalog' mode to list all valid IDs, then copy the one you need.

**I get an error about OData syntax.**

Make sure your filter, select, or orderBy expression follows OData rules. Use single quotes around string values and proper operators like 'eq', 'gt', 'lt'.

**The run takes too long.**

Reduce 'maxItems' or add a filter to narrow the result set. You can also use 'select' to return fewer columns, which speeds up the download.

### FAQ

| Question | Answer |
|---|---|
| What is CBS? | Statistics Netherlands (Centraal Bureau voor de Statistiek) is the Dutch national statistical office. It publishes official data on population, economy, health, and more. |
| Do I need an API key? | No. The Actor uses the public CBS OData endpoint, which does not require authentication. |
| How do I find a table ID? | Run the Actor in 'catalog' mode first. It returns all table IDs, titles, and themes. Copy the ID you need into the 'tableId' field. |
| What is OData? | OData is a standard query language for web APIs. You can use $filter, $select, and $orderby expressions to control which rows and columns are returned. |
| Can I filter rows by region? | Yes. Use the 'filter' field with an expression like "SoortRegio\_2 eq 'Gemeente '" to get only municipal data. |
| Can I select only specific columns? | Yes. Use the 'select' field with a comma-separated list of column names, for example 'ID,WijkenEnBuurten,AantalInwoners\_4'. |
| How many datasets can I collect? | Set 'maxItems' to any number up to 1,000,000. The Actor stops after that many records. |
| What output formats are supported? | The Actor returns data in the Apify dataset, which you can export to CSV, JSON, Excel, or XML. |
| Is the data in Dutch? | Yes, CBS publishes data in Dutch. Column names and values are in Dutch, but the structure is consistent. |
| Can I schedule this Actor? | Yes, you can set up a schedule in Apify to run it daily, weekly, or at any interval. |

### Related actors

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Statistics Netherlands (CBS). It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

## `maxItems` (type: `integer`):

How many datasets to collect per run.

## `mode` (type: `string`):

Choose 'catalog' to browse the full CBS table catalog (table IDs, titles, themes, modification dates). Choose 'table' to pull rows from a specific table.

## `tableId` (type: `string`):

CBS table identifier (e.g. '82931NED', '83765NED', '85003NED'). Required when mode is 'table'. Find IDs by first running 'catalog' mode.

## `filter` (type: `string`):

Optional OData $filter expression to narrow rows. Examples: "SoortRegio\_2 eq 'Gemeente '" or "AantalInwoners\_4 gt 100000". Leave empty for all rows.

## `select` (type: `string`):

Optional OData $select to return only specific columns, comma-separated. Example: 'ID,WijkenEnBuurten,AantalInwoners\_4'. Leave empty for all columns.

## `orderBy` (type: `string`):

Optional OData $orderby expression. Example: 'AantalInwoners\_4 desc'.

## Actor input object example

```json
{
  "maxItems": 10,
  "mode": "table",
  "tableId": "82931NED"
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxItems": 10,
    "mode": "table",
    "tableId": "82931NED"
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/dutch-cbs-statistics-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "maxItems": 10,
    "mode": "table",
    "tableId": "82931NED",
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/dutch-cbs-statistics-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "maxItems": 10,
  "mode": "table",
  "tableId": "82931NED"
}' |
apify call parseforge/dutch-cbs-statistics-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/dutch-cbs-statistics-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/cRvxPcP5NQm46D6OE/builds/jMD8SX5hG7j0f7Iu9/openapi.json