Gelbe Seiten Scraper

Turn Gelbe Seiten (gelbeseiten.de) into a clean, ready-to-use German business lead and company intelligence dataset.

This actor is built for users who want to extract high-quality business listings from one of Germany’s most comprehensive directories — including emails, phone numbers, addresses, reviews, and rich profile data — in a format that’s immediately usable for analysis, outreach, or automation.

---

🚀 Built for agencies & data workflows

This scraper balances depth and reliability, making it well-suited for agency workflows, market research, and large-scale data collection.

• One listing = one row Each Gelbe Seiten listing is emitted once and deduplicated automatically, so datasets stay clean even across large or repeated runs.

• Rich contact information Emails, phone numbers, websites, addresses, and opening hours are extracted wherever available — ideal for lead generation and enrichment workflows.

• Deep profile extraction In addition to basic listing data, the actor extracts reviews, images, services, industries, FAQs, social links, and optional Booking.com metadata when present.

• No hard page limit The scraper automatically paginates through all available results and stops when the directory is exhausted.

• Built for unattended runs Resilient against malformed data, restarts, and migrations. The actor resumes where it left off and avoids re-scraping the same listing twice.

• Clean exports by default Works out of the box with CSV, Excel, JSON, XML, and Apify’s table view.

---

🎯 Typical use cases

• Local Lead Generation – Build German business lead lists by category and location
• Sales & Marketing – Extract verified contact data for outreach campaigns
• Market & Competitor Research – Analyze industries, services, and customer reviews
• Data Enrichment – Augment existing datasets with addresses, ratings, and business metadata
• Automation Agencies – Feed Gelbe Seiten data directly into pipelines or CRMs

---

⚙️ Input

Parameter	Type	Default	Description
query	string	—	Search term you’d type on Gelbe Seiten (required).
location	string	—	Location to search in (optional). Defaults to all of Germany.
sort	string	—	Sort order (relevance or bewertung). Defaults to Gelbe Seiten behavior.
maxPages	number	—	Maximum number of pages to scrape. If not set, all pages are processed.

Example:

{
  "query": "Elektriker",
  "location": "Berlin"
}

---

📦 Output: rich, structured business data

Each dataset row represents one Gelbe Seiten listing with strongly typed, schema-validated fields. The output is designed to work both as a flat table (for spreadsheets and CRMs) and as a rich nested structure (for integrations and automations).

⭐ Commonly used fields

• name
• email
• phone
• website
• address
• rating, ratingCount
• industries, services
• openingHours

---

📘 Detailed output schema (high-level)

The schema is strictly enforced and stable across runs. Below is a structured overview of the available data groups. All fields are optional unless stated otherwise.

🔹 Core listing

• id, memberId – Stable listing identifiers
• name – Business name
• logoURL – Logo image (if available)
• shortDescription – Short business description
• bestIndustry – Primary industry classification
• highlightLevel, partnerLevel – Gelbe Seiten visibility / partner flags

🔹 Location & contact

• address, googleMapsAddress
• phone, additionalPhoneNumbers
• email
• website
• openingHours

🔹 Ratings & reviews

• rating, ratingCount
• reviews[] – Full review texts, ratings, timestamps, and metadata
• Review reactions, likes, and verification flags

🔹 Business details

• industries, services
• acceptedPaymentMethods
• brands, memberships, languages, accessibility
• menu, faq, brochure
• openPositions

🔹 Media & online presence

• images[] – Images with captions
• socialAccounts[] – Facebook, Instagram, LinkedIn, Google Maps, etc.

🔹 Enrichment & external data

• bookingInfo – Parsed Booking.com widget data (for hotels and similar listings)
• Related listings and cross-references

---

🛡️ Reliability & schema guarantees

• Strongly typed, schema-validated output
• Automatic recovery from transient errors
• Safe to stop and restart without duplicating results
• Continues scraping even if individual fields are missing

If Gelbe Seiten adds or changes fields, the schema is updated accordingly and the actor continues to emit valid, consistent records.

---

👥 Target audience

This scraper is designed for:

• Agencies & Sales Teams – Build German lead lists with rich contact data
• Business Owners – Research competitors or potential partners
• Researchers & Analysts – Analyze industries, locations, and review data
• Journalists – Identify businesses and sources
• Automation Builders – Integrate Gelbe Seiten data into automated workflows

---

💬 Support

Questions, edge cases, or feature requests?

Open a support ticket or attach a failing run log — we’ll take care of it.