Herold.at Business Directory Scraper

Export Austrian business listings from Herold.at for lead generation, local SEO checks, market mapping, and sales enrichment.

What does Herold.at Business Directory Scraper do?

Herold.at Business Directory Scraper extracts public company listings from the Austrian Herold.at Yellow Pages / Gelbe Seiten website.

It can search by business category and location or scrape ready-made Herold search URLs.

Typical output includes company names, addresses, phone numbers, emails, websites, ratings, profile URLs, snippets, and the source search URL.

Who is it for?

Sales teams

Find Austrian companies in a category and export contact details for prospecting.

Marketing agencies

Build local SEO and outreach lists by city, district, and industry.

Market researchers

Map how many businesses exist in a niche and compare location coverage.

Data enrichment teams

Add phone, email, website, address, and Herold profile links to company databases.

Why use this scraper?

• 🇦🇹 Focused on Austrian local business data.
• 📇 Extracts practical lead fields, not just page titles.
• 🔎 Works from search terms or exact Herold URLs.
• ⚡ Uses HTTP/Cheerio for fast low-cost scraping.
• 🧾 Saves clean tabular data to an Apify dataset.
• 🔁 Follows pagination until your maxItems limit.
• 🧩 Optional profile-page enrichment for deeper records.

Data fields

Field	Description
companyName	Business name shown on Herold.at
category	Category/search term context
phone	Phone number from listing/profile
email	Email address when available
website	External business website
streetAddress	Street and house number
postalCode	Austrian postal code
city	City or region value
region	Full address text
country	Country code
ratingValue	Average rating
ratingCount	Rating count
reviewCount	Review count when present
profileUrl	Herold company profile URL
searchUrl	Herold search result page URL
position	Listing position on the result page
description	Listing snippet
verified	Whether Herold marks the company as verified
branchCode	Herold identifier when available
profileText	Optional profile text with enrichment enabled
scrapedAt	ISO timestamp of extraction

How much does it cost to scrape Herold.at business leads?

This actor uses pay-per-event pricing.

You pay a small run start fee and then a per-business price for each saved listing.

The exact price is shown on the Apify Store pricing panel before you run the actor.

Use a low maxItems value for tests, then increase it for production exports.

How to scrape Herold.at by keyword and location

1. Open the actor on Apify.
2. Enter what, for example restaurant, installateur, or steuerberater.
3. Enter where, for example wien, graz, or salzburg.
4. Set maxItems.
5. Keep includeProfiles disabled for a fast listing export.
6. Start the run.
7. Download the dataset as CSV, JSON, Excel, or via API.

How to scrape Herold.at search URLs

Paste one or more Herold result URLs into startUrls.

Example:

{
  "startUrls": [
    { "url": "https://www.herold.at/gelbe-seiten/wien/restaurant/" }
  ],
  "maxItems": 100,
  "includeProfiles": false
}

Input options

startUrls

Optional list of Herold search result URLs.

Use this when you already created a search on Herold.at and want the actor to continue from that URL.

what

Business category or keyword.

Examples: restaurant, zahnarzt, friseur, installateur, steuerberater.

where

Austrian location.

Examples: wien, graz, linz, salzburg, innsbruck.

maxItems

Maximum number of business listings to save.

The actor follows pagination until this limit is reached or no next page exists.

includeProfiles

When false, the actor extracts data from search results only.

When true, it opens each Herold profile page to fill missing details and profile text.

proxyConfiguration

Optional Apify proxy configuration.

The default is direct HTTP because Herold result pages are currently public and server-rendered.

Output example

{
  "companyName": "EF16 Restaurant Weinbar",
  "category": "restaurant",
  "profileUrl": "https://www.herold.at/gelbe-seiten/wien/sm4rW/ef16-restaurant-weinbar/",
  "searchUrl": "https://www.herold.at/gelbe-seiten/wien/restaurant/",
  "position": 1,
  "description": "Authentische Wiener Küche...",
  "streetAddress": "Fleischmarkt 16",
  "postalCode": "1010",
  "city": "Wien",
  "country": "AT",
  "phone": "+43 1 5132318",
  "email": "office@ef16.at",
  "website": "https://www.ef16.at/",
  "ratingValue": 4.9,
  "ratingCount": 7,
  "verified": true,
  "branchCode": "sm4rW",
  "scrapedAt": "2026-07-03T03:15:10.698Z"
}

Tips for better Herold exports

• Start with 20-50 items to validate the category.
• Use German category terms when possible.
• Use Herold URLs if the site UI produces a more specific search than simple keyword/location.
• Disable profile enrichment for large lead lists.
• Enable profile enrichment for high-value small lists.
• Export to CSV for spreadsheet workflows.
• Export to JSON for enrichment pipelines.

Integrations

CRM import

Download CSV and import leads into HubSpot, Pipedrive, Salesforce, or another CRM.

Lead scoring

Combine Herold website, email, ratings, and category fields with your scoring model.

Local SEO audits

Check which companies are listed in each Austrian city and category.

Agency outreach

Build prospecting lists for websites, reviews, ads, and local marketing services.

Data warehouses

Use Apify API or webhooks to send Herold datasets to BigQuery, Snowflake, or Postgres.

API usage

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('automation-lab/herold-at-business-directory-scraper').call({
  what: 'restaurant',
  where: 'wien',
  maxItems: 100,
});
console.log(run.defaultDatasetId);

Python

from apify_client import ApifyClient

client = ApifyClient('MY-APIFY-TOKEN')
run = client.actor('automation-lab/herold-at-business-directory-scraper').call(run_input={
    'what': 'restaurant',
    'where': 'wien',
    'maxItems': 100,
})
print(run['defaultDatasetId'])

cURL

curl -X POST "https://api.apify.com/v2/acts/automation-lab~herold-at-business-directory-scraper/runs?token=$APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"what":"restaurant","where":"wien","maxItems":100}'

MCP usage

Use this actor with Apify MCP in Claude Desktop or Claude Code.

MCP URL:

https://mcp.apify.com/?tools=automation-lab/herold-at-business-directory-scraper

Claude Code setup:

$claude mcp add apify-herold "https://mcp.apify.com/?tools=automation-lab/herold-at-business-directory-scraper"

Claude Desktop JSON config:

{
  "mcpServers": {
    "apify-herold": {
      "url": "https://mcp.apify.com/?tools=automation-lab/herold-at-business-directory-scraper"
    }
  }
}

Example prompts:

• "Scrape 100 restaurants in Vienna from Herold.at and summarize how many have websites."
• "Find dentists in Graz on Herold.at and return companies with email addresses."
• "Create a CSV of Austrian installers from Herold.at with phone and profile URLs."

Legality and responsible use

This actor extracts publicly available business directory information.

You are responsible for using the data lawfully, respecting privacy rules, and complying with applicable Austrian and EU regulations.

Do not use scraped contact data for unlawful spam or prohibited outreach.

FAQ and troubleshooting

Why did I get fewer results than maxItems?

The selected category/location may have fewer listings, or Herold may stop pagination for that query.

Try a broader location or category.

Why are some emails or websites missing?

Not every Herold listing publishes every contact field.

Enable includeProfiles to try profile-page enrichment.

Do I need proxies?

Usually no. Direct HTTP worked during development.

If you run many large jobs and see rate limiting, enable Apify proxy in the input.

Related scrapers

Explore other automation-lab local lead and directory scrapers on Apify:

• https://apify.com/automation-lab/wko-austria-business-directory-scraper
• https://apify.com/automation-lab/local-ch-scraper
• https://apify.com/automation-lab/brownbook-business-scraper
• https://apify.com/automation-lab/11880-scraper

Changelog

0.1

Initial Herold.at business directory scraper with search URL support, keyword/location search, pagination, contact extraction, ratings, and optional profile enrichment.

Support

If a Herold page layout changes or a query returns unexpected results, open an Apify issue with your run input and dataset sample.