Gelbe Seiten Scraper - German Business Directory & Leads

Scrape Gelbe Seiten, the German yellow pages, in bulk. Extract business name, trade, full address, postcode, phone and profile URL for any trade in any German city. B2B lead data at source. No login, no API key.

✨ What this Actor does

• Build a B2B prospect list for a trade in a German city, with phone numbers.
• Size a local market by counting registered businesses per trade.
• Enrich a CRM with verified addresses and postcodes.
• Find businesses in a trade that have no website yet.

🚀 Quick start

1. Fill in the input below — the example is already prefilled, so you can just press Start.
2. Watch the log: it names every source it reaches and how many rows each returned.
3. Export from the Storage tab as JSON, CSV, Excel or feed it straight into your own tools.

📥 Input

{
  "queries": [
    "Zahnarzt",
    "Friseur"
  ],
  "cities": [
    "Berlin",
    "Hamburg"
  ],
  "maxItems": 500
}

Every field is documented in the input form. Nothing here needs an API key or a login.

📤 Output

One row per record, with these columns:

Field	Type	Description
name	string	Registered trading name.
trade	string	Primary trade category.
address	string	Street address as published.
postalCode	string	German five-digit postcode.
city	string	City searched.
phone	string	Contact number where published.
openingStatus	string	Whether the business is open now, as shown in the results.
website	string	Business website where published.
rating	number	Average rating where published.
participantId	string	Gelbe Seiten' internal participant number.
realId	string	Stable identifier of the directory record.
profileUrl	string	Public directory page for the business.
query	string	Trade searched for this row.
page	number	Result page the row came from.
scrapedAt	string	When this row was collected.

A column that is empty means the source did not publish that value for that record — it is never a silent substitute for zero or for "unknown".

❓ Frequently asked questions

Do I need an API key or an account? No. This Actor reads a public feed.

What happens if the source blocks the run? A refused exit IP is replaced within a quarter of a second, up to five times, before the Actor tries anything else. If nothing gets through, the run fails with the reason — it never reports success with zero rows, because "there is no such data" and "the source would not answer" are very different answers and you should not have to guess which one you got.

How do I schedule this? Use the Schedules tab. Daily is usually enough; the sources here do not change by the minute.

Can I get the results into Google Sheets or a database? Yes — use the dataset export, or the Apify API and integrations. Every run writes a SUMMARY record to the key-value store with the outcome and counts, which is handy for monitoring an automated pipeline.

💰 Pricing

Pay per result. You are charged for the rows you receive and nothing else, so a run that finds nothing costs nothing.

⚖️ Legal

This Actor collects publicly available information only. It does not log in, does not bypass access controls, and collects no private data. You are responsible for using the output in line with the source's terms and with applicable law, including GDPR where personal data is involved.

⭐ Support

Found something wrong, or want a field that is not here? Open an issue on the Actor's page — include the run ID and I will look at it.

📝 Changelog

2026-09-25

• First release.