Gelbeseiten Scraper: German B2B Leads with Phone, Email and Address

Turn a Gelbeseiten search into a clean B2B lead list. Give it a business term (Was) and a German location (Wo), like steuerberater in berlin, and you get back each business with its name, full address, phone, email, website and category.

Gelbeseiten.de is Germany's largest business directory. This actor reads the search results, then opens each business's own Gelbeseiten page to pull the contact data, phone and email, that is not on the results list. Everything comes back as flat JSON, one record per business, ready for a CRM or a cold-outreach list.

No browser and no login. Requests run through Apify Residential pinned to Germany by default, because the site serves German content and rate-limits by IP; that proxy usage is billed to your run at Apify cost, with nothing hidden.

What you get per business

Field	Description
name	Business name
street, postalCode, city	Full postal address (PLZ = German postal code)
phone	Phone number. From the business page (E.164, e.g. +491755906782) when available, else the number shown on the results list
email	Email, when the business published one on its Gelbeseiten profile (see the note below)
website	The business's own website
category	Gelbeseiten category (Branche), e.g. Steuerberatung
detailUrl, gelbeseitenId	The Gelbeseiten page and the internal id
hasPhone, hasEmail	Flags so you can filter for records that carry a contact
was, wo	The search term and location this record answers
scrapedAt	ISO timestamp of the run

Who uses it

• B2B sales and lead-gen teams building prospect lists for a trade in a city.
• Local service agencies looking for businesses in a category to pitch.
• Market research mapping a trade across German cities and districts.
• Agents and data pipelines that need German business contacts as clean JSON.

Input examples

One trade in one city:

{
  "searches": [{ "was": "steuerberater", "wo": "berlin" }],
  "maxResults": 50
}

Several trades and cities at once, results only (faster, no email):

{
  "searches": [
    { "was": "zahnarzt", "wo": "münchen" },
    { "was": "kfz werkstatt", "wo": "10115" }
  ],
  "fetchContactDetails": false,
  "maxResults": 200
}

A string entry works too:

{
  "searches": ["restaurant in hamburg"]
}

About the email field

Emails are not guaranteed. You get an email only when the business itself published one on its Gelbeseiten profile. When there is one, the actor returns it; when there is not, email is blank and hasEmail is false. This is honest directory data, not an appended or guessed address, so coverage is partial and varies by trade and region. The phone number has much higher coverage than the email.

Pricing

You pay per result. Platform usage (compute and the Germany residential proxy) is billed to your run at Apify cost, so there is no subscription and no minimum.

Event	When it fires	Price
listing-found	Each business returned	$1.00 per 1,000
contact-found	An enriched business (detail page opened) that has a phone or an email	$4.00 per 1,000

contact-found is the enrichment charge: it fires only when fetchContactDetails is on and the opened business page yields a usable phone or email, so you pay the contact rate for leads you can act on. A results-only run (fetchContactDetails: false) never triggers it, so it is billed at the listing rate alone.

How it works and its limits

• Search then detail. The actor fetches the /suche/<was>/<wo> page, collects the businesses and their Gelbeseiten page URLs, then opens each page for the email and canonical contact fields. Set fetchContactDetails to false to skip the per-business fetch: you still get name, category, phone, website and address from the results list, with no email. That run does one request per search instead of one per business and is billed at the listing-found rate only (no contact-found), so it is cheaper on both proxy usage and event fees.
• Pagination. The results page shows about 50 businesses out of the total for that search. To go beyond 50, the actor follows Gelbeseiten's own "Mehr Anzeigen" control (its /ajaxsuche continuation), reading the exact paging parameters from the page rather than guessing them, and stops as soon as the site stops returning new results. If you set maxResults to 50 or below, only the first page is fetched.
• Locations. wo can be a city, a district or a postal code. Broad terms return more businesses; narrow ones return fewer but more targeted.

FAQ

Is the email always there? No. See "About the email field" above. Email is published by the business on its own profile, so coverage is partial. Phone coverage is high.

Why a Germany proxy? Gelbeseiten serves German content and rate-limits by IP. Residential pinned to Germany keeps requests clean. You can override or disable the proxy in the input.

How do I get more than 50 businesses for one search? Raise maxResults above 50 and the actor follows the site's "Mehr Anzeigen" pagination until it reaches your cap or the results run out. You can also add more searches entries (other cities or districts).

Can I run it cheaply? Yes. Set fetchContactDetails to false for a results-only run (name, category, phone, website, address, no email). It does one request per search instead of one per business and is billed at the listing-found rate only, with no contact-found charge.

---

Something missing?

If you need an extra field, another source, or a different output, open an issue on this Actor and describe it. I read every request and small additions usually ship within days. More data and lead generation Actors are on my profile.

Gelbe Seiten scraper, Gelbeseiten scraper, German business leads, Firmenadressen scrapen, Branchenbuch scraper, German business emails, B2B leads Germany, German company contacts, Yellow Pages Germany scraper, scrape gelbeseiten.de, Steuerberater Handwerker Zahnarzt leads.