Herold Business Listing Scraper

Scrapes business listings from Herold.at (Austrian Yellow Pages) using a search URL. It handles pagination automatically and extracts detailed company data.

Overview

This actor takes a Herold.at search URL, navigates through all result pages, and collects structured information for each business listing. It's designed for lead generation and data extraction from the Austrian market.

Key Features

• URL-based scraping: Provide a full search URL from Herold.at to target specific categories and locations.
• Automatic pagination: Crawls through all pages of results until finished or a custom limit is reached.
• Comprehensive data extraction: Captures a wide range of details for each company.
• Smart deduplication: Filters out duplicate listings from the results.
• Proxy support: Optional proxy configuration can be supplied for the scrape.

How to Use

1. Go to Herold.at and use the site's search/filters to find the businesses you want (e.g., Elektriker in Wien).
2. Copy the complete URL from your browser's address bar.
3. Paste this URL into the actor's searchUrl input 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/

Input

Configure the actor using these input parameters:

Output

The actor outputs a dataset where each item is a JSON object representing one business listing. Extracted fields include:

• Metadata: searchUrl, position, identifier, scrapedAt
• Company Info: name, description, companyUrl, logo, verified
• Contact: phone, email, website
• Address: streetAddress, postalCode, addressRegion, addressCountry, fullAddress
• Ratings: ratingValue, ratingCount, bestRating, worstRating
• Status: openStatus

Example Output Item:

{
  "searchUrl": "https://www.herold.at/gelbe-seiten/burgenland/elektriker/",
  "position": "1",
  "name": "Ing. Franz Gartner",
  "identifier": "5NtMv",
  "description": "Elektroinstallationen, Infrarot- und Elektroheizungen, Klimaanlagen...",
  "companyUrl": "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",
  "streetAddress": "Apetlonerstraße 19",
  "postalCode": "7142",
  "addressRegion": "Illmitz",
  "addressCountry": "AT",
  "ratingValue": "5.0",
  "ratingCount": "3",
  "openStatus": "Jetzt geöffnet",
  "verified": true,
  "scrapedAt": "2023-10-26T10:30:00.000Z"
}