🏢 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:

[
  {
    "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!