Das Telefonbuch Scraper

Scrape business and person listings from Das Telefonbuch, Germany's official phone directory covering millions of businesses and residents.

Features

• Keyword + location search — Find businesses or residents by type and city
• Business & person search — Toggle via searchType (business or person)
• Pagination — Automatically crawls multiple result pages, follows the site's own rel="next" link for robustness
• Pay-per-result pricing — Only pay for what you scrape

Use with AI Agents (MCP)

Connect this actor to any MCP-compatible AI client — Claude Desktop, Claude.ai, Cursor, VS Code, LangChain, LlamaIndex, or custom agents.

Apify MCP server URL:

https://mcp.apify.com?tools=santamaria-automations/telefonbuch-de-scraper

Example prompt once connected:

"Use telefonbuch-de-scraper to scrape company data from telefonbuch de. Return results as a table."

Clients that support dynamic tool discovery (Claude.ai, VS Code) will receive the full input schema automatically via add-actor.

Output Fields

Every result includes these fields:

Field	Type	Description
company_logo_url	string	Real business logo from Das Telefonbuch's CDN (ies.v4all.de), never a generic placeholder
name	string	Unique business or person name (taken from <h1 itemprop="name">, never the site's generic "Das Telefonbuch" org block)
description	string	The business's own "Unternehmensprofil" text. Only present for listings that have a premium profile (roughly 5-10% of entries); otherwise null. Requires detail pages
address	string	Full formatted address
street	string	Street line incl. house number
postal_code	string	5-digit German postal code
city	string	City
country	string	Always DE
phone	string	Full phone number (never truncated)
fax	string	Full fax number (never truncated)
mobile	string	Mobile number (015x/016x/017x) when the listing publishes one, which is rare (about 3%); otherwise null. Requires detail pages
email	string	Email address shown on the listing. Only on detail pages, so empty when detail pages are switched off
website	string	Official business website
category	string	Business category, with the redundant Branche: prefix stripped
opening_hours	string	Full weekly schedule when available (e.g. Mo 08:00-18:00; Tu 08:00-18:00; ...)
rating	number	Aggregate star rating (0–5)
review_count	number	Total number of reviews across all sources
search_keywords	string[]	Keywords from the "Unsere Suchbegriffe" section
external_review_sources	object[]	Per-source breakdown with source, rating, count, url (Google, Yelp, 11880, golocal, TripAdvisor, anwalt.de, kennstdueinen.de, speisekarte.de, jameda, …)
recent_reviews	object[]	Individual review entries with source, rating, author, date, text, url
services	string[]	Services listed under "Dienstleistungen" (detail pages)
categories	string[]	All industry headings (Branchen) of the listing
district	string	City district (Stadtteil), detail pages
latitude / longitude	number	Coordinates of the listing, detail pages
is_premium	boolean	true for paid Premium listings
entry_id	string	Das Telefonbuch entry id
last_updated	string	Date the publisher last updated the listing (YYYY-MM-DD), detail pages
updated_at	string	Same date as last_updated, ISO YYYY-MM-DD (detail pages)
updated_at_text	string	Raw "Aktualisiert am ..." text as shown on the page (detail pages)
contact_persons	object[]	Persons / further entries under "Weitere Einträge und Filialen", each with name, title, phone, email, address (their own direct contact data as published; empty list when the page has none; detail pages)
source_url	string	Original detail page URL
source_platform	string	Always dastelefonbuch.de
search_type	string	business or person
scraped_at	string	ISO-8601 UTC timestamp

Output Example

{
  "company_logo_url": "https://ies.v4all.de/0122/TB/1126/3/4393/6914393_210x130.png",
  "name": "Spieß Doreen Rechtsanwältin und Fachanwältin für Verkehrsrecht",
  "address": "Grünstr. 15, 12555 Berlin",
  "street": "Grünstr.",
  "postal_code": "12555",
  "city": "Berlin",
  "country": "DE",
  "phone": "030 65 49 77 78",
  "fax": null,
  "email": "kanzlei@ra-spiess.de",
  "website": "http://www.ra-spiess.de",
  "category": "Rechtsanwälte Berlin",
  "opening_hours": "Mo 08:00-18:00; Tu 08:00-18:00; We 08:00-18:00; Th 08:00-18:00; Fr 08:00-18:00",
  "rating": 5.0,
  "review_count": 183,
  "search_keywords": [
    "Verkehrsrecht", "Bußgeld", "Arbeitsrecht", "Familienrecht", "..."
  ],
  "external_review_sources": [
    { "source": "golocal", "rating": 5.0, "count": 56, "url": "https://www.golocal.de/berlin/..." },
    { "source": "anwalt.de", "rating": 5.0, "count": 123, "url": "https://www.anwalt.de/..." },
    { "source": "google", "rating": 4.7, "count": 7, "url": "https://www.google.de/maps/..." }
  ],
  "recent_reviews": [
    {
      "source": "golocal",
      "rating": 5.0,
      "author": "H. Burzlaff",
      "date": "15.03.2026",
      "text": "Vielen Dank an Frau Spieß und Ihr Team. Sie hat mich nach einem Verkehrsunfall kompetent begleitet.",
      "url": "https://www.golocal.de/berlin/..."
    }
  ],
  "services": ["Rechtsanwalt", "Rechtsanwälte: Arbeitsrecht (Fachanwälte)"],
  "categories": ["Rechtsanwälte: Arbeitsrecht (Fachanwälte)", "Rechtsanwälte"],
  "district": "Steglitz",
  "latitude": 52.45918,
  "longitude": 13.320876,
  "is_premium": true,
  "entry_id": "0001131688431",
  "last_updated": "2026-10-01",
  "updated_at": "2026-10-01",
  "updated_at_text": "Aktualisiert am 01.10.2026",
  "contact_persons": [
    { "name": "Geissen Dieter Dipl.-Kfm.", "title": "Dipl.-Kfm.", "phone": "089 9 82 85 18", "email": "kanzlei@limmer-geissen.de", "address": null }
  ],
  "source_url": "https://adresse.dastelefonbuch.de/Berlin/1-Rechtsanwaelte-Doreen-Spiess-Berlin-Gruenstr.html",
  "source_platform": "dastelefonbuch.de",
  "search_type": "business",
  "scraped_at": "2026-04-10T05:13:01Z"
}

Input Parameters

Parameter	Type	Description	Default
searchQuery	string	Search keyword (e.g., "Steuerberater", "Müller")	Required
location	string	City or region (e.g., "Frankfurt", "Berlin")	Required
searchType	string	business or person	business
maxResults	number	Maximum results to return	100
includeDetails	boolean	Fetch detail pages for full profiles	true

How to use

Business search (Branchensuche):

{
  "searchQuery": "Steuerberater",
  "location": "Frankfurt",
  "searchType": "business",
  "maxResults": 100,
  "includeDetails": true
}

Person search (residential phone book), search results only:

{
  "searchQuery": "Müller",
  "location": "Hamburg",
  "searchType": "person",
  "maxResults": 50,
  "includeDetails": false
}

Pricing

Event	Price
Actor start	$0.001
Search result (SERP only)	$0.002 / result
Detail result (with full profile)	$0.005 / result

FAQ

Do I need a proxy or a login? No. The actor uses its own Apify proxy and the source pages are public, so you do not configure anything.

How many results can I get? Set maxResults between 1 and 5000. The actor follows the site's result pagination until the limit or the last page is reached.

What is the difference between search results and detail results? With includeDetails off you get the data shown in the result list (billed as a search result). With it on, each listing's detail page is fetched for email, opening hours, reviews and the company profile (billed as a detail result).

Can I search for private persons? Yes, set searchType to person. See the data protection section below before using such data.

How fresh is the data? Every run reads the live site, so results reflect what Das Telefonbuch shows at that moment (see scraped_at).

Data protection

This actor returns only data that is publicly visible on the source pages. Results can include personal data, such as names, phone numbers, email addresses and addresses of private persons, sole traders or contact persons. Where the source labels an entry type, it is included so you can filter the results yourself.

You are responsible for using the data lawfully, including the GDPR/DSGVO, national data-protection laws and unfair-competition rules (e.g. UWG) for marketing and outreach.

Issues & Feedback

Facing an issue, or missing a feature or data field? Open an issue on the Issues tab — we respond quickly and ship fixes fast.

---

Related Actors

If you scrape DACH business directories, you may also want:

• GoYellow.de Scraper — German business directory with reviews
• 11880.com Scraper — German business directory with reviews
• Gelbe Seiten Scraper — German Yellow Pages
• Das Örtliche Scraper — Local German directory
• Herold.at Scraper — Austrian Yellow Pages
• search.ch Scraper — Swiss business directory
• Google Maps Scraper — Local business intelligence
• Website Contact Extractor — Enrich any website with contact data

Or browse all santamaria-automations actors for the full DACH + European scraping suite.