# Herold.at Scraper (`lexis-solutions/herold-at-scraper`)

Scrape business listings from Herold.at - including company names, contact details, locations, and reviews. Ideal for market research, lead generation, and local SEO. Fast, structured, and customizable extraction.

- **URL**: https://beta-securitybyobscurity.apify.com/lexis-solutions/herold-at-scraper.md
- **Developed by:** [Lexis Solutions](https://beta-securitybyobscurity.apify.com/lexis-solutions) (community)
- **Categories:** Lead generation, Automation, SEO tools
- **Stats:** 16 total users, 1 monthly users, 100.0% runs succeeded, 8 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$29.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.
You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

# README

## Herold.at Business Directory Scraper

![banner](https://lexis-solutions-apify.fra1.cdn.digitaloceanspaces.com/banners/heroldat-at.png)

### 🔎 What does Herold.at Business Directory Scraper do

Our Herold.at Business Directory Scraper allows you to easily **extract business information from Austria's leading business directory**. The actor automatically crawls through Herold.at and extracts detailed business information based on your search criteria.

### 🧾 What data can the scraper extract

The scraper extracts comprehensive business information including:

- Business name and description
- Contact information (phone, email)
- Physical address
- Business category
- Opening hours
- Website URL (if available)
- Company logo URL
- Additional business details

### 💼 Use Cases

- **Lead Generation**: Build targeted lists of Austrian businesses for sales and marketing
- **Market Research**: Analyze business presence and distribution across Austrian regions
- **Competitive Analysis**: Track competitors and understand market positioning
- **Business Networking**: Find potential business partners or suppliers
- **Local SEO**: Gather business data for local SEO and directory submissions
- **Data Enrichment**: Enhance existing business databases with verified information

### 📖 How to use the Herold.at Scraper

1. [Create](https://console.apify.com/sign-up) a free Apify account
2. Open Herold.at Business Directory Scraper
3. Choose your input method:
   - Enter search keywords (e.g., "restaurants wien")
   - Provide specific URLs to scrape
4. Set the maximum number of results (optional)
5. Configure proxy settings if needed
6. Click "Start" and wait for the results
7. Download your data in JSON, XML, CSV, Excel, or HTML format

### 📥 Input Examples

The actor accepts two types of input:

Using `startUrls`:

```json
{
  "startUrls": [
    { "url": "https://www.herold.at/gelbe-seiten/installateurnotdienst" } 
  ],
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "groups": ["RESIDENTIAL"]
  }
}
```

Using `keyword`:

```json
{
  "keyword": "installateurnotdienst",
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "groups": ["RESIDENTIAL"]
  }
}
```

### 📤 Output Example

```json
{
    "companyDetailUrl": "https://www.herold.at/gelbe-seiten/wien/Rg2ZK/b-gas-installateur-und-notdienst-vaillant-junkers-baxi-service/",
    "companyName": "B-GAS - Installateur & Notdienst + Vaillant, Junkers, Baxi Service",
    "companyDescription": "Ihr Spezialist von B-GAS Installateur, für Heizung, Sanitär, Wasserschäden und Abflussproblemen.24 Stunden für Wien, Niederösterreich u.-Burgenland.",
    "companyAddress": "1220 Wien",
    "companyPhone": "+43 1 2028556",
    "companyEmail": "office@b-gas.at",
    "companyWebsite": "https://www.installateur-bgas.at",
    "companyLogoUrl": "https://a.mktgcdn.com/p/6-lbjcGiS76vKEphcE1cmC4j_ytoxjSYWjlo9J4sBbk/600x600.jpg"
}
```

### ⚡️ Why use the Herold.at Scraper

- **Fast & Efficient**: Automatically handles pagination and data extraction
- **Easy to Use**: No coding knowledge required
- **Reliable**: Well-maintained and regularly updated
- **Flexible Output**: Multiple export formats available
- **API Integration**: Can be integrated with your existing systems

### 🔗 Integrations

Connect the scraper with various services through [Apify's integrations](https://apify.com/integrations):

- Make (Integromat)
- Zapier
- Slack
- Google Sheets
- Webhooks
- And [many more](https://docs.apify.com/integrations)

### 📝 Note on Scraping

This scraper extracts publicly available data from Herold.at. Please ensure your use of the data complies with Herold.at's terms of service and applicable laws and regulations. The data is provided for informational purposes only and may not be completely accurate or up-to-date.

***

### Need to scrape other business and marketplace websites

- Business & Real Estate 🏢
  - [Redfin Scraper](https://apify.com/lexis-solutions/redfin-scraper)
  - [Hemnet.se Scraper](https://apify.com/lexis-solutions/hemnet-se-scraper)

- Marketplace & E-commerce 🛒
  - [Alibaba Scraper](https://apify.com/lexis-solutions/alibaba-scraper)
  - [Wayfair Scraper](https://apify.com/lexis-solutions/wayfair-scraper)
  - [Otto Scraper](https://apify.com/lexis-solutions/otto-scraper)

👀 Need help or custom features?

Lexis Solutions is a [certified Apify Partner](https://apify.com/partners). Contact us for support and customization options:

- [Email](mailto:info@lexis.solutions)
- [LinkedIn](https://www.linkedin.com/company/lexis-solutions)

# Actor input Schema

## `startUrls` (type: `array`):

Enter the start URLs to crawl

## `keyword` (type: `string`):

Enter a keyword to search for

## `maxItems` (type: `integer`):

Limit the number of items to be scraped (0 for unlimited)

## `proxyConfiguration` (type: `object`):

Your proxy configuration from Apify

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.herold.at/gelbe-seiten/suche/?term=ATV Immobilien"
    }
  ],
  "keyword": "ATV Immobilien",
  "maxItems": 10,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": []
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://www.herold.at/gelbe-seiten/suche/?term=ATV Immobilien"
        }
    ],
    "keyword": "ATV Immobilien"
};

// Run the Actor and wait for it to finish
const run = await client.actor("lexis-solutions/herold-at-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [{ "url": "https://www.herold.at/gelbe-seiten/suche/?term=ATV Immobilien" }],
    "keyword": "ATV Immobilien",
}

# Run the Actor and wait for it to finish
run = client.actor("lexis-solutions/herold-at-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://www.herold.at/gelbe-seiten/suche/?term=ATV Immobilien"
    }
  ],
  "keyword": "ATV Immobilien"
}' |
apify call lexis-solutions/herold-at-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=lexis-solutions/herold-at-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Herold.at Scraper",
        "description": "Scrape business listings from Herold.at - including company names, contact details, locations, and reviews. Ideal for market research, lead generation, and local SEO. Fast, structured, and customizable extraction.",
        "version": "0.0",
        "x-build-id": "3Htqf0iq74JOXUyOW"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/lexis-solutions~herold-at-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-lexis-solutions-herold-at-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/lexis-solutions~herold-at-scraper/runs": {
            "post": {
                "operationId": "runs-sync-lexis-solutions-herold-at-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/lexis-solutions~herold-at-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-lexis-solutions-herold-at-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "startUrls",
                    "maxItems"
                ],
                "properties": {
                    "startUrls": {
                        "title": "Start URLs",
                        "type": "array",
                        "description": "Enter the start URLs to crawl",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "keyword": {
                        "title": "Keyword",
                        "type": "string",
                        "description": "Enter a keyword to search for"
                    },
                    "maxItems": {
                        "title": "Maximum number of items",
                        "type": "integer",
                        "description": "Limit the number of items to be scraped (0 for unlimited)",
                        "default": 10
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Your proxy configuration from Apify",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": []
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
