# Telefoonboek.nl Scraper - Netherlands Business Directory (`crawlerbros/telefoonboek-scraper`) Actor Scrape telefoonboek.nl, the Netherlands' leading phone/business directory (Places.nl network). Search by category or keyword, optionally scoped to a city, or fetch businesses by URL. Get names, addresses, phone numbers, websites, ratings, and opening hours. - **URL**: https://apify.com/crawlerbros/telefoonboek-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Lead generation, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use 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 ## Telefoonboek.nl Scraper - Netherlands Business Directory Scrape **telefoonboek.nl** — the Netherlands' leading phone/business directory (part of the Places.nl network). Search any of 127 curated categories or a free-text keyword, optionally scoped to a Dutch city, and get names, addresses, phone numbers, websites, ratings, and opening hours. No login, no cookies, no API key, no proxy required. ### What this actor does - **Two modes:** `search` (category/keyword, optionally scoped to a city) and `byUrls` (fetch specific businesses by direct URL) - **127 curated categories** to pick from, or type any custom keyword - **City-scoped search** — restrict results to any Dutch city/town (telefoonboek.nl's own city search, which also includes nearby surrounding places) - **Filter by** minimum star rating (1-5), "has website", "has phone number" - **Rich search results by default** — name, full address, GPS coordinates, phone, website, rating, review count, and today's opening hours all come directly off the search-results listing (no extra request needed) - **Optional full profile details** — turn on `fetchFullDetails` to also collect the complete Monday-Sunday opening-hours table, fax number, business description, list of offered services, and list of service-area towns from each business's profile page - **Empty fields are omitted** — you only ever see fields that were actually found for a business ### Output per business - `name` — business name - `category` — the category/keyword this business was found under - `rating` (1-5), `reviewCount` — telefoonboek.nl publishes its own rating on a 0-10 scale; this actor halves it to the conventional 1-5 star scale used across business-directory actors - `reviewSnippet` — a short excerpt from the business's most recent review, when available; `reviewAuthor`, `reviewDate` — who wrote it and when (ISO date) - `lastUpdated` — the date (ISO) telefoonboek.nl last shows this listing as edited, when published - `fullAddress` — the complete address; `street`, `zipCode`, `city` — parsed parts - `latitude`, `longitude` — GPS coordinates - `phone` — phone number, `fax` — fax number (only with `fetchFullDetails: true`) - `website` — business website - `description` — the business's "about" text from its profile page (only with `fetchFullDetails: true`, when published) - `services[]` — list of services/offerings the business advertises on its profile page (only with `fetchFullDetails: true`, when published) - `serviceAreas[]` — list of surrounding towns/cities the business advertises as its service area (only with `fetchFullDetails: true`, when published) - `openingHours[]` — structured opening hours (`{day, hours}` per day; only today's hours by default, the full Monday-Sunday table with `fetchFullDetails: true`) - `isClaimed` — whether the business has claimed/verified its Places.nl listing - `searchQuery`, `searchCity` — the search parameters used - `sourceUrl` — canonical telefoonboek.nl business page URL - `recordType: "business"`, `scrapedAt` ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string (select) | `search` | `search` (category/keyword) or `byUrls` (fetch by URL) | | `query` | string (select) | `restaurant` | Pick from 127 curated categories, or `custom` to use `customQuery` (mode=search) | | `customQuery` | string | – | Any free-text keyword, overrides `query` (mode=search) | | `city` | string | – | Restrict to a Dutch city/town, e.g. `Amsterdam` (mode=search) | | `businessUrls` | array | – | telefoonboek.nl business page URLs to fetch directly (mode=byUrls) | | `minRating` | integer | `0` (no minimum) | Only return businesses rated at least 1-5 stars | | `requireWebsite` | boolean | `false` | Only return businesses with a listed website | | `requirePhone` | boolean | `false` | Only return businesses with a listed phone number | | `fetchFullDetails` | boolean | `false` | Also fetch each business's profile page for full weekly hours, fax, description, and services (slower) | | `maxItems` | int | `20` | Hard cap on returned records (1-1000) | #### Example: search restaurants in Amsterdam ```json { "mode": "search", "query": "restaurant", "city": "Amsterdam", "maxItems": 20 } ```` #### Example: highly-rated plumbers nationwide, with full weekly hours ```json { "mode": "search", "customQuery": "loodgieter", "minRating": 4, "fetchFullDetails": true, "maxItems": 30 } ``` #### Example: dentists with a website and phone number ```json { "mode": "search", "query": "tandarts", "requireWebsite": true, "requirePhone": true, "maxItems": 50 } ``` #### Example: fetch specific businesses by URL ```json { "mode": "byUrls", "businessUrls": [ { "url": "https://www.telefoonboek.nl/bedrijven/t2036856/zevenaar/ac-restaurant/" } ] } ``` ### Use cases - **Local lead generation** — build a prospect list of Dutch businesses by category and city for B2B outreach - **Market research** — measure business density and average ratings for a category across Dutch cities - **Directory aggregation** — feed structured Dutch business data into your own local-search product - **Competitor mapping** — see who else operates in a category and area, with ratings and contact info ### Limitations - **`city` uses telefoonboek.nl's own scoped search, not an exact filter.** The site's city-scoped search radius includes nearby surrounding places (confirmed: searching `restaurant` + `Amsterdam` also returned some Amstelveen results), matching what a user sees browsing the site directly. - **`description` and `services` aren't published by every business.** Sparse listings (typically unclaimed, address-only entries) don't have a profile description or services section; the fields are simply omitted for those records. - **Today's opening hours only, by default.** The search-results listing shows only the current day's hours; set `fetchFullDetails: true` to collect the complete Monday-Sunday table (one extra request per result). - **No authoritative total-result count used for pagination.** telefoonboek.nl's listing pages do show a "N resultaten" heading, but pagination in this actor stops on the site's own natural signal (two consecutive empty pages) rather than parsing that heading, since it's more resilient to template changes. - **Data source note.** This actor replaces an originally planned `detelefoongids.nl` scraper: that site is protected by an Incapsula WAF that returned an immediate incident-tagged block across every anti-bot tier tested (plain HTTP, browser impersonation, headless Playwright, and stealth Camoufox), consistent with a hard block rather than a fingerprinting gap. telefoonboek.nl (also a leading Dutch phone/business directory, Places.nl network) serves the same data with no anti-bot protection. ### FAQ **What data source does this actor use?** It reads the publicly available search-results and business-profile pages on telefoonboek.nl, part of the Places.nl network. No account or API key is needed. **Is this affiliated with telefoonboek.nl or Places.nl?** No. This is an independent, third-party actor that reads publicly accessible pages. **Why do some businesses have no rating, phone, or website?** telefoonboek.nl only shows a rating once a business has received at least one review, and only shows contact details a business itself has claimed and published. Fields with no data are simply omitted from the record rather than shown as empty or null. **What does `isClaimed` mean?** Businesses that haven't verified ownership of their Places.nl listing show a "niet geclaimd" (not claimed) badge; `isClaimed: false` reflects that. Claimed listings tend to have more complete contact information. **Does this actor need a proxy or login?** No — telefoonboek.nl's search and profile pages are served without any anti-bot challenge, so this actor runs entirely on Apify's free plan with no proxy and no credentials. # Actor input Schema ## `mode` (type: `string`): What to fetch: keyword/category search (optionally scoped to a city), or fetch businesses from direct telefoonboek.nl URLs. ## `query` (type: `string`): Business category or free-text keyword to search for (mode=search). Pick a common category, or choose 'Custom keyword' and type your own below. ## `customQuery` (type: `string`): Free-text keyword not in the curated list above, e.g. 'loodgieter' or 'notaris' (mode=search). Takes priority over 'Category or keyword' when set. ## `city` (type: `string`): Restrict search to a Dutch city or town, e.g. 'Amsterdam', 'Rotterdam', 'Utrecht' (mode=search). Leave empty to search all of the Netherlands. Matches telefoonboek.nl's own city-scoped search, which includes nearby surrounding places. ## `businessUrls` (type: `array`): Direct telefoonboek.nl business page URLs to fetch, e.g. https://www.telefoonboek.nl/bedrijven/t2036856/zevenaar/ac-restaurant/. Use the 'sourceUrl' field from search results. ## `minRating` (type: `integer`): Only return businesses rated at least this many stars (1-5). 0 means no minimum. Businesses with no rating are excluded once this is set above 0. ## `requireWebsite` (type: `boolean`): Only return businesses that have a website listed on their telefoonboek.nl profile. ## `requirePhone` (type: `boolean`): Only return businesses that have a visible phone number on their telefoonboek.nl listing. ## `fetchFullDetails` (type: `boolean`): For each result, also visit its business profile page to collect the full Monday-Sunday opening hours, fax number, business description, and list of services (the search-results listing only shows today's hours and none of the other three). Slower -- one extra request per result. ## `maxItems` (type: `integer`): Hard cap on the number of business records to return. ## Actor input object example ```json { "mode": "search", "query": "restaurant", "businessUrls": [], "minRating": 0, "requireWebsite": false, "requirePhone": false, "fetchFullDetails": false, "maxItems": 20 } ``` # Actor output Schema ## `businesses` (type: `string`): Dataset containing all scraped telefoonboek.nl business listings (name, address, phone, website, rating, opening hours, and -- with fetchFullDetails -- description and services). # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "search", "query": "restaurant", "businessUrls": [], "minRating": 0, "requireWebsite": false, "requirePhone": false, "fetchFullDetails": false, "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/telefoonboek-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "search", "query": "restaurant", "businessUrls": [], "minRating": 0, "requireWebsite": False, "requirePhone": False, "fetchFullDetails": False, "maxItems": 20, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/telefoonboek-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "search", "query": "restaurant", "businessUrls": [], "minRating": 0, "requireWebsite": false, "requirePhone": false, "fetchFullDetails": false, "maxItems": 20 }' | apify call crawlerbros/telefoonboek-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/telefoonboek-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Telefoonboek.nl Scraper - Netherlands Business Directory", "description": "Scrape telefoonboek.nl, the Netherlands' leading phone/business directory (Places.nl network). Search by category or keyword, optionally scoped to a city, or fetch businesses by URL. Get names, addresses, phone numbers, websites, ratings, and opening hours.", "version": "1.0", "x-build-id": "SpgzetaLlYzHeCtzO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~telefoonboek-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-telefoonboek-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawlerbros~telefoonboek-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-telefoonboek-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawlerbros~telefoonboek-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-telefoonboek-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byUrls" ], "type": "string", "description": "What to fetch: keyword/category search (optionally scoped to a city), or fetch businesses from direct telefoonboek.nl URLs.", "default": "search" }, "query": { "title": "Category or keyword", "enum": [ "custom", "aannemer", "abn-amro", "advocaat", "aldi", "apotheek", "architect", "autobedrijf", "bakker", "bank", "basisschool", "belastingdienst", "bioscoop", "bouw", "cafe", "camping", "caravan", "casino", "catering", "dating", "dierenarts", "dierenasiel", "dierenpension", "drukkerij", "electromotor", "elektronica", "erotiek", "evenementenhal", "fietsen", "financieel", "fotograaf", "fotografie", "fysiotherapie", "garage", "gemeente", "gemeentehuis", "gereedschap", "glas", "groothandel", "handel", "hotel", "hout", "huisarts", "huisartsen", "hypotheek", "ict", "ijsbaan", "industrie", "ing-bank", "installatiebedrijf", "isolatie", "jachthaven", "jagen", "jeugdzorg", "journalistiek", "jumbo", "juwelier", "kapper", "keuken", "kinderdagverblijf", "kleding", "kringloopwinkel", "kruidvat", "kunst", "lampen", "lease", "leer", "lidl", "lingerie", "loterij", "machines", "makelaar", "mode", "motor", "museum", "naaimachines", "natuurbehoud", "natuurwinkels", "netten-en-touw", "notaris", "occasion", "onderwijs", "onderzoek", "openbaar-vervoer", "opvang", "papier", "parkeergarage", "pensioen", "politie", "politiebureau", "postkantoor", "psycholoog", "rabobank", "rechtbank", "reisbureau", "restaurant", "rijschool", "rubber", "schilder", "schoenen", "speelgoed", "sportschool", "supermarkt", "tandarts", "taxi", "tegels", "theater", "transport", "uitgaan", "uitgeverij", "uitvaart", "universiteit", "uwv", "vakantiehuis", "veiling", "verhuur", "vertaler", "voetbal", "watersport", "websites", "witgoed", "woningbouw", "woningbouwvereniging", "zaalverhuur", "ziekenhuis", "zonnebank", "zorg", "zwembad" ], "type": "string", "description": "Business category or free-text keyword to search for (mode=search). Pick a common category, or choose 'Custom keyword' and type your own below.", "default": "restaurant" }, "customQuery": { "title": "Custom keyword (overrides selection above)", "type": "string", "description": "Free-text keyword not in the curated list above, e.g. 'loodgieter' or 'notaris' (mode=search). Takes priority over 'Category or keyword' when set." }, "city": { "title": "City", "type": "string", "description": "Restrict search to a Dutch city or town, e.g. 'Amsterdam', 'Rotterdam', 'Utrecht' (mode=search). Leave empty to search all of the Netherlands. Matches telefoonboek.nl's own city-scoped search, which includes nearby surrounding places." }, "businessUrls": { "title": "Business URLs (mode=byUrls)", "type": "array", "description": "Direct telefoonboek.nl business page URLs to fetch, e.g. https://www.telefoonboek.nl/bedrijven/t2036856/zevenaar/ac-restaurant/. Use the 'sourceUrl' field from search results.", "items": { "type": "object", "properties": { "url": { "title": "URL", "type": "string", "description": "telefoonboek.nl business page URL." } } }, "default": [] }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Only return businesses rated at least this many stars (1-5). 0 means no minimum. Businesses with no rating are excluded once this is set above 0.", "default": 0 }, "requireWebsite": { "title": "Require website", "type": "boolean", "description": "Only return businesses that have a website listed on their telefoonboek.nl profile.", "default": false }, "requirePhone": { "title": "Require phone number", "type": "boolean", "description": "Only return businesses that have a visible phone number on their telefoonboek.nl listing.", "default": false }, "fetchFullDetails": { "title": "Fetch full weekly opening hours", "type": "boolean", "description": "For each result, also visit its business profile page to collect the full Monday-Sunday opening hours, fax number, business description, and list of services (the search-results listing only shows today's hours and none of the other three). Slower -- one extra request per result.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on the number of business records to return.", "default": 20 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```