Germany Business Email Finder — Gelbe Seiten, MX-Checked

Give it a category and a city (for example zahnarzt in berlin). It reads the public Gelbe Seiten (gelbeseiten.de) result pages and returns one row per business: name, address, phone, website and an email, with the email's domain MX-checked.

Plain HTTP only. No browser, no proxy, no login, no accounts or cookies. Logged-out public pages only.

Price: $0.004 per lead with an MX-checked email (plus $0.001 per run start). Rows without an email, with an email whose domain has no MX records, repeated emails and error rows are returned but not charged.

How it works

1. Opens the public Gelbe Seiten list for your category and city and pages through it, politely (about one request per second).
2. Takes the email from the list entry or from the business's detail page (the contact mailto: link).
3. If Gelbe Seiten has no email for a business but lists its website, it opens the homepage and the Impressum / Kontakt page and looks for an address there.
4. Checks the email's domain for MX records (MX check = asking the domain whether it can receive mail).

What "MX-checked" means (and does not mean)

emailStatus is one of:

Value	Meaning
mx-ok	The email's domain has mail (MX) records.
no-mx	The domain has no MX records.
none	No email was found for this business.

An MX check does not prove the mailbox exists or that a message will arrive. Treat the list like any scraped list: send in small batches and watch your own bounce rate.

Input

Field	What it does
category	German category word as on gelbeseiten.de: zahnarzt, rechtsanwalt, steuerberater, friseur, elektriker …
city	German city: berlin, hamburg, münchen (or muenchen), frankfurt am main …
maxResults	Businesses per search, 1 to 500 (default 25).
searches	Optional list for several searches in one run: [{"category":"zahnarzt","city":"berlin","maxResults":50}, ...]. Up to 50 searches and 2,000 businesses per run. When filled, category/city are ignored.
onlyWithEmail	Drop businesses with no email (default off).

If a category/city pair does not exist on Gelbe Seiten you get one row with an error field explaining it; nothing is charged.

Example

Input: {"category":"zahnarzt","city":"berlin","maxResults":5}

{
  "name": "Zahnarztpraxis Petra Hartmann",
  "category": "Zahnärzte",
  "email": "info@zahnaerztin-neukoelln.de",
  "emailStatus": "mx-ok",
  "emailSource": "directory-listing",
  "phone": "030 6 24 31 33",
  "address": "Friedelstr. 14, 12047 Berlin (Neukölln)",
  "website": "https://www.zahnaerztin-neukoelln.de",
  "city": "Berlin",
  "postalCode": "12047",
  "detailUrl": "https://www.gelbeseiten.de/gsbiz/5f06ccb6-068f-4b36-91a4-63113f066676",
  "searchCategory": "zahnarzt",
  "searchCity": "berlin",
  "collectedAt": "2026-10-06"
}

emailSource tells you where the address came from: directory-listing, directory-detail or website.

Limits

• Not every business publishes an email. In a 65-business test (zahnarzt, Berlin) 57 had an MX-ok email; other categories and cities will differ.
• Only what Gelbe Seiten shows publicly is returned. Gelbe Seiten decides how many results a category/city search exposes.
• Gelbe Seiten may slow down or block heavy use. If it does, the run stops that search, returns an error row and keeps the rows already collected.
• Phone numbers and addresses are returned as printed in the directory.

Data protection (GDPR)

This Actor returns business contact data that businesses published in a public directory. It is a data collection tool, not legal advice. You are responsible for how you use the data, including whether and how you may contact a given business under GDPR, the German UWG (unfair competition law) and any other rules that apply to your outreach. Check the rules for your own use case before you send anything.

Related actors

UAE, UK and USA Business Email Finder, and Bulk Email Verifier, from the same publisher.