HEROLD Company Scraper

Extract HEROLD company and business records for company discovery, business research and directory exports. HEROLD Company Scraper collects public information into one complete dataset table, ready to export as Excel, CSV or JSON.

Use search filters or individual public record links, set how many results you need and start the Actor. Search finds matching records; Details retrieves the available information for records you already know.

At a glance	Details
📥 Input	Search filters or individual public record links
📋 Collection modes	Search company records; Get company details
📤 Output	One row per record, or a failed row for an unsuccessful input
📄 Pagination	Automatic, up to maxResults while more records are available
🔐 Website login	Not required
💾 Export	One dataset view with all fields; Excel, CSV and JSON

What the HEROLD scraper collects 📋

Mode	What you receive
Search company records	Matching company and business records and the fields published in the search results.
Get company details	Available public information for each supplied record. The full output example below shows its actual fields.

The field table and complete examples below show the information this Actor returns. Optional values depend on what the source publishes for the selected record.

Coverage for this Actor:

• Search Austrian businesses by category or name and city.
• Profiles can include contacts, services, hours, payment methods, ratings and company registration details. Credit reports are outside this actor.

How to scrape HEROLD 🚀

1. Choose Search company records or Get company details.
2. Complete the search filters or individual public record links.
3. Set Maximum results. The minimum is 1.
4. Start the Actor and review the saved dataset.
5. Export the results or connect them to your workflow.

Search company records — input example

{
  "mode": "search",
  "keyword": "restaurant",
  "city": "Wien",
  "maxResults": 10
}

Get company details — input example

{
  "mode": "details",
  "recordUrls": [
    "https://www.herold.at/gelbe-seiten/wien/sm4rW/ef16-restaurant-weinbar/"
  ],
  "maxResults": 1
}

maxResults limits all saved rows for each search or supplied record, including a failed row. It does not guarantee that the source has that many matching records. A detail lookup normally returns one record, although sources with multiple revisions or establishments can return more.

HEROLD data fields and complete output 📦

Each result stays in one row. Every returned field appears in the same dataset view, including list fields and additional published facts. Fields unavailable for a particular record remain empty.

Field	Included data
result_type	Selected collection mode.
input	Submitted search settings, record link or record number.
status	Collection outcome.
error_code	Failure category for an unsuccessful input.
error_message	Readable explanation for an unsuccessful input.
record_id	Stable source business or company record identifier.
url	Public business or company profile link.
name	Business or company name as published.
address_text	Original address text.
phone_numbers	Publicly displayed business telephone numbers.
rating	Published rating for this business location.
listing_text	All readable text in the primary search card.
images	Public business photo and logo links.
additional_fields.name	Names of additional published fields, when present.
additional_fields.value	Their corresponding values in the same order.
websites	Business website links.
email_addresses	Publicly displayed business email addresses.
latitude	Latitude of the public business location.
longitude	Longitude of the public business location.
rating_count	Number of ratings for the business location.
founding_date	Founding or registration date stated by the source.
payment_methods	Advertised accepted payment methods.
record_data.name	Record data / name, when published.
record_data.value	Record data / value, when published.
description	Complete public business description, or the search card description.
services	Public description of services and facilities.
additional_information	Additional business profile information.
opening_hours.dayOfWeek	Opening hours / day of week, when published.
opening_hours.opens	Opening hours / opens, when published.
opening_hours.closes	Opening hours / closes, when published.

The complete result below is included for every mode. Text and lists are not shortened. These are examples from validation runs; the source can change.

Search company records — complete JSON result

{
  "result_type": "search",
  "input": "{\"city\": \"Wien\", \"keyword\": \"restaurant\"}",
  "status": "success",
  "record_id": "sm4rW",
  "url": "https://www.herold.at/gelbe-seiten/wien/sm4rW/ef16-restaurant-weinbar/",
  "name": "EF16 Restaurant Weinbar",
  "address_text": "Fleischmarkt 16 1010 Wien Wien 1 (Innere Stadt) Wien",
  "phone_numbers": [
    "+43 1 5132318"
  ],
  "rating": 4.9,
  "listing_text": "Verifiziert EF16 Restaurant Weinbar 4.9 (7) Authentische Wiener Küche, mediterrane Aromen und exzellente Weine – serviert im stimmungsvollen Innenhof Wiens. 1010 Wien Mehr Details Authentische Wiener Küche, mediterrane Aromen und exzellente Weine – serviert im stimmungsvollen Innenhof Wiens. Kontakt: +43 1 5132318 office@ef16.at https://www.ef16.at Fleischmarkt 16 1010 Wien Wien 1 (Innere Stadt) Wien Fleischmarkt 16 1010 Wien Wien 1 (Innere Stadt) Wien",
  "images": [
    "https://a.mktgcdn.com/p/V-up-hsdHvIwV54L0aLBbeFZKXmVP1kRbl-Jm7_VB_A/600x600.png"
  ],
  "additional_fields.name": [],
  "additional_fields.value": []
}

Get company details — complete JSON result

{
  "result_type": "details",
  "input": "https://www.herold.at/gelbe-seiten/wien/sm4rW/ef16-restaurant-weinbar/",
  "status": "success",
  "record_id": "sm4rW",
  "url": "https://www.herold.at/gelbe-seiten/wien/sm4rW/ef16-restaurant-weinbar/",
  "websites": [
    "https://www.ef16.at",
    "https://www.facebook.com/ef16restaurant/"
  ],
  "phone_numbers": [
    "+43 1 5132318"
  ],
  "email_addresses": [
    "office@ef16.at"
  ],
  "name": "EF16 Restaurant Weinbar",
  "address_text": "Fleischmarkt 16 1010 Wien Wien 1 (Innere Stadt) Wien",
  "latitude": 48.210278,
  "longitude": 16.376785,
  "rating": 4.9,
  "rating_count": 7,
  "founding_date": "2018",
  "payment_methods": [
    "VISA, Mastercard, Diners Club, Barzahlung, Bar"
  ],
  "record_data.name": [
    "Gründungsjahr",
    "Firmenbuchnummer",
    "Bonitätsauskunft"
  ],
  "record_data.value": [
    "2018",
    "FN 503393 i",
    "KSV 1870"
  ],
  "description": "Das ef16 Restaurant Weinbar verbindet Wiener Küche mit mediterranen Einflüssen und saisonalen, frisch zubereiteten Gerichten. Im stilvollen Ambiente und im prämierten Innenhof genießen Gäste hochwertige österreichische Produkte, exzellente Weine und herzlichen Service – ideal für besondere Abende im Herzen Wiens.",
  "services": "4.9 (7) 7 Bewertungen Bewertung abgeben EF16 Restaurant Weinbar Fleischmarkt 16 1010 Wien Wien 1 (Innere Stadt) Wien Restaurant fairer Preis Leistungen Gastronomie Küche Internationale Küche Nationale Küche Saisonale Küche Ausstattung Gastgarten Nichtraucherbereich Besondere Services Mittagsmenü Verkauf regionaler Schmankerl Lokalvermietung",
  "additional_information": "Wiener Genuss trifft mediterrane Eleganz Besonderheiten Exzellenter Service & stilvolles Ambiente (mehrfach in Bewertungen hervorgehoben) Hervorragender Gastgarten im Innenhof (prämiert) Ideal für romantische Abende & besondere Anlässe (laut Gästebewertungen) Kombination aus österreichischer und mediterraner Fusionsküche Top Bewertungen",
  "opening_hours.dayOfWeek": [
    "Monday",
    "Tuesday",
    "Wednesday",
    "Thursday",
    "Friday",
    "Saturday"
  ],
  "opening_hours.opens": [
    "17:30",
    "17:30",
    "17:30",
    "17:30",
    "17:30",
    "17:30"
  ],
  "opening_hours.closes": [
    "23:30",
    "23:30",
    "23:30",
    "23:30",
    "23:30",
    "23:30"
  ],
  "images": [
    "https://a.mktgcdn.com/p/95cmCcOSTveHs4s10dVaLHgZM606qYlSYz_dGz2FhBA/800x533.jpg",
    "https://a.mktgcdn.com/p/9krLdIhmbzpAhw1Ft3cyVOUYoVokEYpj24TmoivUWSY/1024x682.jpg",
    "https://www.herold.at/FS/picture/4/2/8/6340824.jpg"
  ],
  "additional_fields.name": [],
  "additional_fields.value": []
}

Input settings ⚙️

Setting	What to enter
What to collect (mode)	Choose the information you need.
Maximum results per search or link (maxResults)	Collect up to this many saved results for each search or record link. Minimum: 1.
Business or company keywords (keyword)	Business name, service or category to search for. Use the local language for the best coverage.
City (city)	City name as used by the local directory.
Company links (recordUrls)	Paste one individual public record link per line. Use this field in Details mode.

HEROLD scraping use cases 🎯

Build a company research list

Use the supported name, category or location fields to collect relevant companies. Export the available business information with source references.

Collect company profiles

Retrieve known public records and review the published company facts, business descriptions and contact information that this source provides.

Keep a business dataset current

Schedule repeated exports and compare stable company IDs. Missing fields remain empty instead of being guessed.

Pricing and saved-result behavior 💰

See the Actor’s Pricing tab for the current rate. Under dataset-item pricing:

• Each saved record is one result. Lists and additional details attached to it do not create extra rows.
• A saved failed row is also one billable dataset item. This includes invalid inputs, unavailable records, empty searches and exhausted retries.
• At most one failed row is saved per input. Retry attempts do not create additional dataset rows.
• maxResults caps all saved rows for the input. Duplicate copies of the same input are processed once.

HEROLD scraper API and integrations 🔌

Replace $ACTOR_ID with the ID shown in the Actor’s API tab and $APIFY_TOKEN with your Apify token.

curl -X POST "https://api.apify.com/v2/acts/$ACTOR_ID/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"search","keyword":"restaurant","city":"Wien","maxResults":10}'

Use Apify schedules for recurring collection, webhooks for completion notifications, and integrations for Google Sheets, Make, Zapier, cloud storage or your own application.

Reliability and public-data limits ⚠️

Temporary request failures are retried up to five total attempts. Invalid record inputs save a failed row without a website request. Confirmed missing records are not retried unnecessarily. If a later request fails, records already saved remain in the dataset. Normal pagination completion does not add a failed row. Collection stops after two consecutive pages return no new records. Configuration, data-saving or request-scheduling failures stop the run.

HEROLD controls the available records and fields. Search records can contain less information than a full public card. The Actor preserves published values and does not fill missing facts with estimates.

Frequently asked questions ❓

Do I need a HEROLD account?

No. This Actor collects the supported public information without your website login.

Which search filters can I use?

The input form supports business or company keywords, city. Only the displayed filters are supported.

How many records can I collect?

Set maxResults to the maximum saved rows you want for each input. The minimum is 1. Collection can finish earlier when the source runs out of results or stops returning new records.

Why are some fields empty?

The source may not publish a value for that record or mode. Optional information remains empty.

Can I export all the fields?

Yes. All returned fields are included in one dataset view. Nested lists remain attached to their parent record.

Support 🛟

For a reproducible issue, share the run ID, selected mode and a safe public example through the Actor’s support channel. Keep tokens, passwords and proxy credentials private.