# Gelbe Seiten Business Details Scraper (`ecomscrape/gelbeseiten-business-details-scraper`) Actor

Gelbeseiten.de Business Details Scraper extracts comprehensive German business data including contacts, ratings, reviews, photos, geo-location and more. Automates research, delivers structured JSON for market analysis, lead generation, competitive intelligence in Germany.

- **URL**: https://apify.com/ecomscrape/gelbeseiten-business-details-scraper.md
- **Developed by:** [ecomscrape](https://apify.com/ecomscrape) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 22 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-usage

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

search# Contact

If you encounter any issues or need to exchange information, please feel free to contact us through the following link:
[My profile](https://apify.com/ecomscrape)

## Guide (English version)

### Gelbeseiten.de Business Details Scraper - Executive Summary

### Introduction

Gelbeseiten.de stands as Germany's most comprehensive yellow pages directory and one of the top 3 online portals in the country, serving as the definitive source for German business information. This powerful platform contains verified contact details for businesses across Germany, making it an invaluable resource for B2B outreach, sales prospecting, and market research. However, manually extracting data from thousands of business listings is time-consuming and inefficient. Our Gelbeseiten.de Business Details Scraper automates this process, allowing you to gather comprehensive business intelligence at scale while maintaining data accuracy and completeness.

### Scraper Overview

The Gelbeseiten.de Business Details Scraper is designed to extract detailed information from individual business pages on Germany's leading directory platform. This tool delivers structured JSON data for market analysis, lead generation, and competitive intelligence specifically focused on the German market. The scraper is particularly valuable for businesses looking to understand the German market landscape, identify potential partners or competitors, or build targeted marketing lists.

Key advantages include automated data collection that eliminates manual copying, structured output formats for easy analysis, and comprehensive data extraction covering all available business details. The tool is ideal for market researchers, sales teams, business development professionals, digital marketing agencies, and companies entering the German market. It's designed to extract all information from Gelbe Seiten listings, including emails, phone numbers, addresses, reviews, and booking information.

### Input and Output Details

Example url 1: https://www.gelbeseiten.de/gsbiz/b74c874f-8e8f-418a-bd9f-81fe1861cbfc

Example url 2: https://www.gelbeseiten.de/gsbiz/1d734db8-be9d-47f4-938e-dbe24c6cd51d

Example url 3: https://www.gelbeseiten.de/gsbiz/7689fa73-c628-4a13-a083-c05a3bcb8f78

Example Screenshot of business information page:

![](https://i.ibb.co/RTSrS048/Screenshot-from-2025-06-26-23-32-24.png)

#### Input Format

The scraper accepts a JSON configuration with three main parameters:

```json
{
  "max_retries_per_url": 2, // Maximum waiting time when accessing the links you provided.
  "proxy": { // Add a proxy to ensure that during the data collection process, you are not detected as a bot.
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL" 
    ],
    "apifyProxyCountry": "SG" // You should choose an Country that coincides with the Country you want to collect data from
  },
  "urls": [ // Links to business detailed pages.
    "https://www.gelbeseiten.de/gsbiz/b74c874f-8e8f-418a-bd9f-81fe1861cbfc",
    "https://www.gelbeseiten.de/gsbiz/7689fa73-c628-4a13-a083-c05a3bcb8f78",
    "https://www.gelbeseiten.de/gsbiz/1d734db8-be9d-47f4-938e-dbe24c6cd51d"
  ]
}
```

**max_retries_per_url**: Specifies the maximum number of retry attempts (recommended: 2-3) when a URL fails to load, ensuring robust data collection even with temporary network issues.

**proxy configuration**: Essential for avoiding bot detection. The residential proxy with country-specific settings (preferably German IPs) ensures natural browsing patterns and higher success rates.

**urls array**: Contains direct links to individual business detail pages on Gelbeseiten.de. These URLs typically follow the format with unique business identifiers.

#### Output Format

You get the output from the Gelbeseiten.de Business Details Scraper stored in a tab. The following is an example of the Information Fields collected after running the Actor.

```json
[ // List of business information
  {
    "id": "https://www.gelbeseiten.de/gsbiz/b74c874f-8e8f-418a-bd9f-81fe1861cbfc",
    "url": "https://www.gelbeseiten.de/gsbiz/b74c874f-8e8f-418a-bd9f-81fe1861cbfc",
    "name": "Ristorante Mjalt",
    "rating": {
      "best_rating": "5",
      "@type": "AggregateRating",
      "rating_value": "5.0",
      "rating_count": 1,
      "worst_rating": "0"
    },
    "business_field": "Gaststätten und Restaurants",
    "email": "info@mjalt.de",
    "phone": "030 44 04 47 43",
    "website": "https://www.mjalt.de",
    "address": {
      "text": "Sredzkistr. 23, 10435 Berlin-Prenzlauer Berg"
    },
    "open_hours": [
      "Mo 12:00-24:00",
      "Di 00:00-01:00",
      "Di 12:00-24:00",
      "Mi 00:00-01:00",
      "Mi 12:00-24:00",
      "Do 00:00-01:00",
      "Do 12:00-24:00",
      "Fr 00:00-01:00",
      "Fr 12:00-24:00",
      "Sa 00:00-01:00",
      "Sa 12:00-24:00",
      "So 00:00-01:00",
      "So 12:00-24:00",
      "Mo 00:00-01:00"
    ],
    "photos": [
      {
        "@type": "ImageObject",
        "url": "https://www.golocal.de/media/396babc598b63f4113bd6bebb4203d3d/ori_cd3fc2dc116be5b8.jpg?utm_campaign=golocal_export&utm_medium=export_bpp&utm_source=alliance"
      },
      {
        "@type": "ImageObject",
        "url": "https://www.golocal.de/media/396babc598b63f4113bd6bebb4203d3d/ori_3e7d289891095fbf.jpg?utm_campaign=golocal_export&utm_medium=export_bpp&utm_source=alliance"
      },
      {
        "@type": "ImageObject",
        "url": "https://www.golocal.de/media/396babc598b63f4113bd6bebb4203d3d/ori_86dc20f06bb806d0.jpg?utm_campaign=golocal_export&utm_medium=export_bpp&utm_source=alliance"
      },
      {
        "@type": "ImageObject",
        "url": "https://www.golocal.de/media/396babc598b63f4113bd6bebb4203d3d/ori_6a7ede7fe510cd07.jpg?utm_campaign=golocal_export&utm_medium=export_bpp&utm_source=alliance"
      }
    ],
    "breadcrumb": [
      {
        "item_list_element": [
          {
            "item": "https://www.gelbeseiten.de",
            "@type": "ListItem",
            "name": "Gelbe Seiten",
            "position": 0
          },
          {
            "item": "https://www.gelbeseiten.de/branchenbuch/branche/restaurant",
            "@type": "ListItem",
            "name": "Restaurant",
            "position": 1
          },
          {
            "item": "https://www.gelbeseiten.de/branchen/restaurant/berlin",
            "@type": "ListItem",
            "name": "Restaurant in Berlin",
            "position": 2
          },
          {
            "item": "https://www.gelbeseiten.de/branchen/restaurant/berlin%20bezirk%20pankow",
            "@type": "ListItem",
            "name": "Restaurant in Berlin Bezirk Pankow",
            "position": 3
          },
          {
            "item": "https://www.gelbeseiten.de/gsbiz/b74c874f-8e8f-418a-bd9f-81fe1861cbfc",
            "@type": "ListItem",
            "name": "Ristorante Mjalt",
            "position": 4
          }
        ],
        "@type": "BreadcrumbList"
      },
      {
        "item_list_element": [
          {
            "item": "https://www.gelbeseiten.de/branchenbuch",
            "@type": "ListItem",
            "name": "Deutschland",
            "position": 0
          },
          {
            "item": "https://www.gelbeseiten.de/branchenbuch/staedte/berlin/berlin/berlin",
            "@type": "ListItem",
            "name": "Berlin",
            "position": 1
          },
          {
            "item": "https://www.gelbeseiten.de/branchenbuch/staedte/berlin/berlin/berlin/bezirk/pankow",
            "@type": "ListItem",
            "name": "Berlin Bezirk Pankow",
            "position": 2
          }
        ],
        "@type": "BreadcrumbList"
      }
    ],
    "geo": {
      "latitude": "52.53856",
      "longitude": "13.416045"
    },
    "review": [
      {
        "date_published": "11.05.2006",
        "@type": "Review",
        "author": {
          "@type": "Person",
          "name": "Besserwisser BenutzerIn"
        },
        "review_body": "Das Lokal ist einfach toll. Schneller Service, gute Einrichtung, offener Pizzaofen mit Holzfeuer, ...",
        "review_rating": {
          "best_rating": "5",
          "@type": "Rating",
          "rating_value": 5,
          "worst_rating": "1"
        }
      }
    ],
    "categories": [
      "LocalBusiness",
      "FoodEstablishment",
      "Restaurant"
    ],
    "date_modified": "2025-06-25"
  }, // ... Many other business details
]
```

The scraper returns comprehensive business data in the following structure:

**ID**: Unique identifier for each business record, enabling easy database management and duplicate prevention.

**URL**: Original source URL of the business listing, allowing for data verification and future reference.

**Name**: Complete business name as registered on the directory, crucial for brand identification and contact purposes.

**Rating**: Customer rating score (typically 1-5 scale), indicating business reputation and customer satisfaction levels for competitive analysis.

**Business Field**: Primary industry category or sector classification, essential for market segmentation and competitor identification.

**Email**: Business email address when available, providing direct contact channel for B2B communication and marketing outreach.

**Phone**: Contact telephone number, enabling immediate business communication and verification of active operations.

**Website**: Official business website URL, offering additional research opportunities and digital presence assessment.

**Address**: Complete physical location including street, city, and postal code, necessary for geographic analysis and local market research.

**Open Hours**: Operating hours and days, valuable for understanding business accessibility and planning customer interactions.

**Photos**: Available business images and visual content, useful for understanding business presentation and marketing materials.

**Breadcrumb**: Navigation path showing business category hierarchy, helping understand market positioning and classification structure.

**Geo**: Geographic coordinates (latitude/longitude), enabling precise location mapping and geographic analysis for territory planning.

**Review**: Customer reviews and testimonials, providing insights into business reputation, service quality, and customer satisfaction patterns.

**Categories**: Multiple business categories and tags, offering detailed market segmentation data for comprehensive competitive analysis.

**Date Modified**: Last update timestamp, indicating data freshness and business activity levels for prioritizing outreach efforts.

### Usage Instructions

Begin by identifying target business URLs from Gelbeseiten.de through their search functionality or category browsing. Configure the input JSON with appropriate retry settings and proxy configuration - always use residential proxies with German IP addresses when possible to avoid detection. Add your target business detail URLs to the urls array, ensuring each URL points to an individual business page rather than search results.

Execute the scraper and monitor the extraction process through the provided logs. The tool handles rate limiting automatically, but consider spacing requests appropriately for large datasets. Common issues include blocked requests (solved by proxy rotation), missing data fields (not all businesses provide complete information), and outdated URLs (some business pages may have changed or been removed).

Best practices include starting with small batches to test configuration, using residential proxies from German IP ranges, implementing delays between requests for large-scale extractions, and regularly validating extracted data against the source pages.

### Benefits and Applications

This scraper significantly reduces manual research time from hours to minutes per business listing. It efficiently gathers essential information such as company names, addresses, phone numbers, email addresses, websites, and categories, providing structured data ready for immediate analysis or import into CRM systems.

Practical applications include building targeted sales prospect lists for the German market, conducting competitive intelligence research to understand market positioning, performing market analysis to identify business opportunities, and generating leads for B2B marketing campaigns. The comprehensive data enables businesses to make informed decisions about market entry, partnership opportunities, and competitive strategies.

The structured output format facilitates easy integration with existing business systems, analytics platforms, and marketing automation tools, maximizing the value of collected intelligence for strategic business development.

### Conclusion

The Gelbeseiten.de Business Details Scraper transforms time-consuming manual research into automated, scalable data collection. By leveraging one of Germany's most comprehensive business directories, you can gather all the information you need in one go. Whether you're entering the German market, researching competitors, or building prospect lists, this tool provides the comprehensive business intelligence necessary for informed decision-making and successful market penetration.

## Einführung (deutsche Version)

### Gelbeseiten.de Business Details Scraper - Zusammenfassung

### Gelbeseiten.de Business Details Scraper – Zusammenfassung für Führungskräfte

### Einführung

Gelbeseiten.de ist Deutschlands umfassendstes Branchenverzeichnis und zählt zu den Top-3-Online-Portalen im Land, wobei es als maßgebliche Quelle für Unternehmensinformationen dient. Diese leistungsstarke Plattform enthält verifizierte Kontaktdaten von Unternehmen in ganz Deutschland und ist damit eine unschätzbare Ressource für B2B-Kaltakquise, Vertriebschancen und Marktforschung. Die manuelle Extraktion von Daten aus tausenden Firmeneinträgen ist jedoch sehr zeitaufwändig und ineffizient. Unser Gelbeseiten.de Business Details Scraper automatisiert diesen Prozess und ermöglicht es Ihnen, umfassende Marktinformationen in großem Umfang zu sammeln, während die Datenqualität und Vollständigkeit erhalten bleiben.

### Überblick über den Scraper

Der Gelbeseiten.de Business Details Scraper ist darauf ausgelegt, Detailinformationen aus einzelnen Unternehmensseiten auf Deutschlands führender Verzeichnisplattform zu extrahieren. Dieses Tool liefert strukturierte JSON-Daten für Marktanalysen, Leadgenerierung und Competitive Intelligence – mit besonderem Fokus auf den deutschen Markt. Der Scraper ist besonders wertvoll für Unternehmen, die die Marktlandschaft in Deutschland verstehen, potenzielle Partner oder Wettbewerber identifizieren oder gezielte Marketinglisten erstellen möchten.

Zu den wichtigsten Vorteilen gehören die automatisierte Datensammlung ohne manuelles Kopieren, strukturierte Ausgabeformate zur einfachen Analyse sowie eine umfassende Extraktion sämtlicher verfügbarer Unternehmensdetails. Das Tool eignet sich ideal für Marktforscher, Vertriebsteams, Business-Development-Profis, Digitalagenturen und Unternehmen, die in den deutschen Markt eintreten möchten. Es ist darauf ausgelegt, alle Informationen aus Gelbe-Seiten-Einträgen – darunter E-Mails, Telefonnummern, Adressen, Bewertungen und Buchungsinformationen – zu erfassen.

### Eingabe- und Ausgabedetails

Beispiel-URL: https://www.gelbeseiten.de/gsbiz/b74c874f-8e8f-418a-bd9f-81fe1861cbfc

Beispiel-Screenshot einer Unternehmensinformationsseite:

![](https://i.ibb.co/RTSrS048/Screenshot-from-2025-06-26-23-32-24.png)

#### Eingabeformat

Der Scraper akzeptiert eine JSON-Konfiguration mit drei Hauptparametern:

```json
{
  "max_retries_per_url": 2, // Maximale Wartezeit beim Zugriff auf die angegebenen Links.
  "proxy": { // Fügen Sie einen Proxy hinzu, um während des Datenerfassungsprozesses nicht als Bot erkannt zu werden.
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "SG" // Es sollte ein Land gewählt werden, das mit dem Zielgebiet der Datensammlung übereinstimmt.
  },
  "urls": [ // Links zu Detailseiten einzelner Unternehmen.
    "https://www.gelbeseiten.de/gsbiz/b74c874f-8e8f-418a-bd9f-81fe1861cbfc"
  ]
}
```

**max_retries_per_url**: Gibt die maximale Anzahl an Wiederholungsversuchen an (empfohlen: 2–3), wenn eine URL nicht geladen werden kann. Dies gewährleistet auch bei temporären Netzwerkproblemen eine zuverlässige Datensammlung.

**Proxy-Konfiguration**: Unverzichtbar, um einer Bot-Erkennung zu entgehen. Die Verwendung eines Residential-Proxys mit landesspezifischen Einstellungen (bevorzugt deutsche IPs) sorgt für ein natürliches Surfverhalten und eine höhere Erfolgsquote.

**urls-Array**: Enthält direkte Links zu einzelnen Unternehmensdetailseiten auf Gelbeseiten.de. Diese URLs folgen in der Regel einem Format mit eindeutigen Unternehmenskennungen.

#### Ausgabeformat

Die Ergebnisse des Gelbeseiten.de Business Details Scraper werden tabellarisch gespeichert. Nachfolgend ein Beispiel der Informationsfelder, die nach der Ausführung des Actors gesammelt werden.

```json
[ // Liste von Produktinformationen
  {
    "id": "https://www.gelbeseiten.de/gsbiz/b74c874f-8e8f-418a-bd9f-81fe1861cbfc",
    "url": "https://www.gelbeseiten.de/gsbiz/b74c874f-8e8f-418a-bd9f-81fe1861cbfc",
    "name": "Ristorante Mjalt",
    "rating": {
      "best_rating": "5",
      "@type": "AggregateRating",
      "rating_value": "5.0",
      "rating_count": 1,
      "worst_rating": "0"
    },
    "business_field": "Gaststätten und Restaurants",
    "email": "info@mjalt.de",
    "phone": "030 44 04 47 43",
    "website": "https://www.mjalt.de",
    "address": {
      "text": "Sredzkistr. 23, 10435 Berlin-Prenzlauer Berg"
    },
    "open_hours": [
      "Mo 12:00-24:00",
      "Di 00:00-01:00",
      "Di 12:00-24:00",
      "Mi 00:00-01:00",
      "Mi 12:00-24:00",
      "Do 00:00-01:00",
      "Do 12:00-24:00",
      "Fr 00:00-01:00",
      "Fr 12:00-24:00",
      "Sa 00:00-01:00",
      "Sa 12:00-24:00",
      "So 00:00-01:00",
      "So 12:00-24:00",
      "Mo 00:00-01:00"
    ],
    "photos": [
      {
        "@type": "ImageObject",
        "url": "https://www.golocal.de/media/396babc598b63f4113bd6bebb4203d3d/ori_cd3fc2dc116be5b8.jpg?utm_campaign=golocal_export&utm_medium=export_bpp&utm_source=alliance"
      },
      {
        "@type": "ImageObject",
        "url": "https://www.golocal.de/media/396babc598b63f4113bd6bebb4203d3d/ori_3e7d289891095fbf.jpg?utm_campaign=golocal_export&utm_medium=export_bpp&utm_source=alliance"
      },
      {
        "@type": "ImageObject",
        "url": "https://www.golocal.de/media/396babc598b63f4113bd6bebb4203d3d/ori_86dc20f06bb806d0.jpg?utm_campaign=golocal_export&utm_medium=export_bpp&utm_source=alliance"
      },
      {
        "@type": "ImageObject",
        "url": "https://www.golocal.de/media/396babc598b63f4113bd6bebb4203d3d/ori_6a7ede7fe510cd07.jpg?utm_campaign=golocal_export&utm_medium=export_bpp&utm_source=alliance"
      }
    ],
    "breadcrumb": [
      {
        "item_list_element": [
          {
            "item": "https://www.gelbeseiten.de",
            "@type": "ListItem",
            "name": "Gelbe Seiten",
            "position": 0
          },
          {
            "item": "https://www.gelbeseiten.de/branchenbuch/branche/restaurant",
            "@type": "ListItem",
            "name": "Restaurant",
            "position": 1
          },
          {
            "item": "https://www.gelbeseiten.de/branchen/restaurant/berlin",
            "@type": "ListItem",
            "name": "Restaurant in Berlin",
            "position": 2
          },
          {
            "item": "https://www.gelbeseiten.de/branchen/restaurant/berlin%20bezirk%20pankow",
            "@type": "ListItem",
            "name": "Restaurant in Berlin Bezirk Pankow",
            "position": 3
          },
          {
            "item": "https://www.gelbeseiten.de/gsbiz/b74c874f-8e8f-418a-bd9f-81fe1861cbfc",
            "@type": "ListItem",
            "name": "Ristorante Mjalt",
            "position": 4
          }
        ],
        "@type": "BreadcrumbList"
      },
      {
        "item_list_element": [
          {
            "item": "https://www.gelbeseiten.de/branchenbuch",
            "@type": "ListItem",
            "name": "Deutschland",
            "position": 0
          },
          {
            "item": "https://www.gelbeseiten.de/branchenbuch/staedte/berlin/berlin/berlin",
            "@type": "ListItem",
            "name": "Berlin",
            "position": 1
          },
          {
            "item": "https://www.gelbeseiten.de/branchenbuch/staedte/berlin/berlin/berlin/bezirk/pankow",
            "@type": "ListItem",
            "name": "Berlin Bezirk Pankow",
            "position": 2
          }
        ],
        "@type": "BreadcrumbList"
      }
    ],
    "geo": {
      "latitude": "52.53856",
      "longitude": "13.416045"
    },
    "review": [
      {
        "date_published": "11.05.2006",
        "@type": "Review",
        "author": {
          "@type": "Person",
          "name": "Besserwisser BenutzerIn"
        },
        "review_body": "Das Lokal ist einfach toll. Schneller Service, gute Einrichtung, offener Pizzaofen mit Holzfeuer, ...",
        "review_rating": {
          "best_rating": "5",
          "@type": "Rating",
          "rating_value": 5,
          "worst_rating": "1"
        }
      }
    ],
    "categories": [
      "LocalBusiness",
      "FoodEstablishment",
      "Restaurant"
    ],
    "date_modified": "2025-06-25"
  }, // ... Viele weitere Produktdetails
]
```

Der Scraper liefert umfassende Firmendaten in folgender Struktur:

**ID**: Eindeutige Kennung für jeden Firmeneintrag, erleichtert das Datenbankmanagement und die Vermeidung von Duplikaten.

**URL**: Original-Quell-URL des Firmeneintrags, ermöglicht Datenüberprüfung und zukünftige Referenzierung.

**Name**: Vollständiger Firmenname wie im Verzeichnis registriert, entscheidend für Markenidentifikation und Kontaktaufnahme.

**Bewertung (Rating)**: Kundenbewertung (in der Regel auf einer Skala von 1–5), zeigt den Ruf und die Kundenzufriedenheit für Wettbewerbsanalysen.

**Branche (Business Field)**: Primäre Branchen- oder Sektorkategorisierung, unerlässlich für Marktsegmentierung und Wettbewerbsidentifikation.

**E-Mail**: Geschäfts-E-Mail-Adresse, sofern vorhanden. Bietet einen direkten Kanal für B2B-Kommunikation und Marketingansprache.

**Telefon**: Kontakttelefonnummer, ermöglicht sofortige Kommunikation und Verifizierung der Geschäftsaktivität.

**Webseite**: Offizielle Unternehmenswebseite, bietet zusätzliche Recherchemöglichkeiten und Bewertung der digitalen Präsenz.

**Adresse**: Vollständiger Standort einschließlich Straße, Stadt und Postleitzahl, wichtig für geografische Analysen und lokale Marktrecherche.

**Öffnungszeiten (Open Hours)**: Betriebszeiten und Tage, wertvoll für das Verständnis der Erreichbarkeit und zur Planung von Kundeninteraktionen.

**Fotos (Photos)**: Verfügbare Geschäfts- und Bildinhalte, nützlich für das Verständnis der Außendarstellung und Marketingmaterialien.

**Breadcrumb**: Navigationspfad zur Anzeige der Kategoriehierarchie, hilft bei der Einordnung und dem Verständnis der Marktpositionierung.

**Geo**: Geografische Koordinaten (Breiten-/Längengrad) für genaue Standortzuordnung und Gebietsanalysen.

**Bewertungen (Review)**: Kundenbewertungen und Erfahrungsberichte, bieten Einblicke in Ruf, Servicequalität und Kundenzufriedenheit.

**Kategorien (Categories)**: Mehrfache Branchentags und Kategorien, liefern detaillierte Segmentierungsdaten für umfassende Wettbewerbsanalysen.

**Datum geändert (Date Modified)**: Zeitpunkt der letzten Aktualisierung, zeigt Datenaktualität und Geschäftstätigkeit für die Priorisierung der Kontaktaufnahme.

### Anleitung zur Nutzung

Beginnen Sie damit, Ziel-Unternehmens-URLs über die Suchfunktion oder die Kategoriennavigation von Gelbeseiten.de zu identifizieren. Konfigurieren Sie das Eingabe-JSON mit passenden Wiederholungs-Settings und Proxy-Konfiguration – verwenden Sie nach Möglichkeit immer Residential-Proxys mit deutschen IP-Adressen, um eine Entdeckung zu vermeiden. Fügen Sie Ihre Ziel-Unternehmensseiten zur urls-Array hinzu und stellen Sie sicher, dass jede URL auf eine individuelle Firmenseite verweist, nicht auf Suchergebnisse.

Führen Sie den Scraper aus und überwachen Sie den Extraktionsprozess über die Protokolle. Das Tool handhabt automatische Ratenbegrenzung (Rate Limiting), bei großen Datensätzen empfiehlt sich dennoch ein angemessenes Abstandhalten zwischen den Anfragen. Häufige Probleme sind blockierte Anfragen (lösbar durch Proxy-Rotation), fehlende Felder (nicht alle Firmen bieten vollständige Infos) oder veraltete Links (einige Einträge wurden geändert oder entfernt).

Best Practices sind kleine Testläufe zur Konfigurationsüberprüfung, die Nutzung von deutschen Residential-Proxys, die Implementierung von Pausen für Large-Scale-Extraktionen sowie die regelmäßige Validierung der extrahierten Daten mit der Ausgangsquelle.

### Vorteile und Anwendungsfälle

Mit diesem Scraper reduzieren Sie die manuelle Recherche von mehreren Stunden auf wenige Minuten pro Firmeneintrag. Sie erhalten effizient alle wichtigen Informationen wie Firmenname, Adresse, Telefonnummer, E-Mail, Website und Kategorien – strukturiert und direkt nutzbar für Analysen oder Import ins CRM-System.

Praktische Anwendungen umfassen den Aufbau gezielter Vertriebslisten für den deutschen Markt, die Durchführung von Wettbewerbsanalysen zur Positionsbestimmung, Marktanalysen zur Identifikation von Geschäftschancen sowie Lead-Generierung für B2B-Marketingkampagnen. Die umfassenden Daten helfen bei fundierten Entscheidungen zu Markteintritt, Partnerschaften und Wettbewerbsstrategien.

Das strukturierte Ausgabeformat erleichtert die direkte Integration in vorhandene Geschäftssysteme, Analyseplattformen und Marketing-Tools und maximiert so den Wert der gewonnenen Informationen für strategische Geschäftsentwicklung.

### Fazit

Der Gelbeseiten.de Business Details Scraper verwandelt aufwendige manuelle Recherchen in eine automatisierte, skalierbare Datenerhebung. Mit einem der umfassendsten deutschen Firmenverzeichnisse als Grundlage gewinnen Sie alle relevanten Informationen auf einen Schlag. Egal, ob Sie den deutschen Markt betreten, Wettbewerber analysieren oder Prospektlisten aufbauen möchten – dieses Tool bietet Ihnen die nötige Marktransparenz und Geschäftsinformationen für fundierte Entscheidungen und erfolgreichen Markteintritt.

## Related Actors

- [**Gelbeseiten.de Business Search Scraper**](https://apify.com/ecomscrape/gelbeseiten-business-search-scraper): Your comprehensive tool for extracting valuable business information from Gelbeseiten extensive directory platform.

## Your feedback

We are always working to improve Actors' performance. So, if you have any technical feedback about Gelbeseiten.de Business Details Scraper or simply found a bug, please create an issue on the Actor's Issues tab in Apify Console.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the Specific Business urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `max_retries_per_url` (type: `integer`):

Limit the number of retries for each URL, If an error occurs during the data scraping process.

## `proxy` (type: `object`):

Select proxies to be used by your scraper.

## Actor input object example

```json
{
  "urls": [
    "https://www.gelbeseiten.de/gsbiz/b74c874f-8e8f-418a-bd9f-81fe1861cbfc"
  ],
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": false
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.gelbeseiten.de/gsbiz/b74c874f-8e8f-418a-bd9f-81fe1861cbfc"
    ],
    "max_retries_per_url": 2,
    "proxy": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("ecomscrape/gelbeseiten-business-details-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://www.gelbeseiten.de/gsbiz/b74c874f-8e8f-418a-bd9f-81fe1861cbfc"],
    "max_retries_per_url": 2,
    "proxy": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("ecomscrape/gelbeseiten-business-details-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://www.gelbeseiten.de/gsbiz/b74c874f-8e8f-418a-bd9f-81fe1861cbfc"
  ],
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": false
  }
}' |
apify call ecomscrape/gelbeseiten-business-details-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ecomscrape/gelbeseiten-business-details-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/BN6GuY8g2N0SA8yWg/builds/oAJWI5zA26IvUTVjb/openapi.json