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. When startUrls are supplied, they take precedence over what and where, so only one workflow runs.

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	Exact Herold result page that produced the row
pageNumber	Result page number for that source URL
rank	Sequential global order of rows saved by the run
position	Herold-provided position metadata; page-scoped semantics are not guaranteed
description	Listing snippet
verified	Whether Herold marks the company as verified
branchCode	Herold identifier when available
profileText	Focused profile summary/description 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 https://www.herold.at/gelbe-seiten/... result URLs into startUrls. Other domains and non-result URLs are rejected before scraping. If keyword/location values are also present (for example from UI prefills), startUrls take precedence and those values are ignored.

Example:

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

Input options

startUrls

Optional list of https://www.herold.at/gelbe-seiten/... search result URLs.

Use this when you already created a search on Herold.at and want the actor to continue from that URL. This mode takes precedence over what and where.

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 Herold profile pages with bounded concurrency to fill missing details and focused profile text. A profile request that still fails after bounded retries is logged and the base listing remains in the dataset.

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/",
  "pageNumber": 1,
  "rank": 1,
  "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 --transport http apify-herold "https://mcp.apify.com/?tools=automation-lab/herold-at-business-directory-scraper"

Claude Desktop setup

Use this JSON config:

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

Cursor setup

Add the same MCP URL as a remote HTTP server in Settings → Tools & Integrations → MCP.

VS Code setup

Add the same MCP URL as an HTTP MCP server in your workspace or user MCP configuration.

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, data handling, and dependencies

This Actor uses deterministic HTTPS extraction and does not use AI or send data to an AI provider. Its only external data dependency is the public Herold.at website; optional Apify Proxy traffic and ordinary Apify compute/storage are covered by the run's platform usage. No paid source account or off-platform service is required.

Public business listing fields are written only to the run's default Apify dataset. The Actor creates no external cache or separate copy. Datasets and logs follow your Apify account retention settings and can be deleted with Apify storage controls. Logs contain source URLs and operational status, not credentials. Optional fields remain absent when Herold does not expose them.

This Actor is an independent tool and is not affiliated with, endorsed by, or operated by Herold.at. The source name is used only to identify the public directory being accessed.

You are responsible for using the public business 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. If every requested page fails, or successfully loaded pages no longer contain recognizable listing containers, the run fails with an actionable error instead of silently succeeding with an empty dataset.

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.2

More reliable Herold exports with safer URL inputs, bounded retries, pagination-loop protection, global rank/page context, and faster fault-tolerant profile enrichment.

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.