Gelbe Seiten Scraper

Automate customer-defined searches on Gelbe Seiten (gelbeseiten.de) and return the matching public business listings as clean, structured data.

The Actor lets you choose a search query, location, sorting, and result scope, then processes the matching Gelbe Seiten listings and returns strongly typed records that are easy to use in analysis, enrichment, research, and automation workflows.

Each result retains its source provenance, including a link back to the corresponding Gelbe Seiten listing where available.

---

🚀 Built for structured business research

The Actor is designed for workflows that need reliable, structured access to the results of specific Gelbe Seiten searches.

• Customer-defined searches You decide what to search for, where to search, and how many result pages to process.

• One listing = one row Matching listings are emitted as individual structured records and deduplicated within the run.

• Rich business information Extract available addresses, phone numbers, websites, opening hours, industries, services, ratings, and other public listing metadata.

• Optional detailed profile data Listing detail pages can contain additional information such as social links, FAQs, reviews, media, services, and other profile metadata.

• Source provenance Results retain source information so downstream systems can identify and reference the original Gelbe Seiten listing.

• Designed for unattended runs The Actor handles transient failures, malformed records, restarts, and migrations while avoiding duplicate processing within a run.

• Structured exports Use the resulting dataset directly as JSON, CSV, Excel, XML, or through Apify's table and API interfaces.

---

🎯 Typical use cases

• Business Research – Find companies matching a particular industry, service, or location
• Market Analysis – Analyze business presence across categories or geographic areas
• Company Discovery – Identify businesses relevant to a customer-defined search
• Data Enrichment – Supplement existing company records with publicly listed business information
• Competitive Research – Compare businesses, industries, services, ratings, and locations
• Workflow Automation – Feed structured search results into internal tools, CRMs, analytics pipelines, or other automations

The Actor performs only the searches and result scope requested by the user.

---

⚙️ Input

You control the scope of every run.

Parameter	Type	Description
query	string	Search term corresponding to the Gelbe Seiten Was field. Required.
location	string	Optional geographic search corresponding to the Wo field.
sort	string	Optional result ordering, such as relevance or rating.
maxPages	number	Maximum number of result pages to process for this run.

Example:

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

The Actor processes only the result pages covered by the parameters supplied for that run.

---

📦 Output

Each dataset item represents one matching Gelbe Seiten listing.

The output schema is strongly typed and designed to support both simple tabular workflows and richer integrations.

⭐ Common fields

• name
• address
• phone
• email
• website
• rating
• ratingCount
• industries
• services
• openingHours
• source / provenance URL

Availability depends on what is publicly present on the corresponding listing.

---

📘 Output structure

🔹 Core listing information

• id, memberId – Listing identifiers
• name – Business or listing name
• logoURL – Logo URL when available
• bestIndustry – Primary industry classification
• shortDescription – Short profile description when available
• highlightLevel, partnerLevel – Listing metadata exposed by Gelbe Seiten

🔹 Location and contact information

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

🔹 Ratings and reviews

Where available:

• rating
• ratingCount
• reviews[]

Review records can contain text, ratings, timestamps, and associated metadata depending on the source listing.

🔹 Business details

Depending on the listing:

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

🔹 Media and online presence

Where exposed by the source listing:

• images[]
• socialAccounts[]

Supported account types can include Facebook, Instagram, LinkedIn, YouTube, Google Maps, TikTok, X/Twitter, Xing, and others.

🔹 Additional metadata

Some listings expose additional structured information such as:

• company information
• commercial-register information
• managing directors
• employee information
• awards and certificates
• target groups
• service areas
• references
• related listings

Hotel and accommodation listings may additionally contain parsed Booking.com-related metadata when present.

🔹 Provenance

Where available, each record includes provenance linking it back to the corresponding source listing.

This makes it easier to:

• verify individual records against their source;
• preserve source attribution in downstream systems;
• revisit the original listing when more context is needed; and
• distinguish extracted source information from later enrichment performed by your own workflow.

---

🛡️ Reliability and schema guarantees

The Actor is built around a stable, validated output schema.

• Strongly typed output
• Schema validation before records are emitted
• Graceful handling of missing optional fields
• Automatic handling of transient request failures
• Run-level deduplication
• Restart and migration support

Because individual Gelbe Seiten profiles differ substantially, optional fields may not be present for every listing.

When the source structure changes, the Actor is updated to continue producing consistent records where possible.

---

👥 Intended users

The Actor is suitable for:

• Researchers and Analysts – Structured company and market research
• Agencies – Customer-specific business discovery and enrichment workflows
• Sales Operations Teams – Research businesses matching defined criteria
• Business Owners – Research markets, suppliers, competitors, or partners
• Journalists – Identify relevant businesses and potential sources
• Automation Builders – Integrate customer-defined business searches into larger workflows

---

⚖️ Responsible use

This Actor provides software for automating user-defined queries against publicly accessible information.

Users are responsible for ensuring that their particular use of the Actor and resulting data complies with applicable laws, contractual obligations, and third-party rights.

Avoid using the Actor to access content that requires authentication or other access controls.

---

💬 Support

Questions, edge cases, or unexpected results?

Open a support ticket and include the affected run ID or relevant log output so the issue can be reproduced and investigated.