Gelbe Seiten Business Search Scraper

Overview

This actor scrapes business listings from Gelbeseiten.de, Germany's primary business directory and phone book. It automates the extraction of company data for B2B sales, market research, or lead generation, turning manual research into structured, automated data collection.

Key Features

• Automated Data Extraction: Systematically scrapes business information from Gelbeseiten.de listing pages.
• Proxy Support: Uses Apify Proxy with configurable residential proxy groups (e.g., RESIDENTIAL and country code DE) to help avoid bot detection.
• Flexible Input: Can scrape from a direct list of URLs or generate URLs using search filters (keyword, location, radius).
• Configurable Limits: Set the maximum number of items to scrape per URL and control retry behavior for failed requests.
• Structured Output: Returns data in a consistent JSON format, ready for integration into databases or CRM systems.

How to Use

Configure the actor via a JSON input. You can run it by providing specific listing page URLs or by defining search parameters.

Input/Output

Input Configuration (JSON):
The actor accepts configuration for two main modes: scraping with direct URLs or generating URLs via search filters.

1. Scrape with URLs:
Provide an array of specific Gelbeseiten.de search result page URLs.

{
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "DE"
  },
  "max_items_per_url": 20,
  "urls": [
    "https://www.gelbeseiten.de/suche/restaurants/berlin",
    "https://www.gelbeseiten.de/suche/suchtmedizin/bundesweit"
  ],
  "ignore_url_failures": true
}

• urls: List of business listing page URLs to scrape.
• ignore_url_failures: If true, the actor continues if a URL fails after max retries.

2. Scrape with Search Filters:
Define keywords and locations to let the actor build the search URLs.

{
  "max_retries_per_url": 2,
  "proxy": { "useApifyProxy": true },
  "max_items_per_url": 20,
  "search": [
    {
      "keyword": "Restaurant",
      "location": "Berlin",
      "radius": 10
    }
  ]
}

• search: An array of objects containing keyword, location, and radius (in km). The actor constructs the appropriate Gelbeseiten.de search URLs from these.

Output:
The actor outputs a dataset of items, where each item is a JSON object containing the scraped details for a single business. Typical fields include company name, address, phone number, website, and other available public details from the listing.

Contact

For issues or questions, contact the developer via My profile.