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

{
  "mode": "search",
  "query": "restaurant",
  "city": "Amsterdam",
  "maxItems": 20
}

Example: highly-rated plumbers nationwide, with full weekly hours

{
  "mode": "search",
  "customQuery": "loodgieter",
  "minRating": 4,
  "fetchFullDetails": true,
  "maxItems": 30
}

Example: dentists with a website and phone number

{
  "mode": "search",
  "query": "tandarts",
  "requireWebsite": true,
  "requirePhone": true,
  "maxItems": 50
}

Example: fetch specific businesses by URL

{
  "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.