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: json { "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.