Das Telefonbuch Business Scraper

Pull structured German business listings from Das Telefonbuch — name, category, phone, website, fully componentized address, star ratings, and opening hours — across many categories and cities in a single run. Search by trade and town, or paste the exact result-page URLs you already built on the site. Built for B2B lead-generation teams, sales prospectors, and market researchers who need clean, contact-ready German SMB data without copy-pasting from directory pages one entry at a time.

Why This Scraper?

• Fully componentized German addresses — every listing splits into streetAddress, postalCode (PLZ), city, and district (Stadtteil) plus the combined address string, so records drop straight into a CRM without post-processing.
• Three contact channels per business — phone (the full, untruncated number, not the shortened on-page version), website, and email (when the business publishes one, via the Include Details option).
• Star ratings with review volume — both ratingValue and ratingCount on every rated listing, so you can rank prospects by reputation and sample size, not just a bare score.
• Opening hours, two ways — a quick openingHoursText summary on every row, plus a full weekly schedule (openingHoursFull) with day-by-day times when Include Details is enabled.
• Cross-product search — every search term is matched against every location, so "Restaurant, Zahnarzt, Friseur" × "Berlin, München, Hamburg" runs all nine combinations in one job.
• Nationwide German coverage — works against any city or area on Das Telefonbuch, Germany's largest phone and business directory.
• Paste-URL mode — drop in result-page URLs straight from your browser to scrape exactly the pre-filtered search you already set up on the site.
• Provenance on every row — searchTerm, searchLocation, position, entryId, detailUrl, pageUrl, and scrapedAt let you trace, dedupe, and refresh records with confidence.

Use Cases

Lead Generation

• Build targeted B2B prospect lists of German businesses by trade and city
• Capture phone, website, and email for direct outreach
• Filter prospects by star rating and review count before contacting

Sales Prospecting

• Map every dentist, restaurant, or law firm in a target metro area
• Prioritize outreach by reputation using rating value and review volume
• Segment territories with postal-code and district-level address data

Market Research

• Measure business density per category across multiple German cities
• Benchmark competitor ratings and review counts in a local market
• Track opening-hours patterns and service availability by area

CRM Enrichment

• Append clean street, PLZ, city, and district fields to existing records
• Verify and update phone numbers and websites at scale
• Add email contacts where businesses publish them

Competitive Analysis

• Compare a competitor's rating and review footprint against the local field
• Identify high-rated incumbents in a category and region
• Monitor new or changing listings on refresh runs

Getting Started

Single category in one city

{
  "searchTerms": ["Restaurant"],
  "locations": ["Berlin"]
}

Cross-product: many categories × many cities

{
  "searchTerms": ["Zahnarzt", "Steuerberater", "Friseur"],
  "locations": ["München", "Hamburg", "Köln"],
  "maxResults": 500
}

Paste exact result-page URLs

{
  "startUrls": [
    "https://www.dastelefonbuch.de/Branchen/Hotel/Frankfurt"
  ],
  "maxResults": 200
}

Full run with email & opening hours

{
  "searchTerms": ["Rechtsanwalt"],
  "locations": ["Stuttgart"],
  "maxResults": 1000,
  "includeDetails": true,
  "maxPagesPerSearch": 0
}

Input Reference

What to Scrape

Parameter	Type	Default	Description
searchTerms	array	["Restaurant"]	Business categories or search terms in German (e.g. Zahnarzt, Steuerberater, Hotel, Friseur). Each term is searched in every location, covering many categories in one run.
locations	array	["Berlin"]	German cities or areas to search (e.g. Berlin, München, Hamburg, Köln). Each location is combined with every search term above.

Or Paste URLs

Parameter	Type	Default	Description
startUrls	array	[]	Paste Das Telefonbuch search or result-page URLs directly from your browser to scrape exactly those results. When provided, the search terms and locations are ignored.

Limits & Extra Details

Parameter	Type	Default	Description
maxResults	integer	100	Hard cap on the total number of business listings collected across all searches. Increase for bigger runs, or set to 0 for no cap (an internal safety limit still applies).
includeDetails	boolean	false	When enabled, opens each business's detail page to add its email address (when published) and the full weekly opening-hours table. Slower, since it fetches one extra page per business.
maxPagesPerSearch	integer	0	Safety valve limiting how many result pages to fetch per individual search (roughly 10 listings per page). Set to 0 for no per-search page limit — only the Maximum Results cap applies.

Output

Each business is one flat row. Example:

{
  "name": "Ristorante Da Mario",
  "category": "Restaurant",
  "phone": "+49 30 12345678",
  "website": "https://www.da-mario-berlin.de",
  "email": "info@da-mario-berlin.de",
  "address": "Kurfürstendamm 12, 10719 Berlin, Wilmersdorf",
  "streetAddress": "Kurfürstendamm 12",
  "postalCode": "10719",
  "city": "Berlin",
  "district": "Wilmersdorf",
  "ratingValue": 4.6,
  "ratingCount": 213,
  "openingHoursText": "Mo–Sa 11:00–23:00",
  "openingHoursFull": "Mo 11:00-23:00; Tu 11:00-23:00; We 11:00-23:00; Th 11:00-23:00; Fr 11:00-23:00; Sa 11:00-23:00",
  "searchTerm": "Restaurant",
  "searchLocation": "Berlin",
  "position": 1,
  "entryId": "a1b2c3d4",
  "detailUrl": "https://adresse.dastelefonbuch.de/Berlin/ristorante-da-mario.html",
  "pageUrl": "https://www.dastelefonbuch.de/Branchen/Restaurant/Berlin",
  "scrapedAt": "2026-06-27T10:32:01Z"
}

Core Fields

Field	Type	Description
name	string	Business name
category	string	Business category / trade (Branche)
ratingValue	number	Average star rating, when rated
ratingCount	number	Number of ratings behind the score

Contact

Field	Type	Description
phone	string	Full phone number (untruncated)
website	string	Business website URL, when listed
email	string	Email address — populated with Include Details, when the business publishes one

Address

Field	Type	Description
address	string	Full combined address string
streetAddress	string	Street and house number
postalCode	string	Postal code (PLZ)
city	string	City
district	string	District / neighborhood (Stadtteil), when present

Opening Hours

Field	Type	Description
openingHoursText	string	Short opening-hours summary, on every row
openingHoursFull	string	Full day-by-day weekly schedule — populated with Include Details

Metadata

Field	Type	Description
searchTerm	string	Search term that produced this row
searchLocation	string	Location that produced this row
position	number	Rank of the listing on its result page
entryId	string	Stable directory entry identifier
detailUrl	string	Link to the business's detail page
pageUrl	string	Result page the listing came from
scrapedAt	string	ISO timestamp of collection

Tips for Best Results

• Always pair a category with at least one city. A search term with no location searches near-me rather than your target town — listing one or more cities in locations keeps results geographically scoped.
• Let cross-product do the heavy lifting. Listing 5 categories and 10 cities runs all 50 combinations automatically — no need to launch 50 separate jobs.
• Turn on Include Details only when you need email or full hours. It fetches an extra page per business, so leave it off for fast core runs (name, category, phone, website, address, ratings) and switch it on for outreach-ready lists.
• Email is sparse by design. Most German businesses don't publish an email in the directory, so expect email to be filled on a minority of records even with Include Details on — phone and website are the reliable contact channels.
• Use Paste-URL mode for refined searches. Build a filtered search on Das Telefonbuch in your browser, then paste the result-page URL into startUrls to scrape exactly that set.
• Rely on Maximum Results, not page limits. For most runs, set maxResults and leave maxPagesPerSearch at 0 — the result cap stops pagination cleanly once your target count is reached.
• Dedupe on entryId when merging multiple runs — it's the stable per-listing key for keeping your dataset clean across refreshes.

Pricing

From $0.03 per 1,000 results — pay only for the business listings you collect, billed per result. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier.

Results	No discount	Bronze	Silver	Gold
100	$0.0036	$0.0034	$0.0032	$0.0030
1,000	$0.036	$0.034	$0.032	$0.030
10,000	$0.36	$0.34	$0.32	$0.30
100,000	$3.60	$3.40	$3.20	$3.00

A "result" is one business listing pushed to your dataset. No compute or time-based charges — you pay per result, plus a small fixed per-run start fee.

Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

• Zapier / Make / n8n — Workflow automation
• Google Sheets — Direct spreadsheet export
• Slack / Email — Notifications on new results
• Webhooks — Trigger custom APIs on run completion
• Apify API — Full programmatic access

Legal & Ethical Use

This actor collects publicly available business directory information. Use the data responsibly and in compliance with Das Telefonbuch's terms of service, applicable data-protection laws (including the GDPR), and any restrictions on contacting businesses or processing personal data. You are responsible for ensuring your use of the collected data is lawful, including obtaining any required consent for marketing outreach. Do not use this actor to collect or process data in ways that violate privacy rights or applicable regulations.