🏢 Gelbeseiten Search Scraper This actor allows you to scrape business listings from Gelbeseiten.de by providing a search URL. It automatically handles pagination and extracts comprehensive business information including contact details, ratings, addresses, and operating hours. ## Features - URL-based Scraping: Extract business listings by providing a complete Gelbeseiten.de search URL - Automatic Pagination: Automatically loads more listings until reaching the end or max items limit - Comprehensive Business Data: Extract detailed information about each business including: - Business name and category - Complete address information (street, city, zipcode, district) - Contact details (phone, website, email availability) - Customer ratings and review counts - Operating hours and current status - Business identifiers and detail page URLs - Location Details: Full address breakdown including postal codes and districts - Business Status: Real-time operating hours and availability information ## Input Parameters | Field | Type | Required | Description | |------------|---------|----------|------------------------------------------------| | searchUrl| string | Yes | Complete Gelbeseiten.de search URL to scrape | | maxItems | integer | No | Maximum number of listings to fetch | ## Output The output is a main list of business listing objects, each containing: - searchUrl: The original search URL used - id: Unique identifier for the listing - teilnehmerId: Participant ID - realId: Real ID of the business - name: Business name - detailUrl: URL to the business detail page - category: Business category or industry - address: Street address - zipcode: Postal code - city: City name - district: District name if available - rating: Customer rating score - ratingText: Rating text description - ratingCount: Number of reviews - isOpen: Whether the business is currently open - openStatus: Current operating status - openHint: Operating hours hint (e.g., "Opens at 10:00") - phone: Phone number - phoneUrl: Phone number link - website: Business website URL - hasEmailButton: Whether email contact is available - hasAngebotEinholen: Whether quote request feature is available - scrapedAt: Timestamp of when the listing was scraped Example output: json [ { "searchUrl": "https://www.gelbeseiten.de/suche/wa/bundesweit", "id": "treffer_161000079388", "teilnehmerId": "123456", "realId": "789012", "name": "Example Business GmbH", "detailUrl": "/firma/example-business-gmbh", "category": "Restaurants", "address": "Musterstraße 123", "zipcode": "10115", "city": "Berlin", "district": "Mitte", "rating": "4.5", "ratingText": "4.5 von 5 (123 Bewertungen)", "ratingCount": "123", "isOpen": true, "openStatus": "Geöffnet", "openHint": "Geöffnet bis 22:00", "phone": "+49 30 12345678", "phoneUrl": "tel:+493012345678", "website": "https://www.example-business.de", "hasEmailButton": true, "hasAngebotEinholen": false, "scrapedAt": "2025-01-15T10:30:00.000Z" }, ... ] ## Use Cases - Business directory research and analysis - Local business market intelligence - Competitor analysis and location mapping - Lead generation for B2B services - Customer review and rating analysis - Business contact information collection ## Notes - Results are automatically paginated until reaching the end or max items limit - All business information is extracted from publicly available listings - Operating hours and status are updated in real-time - Contact information availability may vary by listing --- Start exploring German businesses on Gelbeseiten.de today!