📒 Herold Business Listing Scraper

This actor allows you to scrape business listings from Herold.at (Austrian Yellow Pages) by providing a search URL. It automatically handles pagination and extracts comprehensive company information including contact details, ratings, addresses, and more.

Features

• URL-based Scraping: Extract business listings by providing a complete Herold.at search URL
• Automatic Pagination: Automatically navigates through pages and loads more listings until reaching the end or max items limit
• Comprehensive Company Data: Extract detailed information about each business including:
  • Company name and description
  • Contact information (phone, email, website)
  • Full address details (street, postal code, region)
  • Customer ratings and review counts
  • Business hours status (open/closed)
  • Company logo and branding
  • Verification status
• Smart Deduplication: Automatically removes duplicate listings
• Proxy Support: Optional proxy configuration for enhanced reliability

Input Parameters

Field	Type	Required	Description
searchUrl	string	Yes	Complete Herold.at search URL to scrape
maxItems	integer	No	Maximum number of listings to fetch (default: unlimited)
proxyConfiguration	object	No	Proxy settings for the actor

How to Get Search URL

1. Go to Herold.at
2. Use the search filters to find businesses (category, location, etc.)
3. Copy the complete URL from your browser's address bar
4. Paste it into the searchUrl field

Example search URLs:

https://www.herold.at/gelbe-seiten/burgenland/elektriker/
https://www.herold.at/gelbe-seiten/wien/restaurant/
https://www.herold.at/gelbe-seiten/salzburg/hotel/

Output

The output is a dataset of business listing objects, each containing:

• searchUrl: The original search URL used
• position: Position in search results
• name: Company name
• identifier: Unique company identifier on Herold
• description: Business description and services offered
• companyUrl: Direct link to the company page on Herold
• logo: URL of the company logo
• ratingValue: Average customer rating (e.g., "5.0")
• ratingCount: Number of customer reviews
• bestRating: Maximum possible rating (usually "5")
• worstRating: Minimum possible rating (usually "1")
• openStatus: Current business status (e.g., "Jetzt geöffnet" / "Currently open")
• detailsUrl: URL to detailed company information
• phone: Phone number
• email: Email address
• website: Company website URL
• addressString: Full address as a single string
• streetAddress: Street address
• postalCode: Postal code
• addressRegion: City/Region
• addressCountry: Country code (e.g., "AT" for Austria)
• fullAddress: Complete formatted address
• verified: Whether the business is verified by Herold
• scrapedAt: Timestamp of when the listing was scraped

Example output:

[
  {
    "searchUrl": "https://www.herold.at/gelbe-seiten/burgenland/elektriker/",
    "position": "1",
    "name": "Ing. Franz Gartner",
    "identifier": "5NtMv",
    "description": "Elektroinstallationen, Infrarot- und Elektroheizungen, Klimaanlagen, Photovoltaik, Reparatur und Service, Fachgeschäft",
    "companyUrl": "https://www.herold.at/gelbe-seiten/illmitz/5NtMv/ing-franz-gartner/",
    "logo": "https://a.mktgcdn.com/p/J_M-Aa7zQQbJphjA80Sm_BtmzLk8Edb2YIoOJXFUMjE/300x300.png",
    "ratingValue": "5.0",
    "ratingCount": "3",
    "bestRating": "5",
    "worstRating": "1",
    "postal_text": null,
    "openStatus": "Jetzt geöffnet",
    "detailsUrl": "https://www.herold.at/gelbe-seiten/illmitz/5NtMv/ing-franz-gartner/",
    "phone": "+43 2175 2372",
    "email": "illmitz@elektro-gartner.at",
    "website": "http://www.elektro-gartner.at",
    "addressString": "Apetlonerstraße 19 7142 Illmitz Neusiedl am See Burgenland",
    "streetAddress": "Apetlonerstraße 19",
    "postalCode": "7142",
    "addressRegion": "Illmitz",
    "addressCountry": "AT",
    "fullAddress": "Apetlonerstraße 19 7142 Illmitz Neusiedl am See Burgenland",
    "verified": true,
    "scrapedAt": "2025-11-05T08:46:43.715Z"
  },
  ...
]

Use Cases

• Lead Generation: Find potential business clients in specific industries and regions
• Market Research: Analyze business density and competition in different areas
• Contact Database Building: Create comprehensive contact lists for B2B marketing
• Competitor Analysis: Track competitor locations and customer ratings
• Local SEO Research: Understand local business landscape and opportunities
• Business Intelligence: Gather insights about Austrian business ecosystem
• Directory Building: Create custom business directories and aggregators
• Service Provider Discovery: Find service providers across Austria

Notes

• Works with Austrian businesses listed on Herold.at
• Results are saved incrementally as they are found
• All timestamps are in ISO 8601 format
• Supports all business categories available on Herold
• Handles both German language content and international businesses
• Verification status indicates businesses that have been verified by Herold

Limitations

• Only works with Herold Austria (herold.at)
• Cannot scrape detailed information from individual company detail pages (only listing data)
• Some businesses may have incomplete contact information
• Rating information may not be available for all businesses
• Business hours details are limited to current open/closed status

Tips for Best Results

• Use specific category and location filters for more targeted results
• Set a reasonable maxItems limit to avoid long scraping times
• Check the search results manually first to ensure the URL is correct
• For large datasets, consider splitting into multiple smaller scraping jobs by region or category
• Enable proxy configuration if you encounter rate limiting

---

Start extracting Austrian business data from Herold today!