Gelbe Seiten Leads Scraper

This Apify actor extracts business listings from Gelbe Seiten (the German Yellow Pages). It navigates through search result pages, collects all detail page URLs, and then extracts structured business information including contact details, categories, ratings, and geo‑coordinates.

What does Gelbe Seiten Leads Scraper do?

Gelbe Seiten Leads Scraper lets you extract structured business data from gelbeseiten.de at scale — no coding required. Simply provide one or more search result URLs (e.g. https://www.gelbeseiten.de/suche/restaurants/berlin) and the actor will automatically paginate through all results, visit each business profile, and return clean, structured data ready for export or integration.

All extracted data is available via the Apify API, can be scheduled to run on a recurring basis, integrated with thousands of tools via webhooks or Zapier, and exported in JSON, CSV, or Excel — all from the Apify platform.

Why use Gelbe Seiten Leads Scraper?

• Lead generation — Build targeted B2B lead lists by industry and region. Extract business names, phone numbers, websites, and addresses in bulk.
• Market research — Analyse business density, categories, and ratings across German cities and regions.
• CRM enrichment — Verify and enrich existing contact records with up-to-date addresses, phones, and websites from Gelbe Seiten.
• Competitor analysis — Map competitors in a specific niche and location by scraping category pages.
• Directory aggregation — Combine Gelbe Seiten data with other sources to build comprehensive local business databases.
• Academic and journalism research — Study the distribution of businesses across German regions.

How to use Gelbe Seiten Leads Scraper

1. Go to Gelbe Seiten and run a search (e.g. "Restaurants in Berlin").
2. Copy the URL of the search results page.
3. Open this actor in the Apify Console and click Try for free.
4. Paste the URL(s) into the Start URLs field.
5. Optionally set Max Results to cap the number of businesses extracted.
6. Click Start and wait for the run to finish.
7. Download your data in JSON, CSV, or Excel from the Output tab.

Input

The actor accepts a JSON object. You must provide at least one start URL.

Field	Type	Description
startUrls	Array of strings or objects	The initial Gelbe Seiten search result pages (listing pages) to begin scraping. Each entry can be a simple string URL or an object with a url property. Example: "https://www.gelbeseiten.de/suche/schulen/wuppertal"
maxResults	Number (optional)	Maximum number of business detail pages to extract. If omitted or set to null, the actor will scrape all available results.
proxyConfiguration	Object (optional)	Proxy settings for large scraping jobs. See the Proxy section below.

Example Input

{
    "startUrls": [
        "https://www.gelbeseiten.de/suche/schulen/wuppertal",
        "https://www.gelbeseiten.de/suche/restaurants/berlin"
    ],
    "maxResults": 200
}

Output

The actor produces a dataset where each item represents one business. The Overview tab shows the key fields (URL, name, address, phone, website). Click All fields in the Output tab to view the full record including categories, coordinates, rating, rating count, and last updated date.

Output Fields

Field	Type	Description
url	string	The full URL of the business detail page
id	string	Internal Gelbe Seiten ID (data-teilnehmerid)
name	string	Business name
address	string	Full street address (street + number, postal code, city)
phone	string	Phone number (as shown on the page)
website	string	Official website URL (null if not listed)
categories	array of strings	Business categories (e.g. ["Schulen", "Berufsbildende Schulen"])
coordinates	object	Latitude and longitude (null if unavailable) – { lat, lng }
rating	number	Average star rating (e.g. 4.5; null if no reviews)
ratingCount	number	Number of reviews (null if no reviews)
lastUpdated	string	ISO date when the business information was last modified (null if unavailable)

Fields unavailable on a page are included with a null value so every record has a consistent structure.

Example Output (JSON)

{
    "url": "https://www.gelbeseiten.de/gsbiz/6a2b5da6-cf68-4fe3-bc3d-6fab868a7dab",
    "id": "161096212181",
    "name": "Cosmetic College Bochum Inh. Claudia Bryjak",
    "address": "Gerberstr. 18-20, 44787 Bochum-Innenstadt",
    "phone": "0234 5 86 26 28",
    "website": "https://cosmetic-college-bochum-und-institut.de/",
    "categories": ["BERUFSBILDENDE SCHULEN"],
    "coordinates": {
        "lat": 51.483383,
        "lng": 7.2195573
    },
    "rating": "4.9",
    "ratingCount": 19,
    "lastUpdated": "2026-05-04"
}

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel from the Output tab after the run completes.

Proxy configuration

For large scraping jobs (hundreds or thousands of businesses), using a proxy is strongly recommended. Gelbe Seiten may rate-limit or block repeated requests from a single IP address.

Recommended setup

Enable Apify Proxy in the actor's Input tab under Proxy configuration:

{
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

• Datacenter proxies — Suitable for moderate-scale runs (up to a few hundred pages). Faster and cheaper, but more likely to be blocked on aggressive scraping.
• Residential proxies — Best for large-scale runs or when datacenter proxies get blocked. Rotate through real residential IPs to stay under the radar.

Tips for large runs

• Set maxConcurrency lower (e.g. 3–5) when using residential proxies to avoid burning through proxy quota.
• Add a short delay between requests if you notice failures — the actor uses Playwright which already respects Apify's built-in retry and backoff strategies.
• Split very large searches (e.g. all of Germany for a broad category) into smaller regional runs to distribute load.

Tips and advanced options

• Pagination is automatic — The actor follows "next page" links on listing pages, so you do not need to provide paginated URLs manually.
• Cap results with maxResults — Set this to a small number (e.g. 10) during testing to avoid burning compute units while you verify the output format.
• Multiple start URLs — Pass multiple search result URLs (different categories or cities) in one run to combine them into a single dataset.
• Scheduling — Use Apify's built-in scheduler to refresh your dataset weekly or monthly.

FAQ and disclaimers

Is scraping Gelbe Seiten legal? This actor collects publicly available business information. It is your responsibility to ensure your use of the data complies with Gelbe Seiten's Terms of Service, applicable data protection laws (including GDPR), and your local regulations. Do not use this tool to collect personal data for unsolicited marketing without a lawful basis.

Some fields are missing from the output — why? Not all business profiles on Gelbe Seiten have complete information. Fields like rating, ratingCount, website, and coordinates are only available when the business has provided them. Missing fields appear as null in the output.

The run seems slow — how can I speed it up? The actor uses a browser-based crawler (Playwright) because Gelbe Seiten renders content dynamically. Browser crawlers are inherently slower than HTTP-only crawlers. Increasing concurrency slightly (up to 3–5) can help, but going higher risks rate limiting.

More leads scrapers by Parsedom

Looking for leads from other platforms? Check out our other scrapers:

Actor	Description
Hipages Lead Scraper	Extract business leads from Hipages, Australia's leading trade services directory
Branchenbuch Leads Scraper	Scrape business listings from Branchenbuch, another major German business directory
Booksy Leads Scraper	Extract salon, spa, and beauty business leads from Booksy

Custom actor development

Need a scraper for a platform not listed above? We build custom Apify actors tailored to your specific requirements — any website, any data structure, any scale.

Whether you need a one-off extraction or a fully automated recurring pipeline, we can design and deliver a production-ready actor for you. Get in touch to discuss your project.

🤝 Support

Need help or have questions?

• 📧 Email us at info@parsedom.com
• 🌐 Visit us at parsedom.com
• 💼 Find us on Fiverr: fiverr.com/s/rEmNqEb
• 🤖 Apify expert page: https://apify.com/partners/find/parsedom-inc

You can also contact us if you want to build a custom actor.

---

Ready to generate quality leads from Gelbe Seiten? Add your target URLs and start scraping! 🚀