# Austria Herold Scraper

Scrape business name, address, phone number, email, social media accounts, etc from Herold by listing urls.

- Template page: [https://www.octoparse.com/template/oesterreich-herold-scraper](https://www.octoparse.com/template/oesterreich-herold-scraper)
- Categories: Directories, Lead Generation
- Status: `PUBLISHED`
- Run mode: `BOTH`

## Pricing

Free.

## What is an Octoparse template?

An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters.

## Overview

This ready-to-use template collects structured data from listing pages, detail pages.

## Output

The current workflow extracts 16 fields, including `Adresse_Region`, `Adresse_Straße`, `Branche`, `Business_Name`, `Email`, `Ergebnis_url`, `Facebook`, `Land`, `PLZ`, `Telefon`, `Website`, `Youtube`, `errorMessage`, `searchTerm1`, `searchTerm2`, `Öffnungszeiten`.

## Use Cases

- Use structured results for research, comparison, and monitoring.
- Collect rows without building the extraction workflow from scratch.
- Combine results with other templates for downstream enrichment.
- Review a representative result before starting a large batch.

## Why Octoparse

- **No coding required:** complete Listing URLs (up to 100) and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Listing URLs (up to 100)

Required. Enter a list of listing page URLs on Herold. Constraints: minItems=1; maxItems=100; items.minLength=1; items.maxLength=5000.

## How to Use

## Austria Herold Scraper

### Purpose
Collects business name, address, phone, email, social media, and other listing details from [Herold](https://www.herold.at/) using one or more listing URLs.

### Input
- **Listing URLs (up to 100)** (required): Enter one URL per line.

### Output Fields
The template returns business name, category, address, postcode, region, country, opening hours, email, phone, website, Facebook, YouTube, and error message.

### How to Use
1. Open the template and select **Try it** or **Start**.
2. Enter the listing URLs (one per line, max 100).
3. Run the task locally (keep Octoparse and your computer open).
4. Review the results and export structured data.

### Limitations
- Runs locally; keep Octoparse open while the task is running.
- Fields like Facebook, YouTube, and errorMessage may be empty if the source does not provide them.

### Tips
- Start with a small number of URLs to verify output before scaling.
- Use the most specific valid URLs to reduce duplicates.
- Use a stable identifier (e.g., URL) as a deduplication key.

## Limitations

Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above.

## Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

## FAQ

### What do I need to enter?

Use the exact inputs and limits listed above.

### What data does this template return?

See Output Schema below; availability can vary by source record.

### How is usage billed?

See the Pricing section above for current pricing and billing details.

## Related Templates

- [eBay Listing Page Scraper (by keyword)](https://www.octoparse.com/template/ebay-product-list-scraper-by-keyword)
- [eBay Scraper](https://www.octoparse.com/template/ebay-scraper)
- [Bic Camera Search Results Scraper](https://www.octoparse.com/template/bic-camera-search-results-scraper)
- [Google Search Scraper](https://www.octoparse.com/template/google-search-scraper)
- [Google Maps Listings Scraper (by Keywords)](https://www.octoparse.com/template/google-maps-scraper-listing-page-by-keyword)

## Input Schema

```json
{
  "title": "Austria Herold Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "listing_URLs": {
      "title": "Listing URLs (up to 100)",
      "description": "Enter a list of listing page URLs on Herold.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 5000
      },
      "minItems": 1,
      "maxItems": 100,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "listing_URLs"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "listing_URLs": [
    ".simstechnology",
    "12CM lnc",
    "1NCE",
    "2Pi",
    "3drens"
  ]
}
```

Example 2

```json
{
  "listing_URLs": [
    "https://www.herold.at/gelbe-seiten/salzburg-stadt/restaurant/"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Adresse_Region": {
      "type": "string",
      "description": ""
    },
    "Adresse_Straße": {
      "type": "string",
      "description": ""
    },
    "Branche": {
      "type": "string",
      "description": ""
    },
    "Business_Name": {
      "type": "string",
      "description": ""
    },
    "Email": {
      "type": "string",
      "description": ""
    },
    "Ergebnis_url": {
      "type": "string",
      "description": ""
    },
    "Facebook": {
      "type": "string",
      "description": ""
    },
    "Land": {
      "type": "string",
      "description": ""
    },
    "PLZ": {
      "type": "string",
      "description": ""
    },
    "Telefon": {
      "type": "string",
      "description": ""
    },
    "Website": {
      "type": "string",
      "description": ""
    },
    "Youtube": {
      "type": "string",
      "description": ""
    },
    "errorMessage": {
      "type": "string",
      "description": ""
    },
    "searchTerm1": {
      "type": "string",
      "description": ""
    },
    "searchTerm2": {
      "type": "string",
      "description": ""
    },
    "Öffnungszeiten": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Austria Herold Scraper output",
  "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.",
  "additionalProperties": false
}
```

## Output Example

Example 1

```json
{
  "Adresse_Region": "",
  "Adresse_Straße": "",
  "Branche": "",
  "Business_Name": "",
  "Email": "",
  "Ergebnis_url": "",
  "Facebook": "",
  "Land": "",
  "PLZ": "",
  "Telefon": "",
  "Website": "",
  "Youtube": "",
  "errorMessage": "Cannot find result under this search.",
  "searchTerm1": "",
  "searchTerm2": "",
  "Öffnungszeiten": ""
}
```

Example 2

```json
{
  "Adresse_Region": "Wals-Siezenheim",
  "Adresse_Straße": "Bundesstraße 49",
  "Branche": "Restaurant",
  "Business_Name": "Strobl's Herzkuchl",
  "Email": "ESSEN@HERZKUCHL.AT",
  "Ergebnis_url": "https://www.herold.at/gelbe-seiten/wals-siezenheim/kdx3P/strobls-herzkuchl/",
  "Facebook": "https://www.facebook.com/herzkuchl/",
  "Land": "AT",
  "PLZ": "5071",
  "Telefon": "+43 699 11091350",
  "Website": "",
  "Youtube": "",
  "errorMessage": "",
  "searchTerm1": "\r\nRestaurant",
  "searchTerm2": "\r\nSalzburg (Stadt)",
  "Öffnungszeiten": "Mo\n11:30\n-\n22:00\nDi\n11:30\n-\n22:00\nMi\ngeschlossen\nDo\ngeschlossen\nFr\n11:30\n-\n22:00\nSa\n11:30\n-\n22:00\nSo\n11:30\n-\n20:00\n\nKommentar von Strobl's Herzkuchl\n\nMittagsmenüs von 12.00 - 14.00 Uhr. Durchgehend warme Küche. Alle Speisen auch zum mitnehmen. Ruhige Sonnenterrasse, mit Blick auf den Untersberg . An Feiertagen haben wir durchgehend geöffnet, auch wenn es auf einen üblichen Ruhetag fällt."
}
```

## API

`POST https://openapi.octoparse.com/api/agentTools/executeTask`

This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token.

Request body:

`templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional.

Obtain a token:

```http
POST https://openapi.octoparse.com/token
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "grant_type": "password"
}
```

Use `data.access_token` as `Authorization: Bearer <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

```json
{
  "templateName": "oesterreich-herold-scraper",
  "taskName": "Austria Herold Scraper",
  "parameters": "{\"listing_URLs\":[\".simstechnology\",\"12CM lnc\",\"1NCE\",\"2Pi\",\"3drens\"]}"
}
```

## Python Example

```python
import json
import requests

OPENAPI_BASE = "https://openapi.octoparse.com"
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"

parameters = json.loads("{\"listing_URLs\":[\".simstechnology\",\"12CM lnc\",\"1NCE\",\"2Pi\",\"3drens\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "oesterreich-herold-scraper",
        "taskName": "Austria Herold Scraper",
        "parameters": json.dumps(parameters, ensure_ascii=False),
    },
    timeout=60,
)
print(response.status_code)
print(response.json())
```

## HTTP/cURL Example

```bash
curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "templateName": "oesterreich-herold-scraper",
  "taskName": "Austria Herold Scraper",
  "parameters": "{\"listing_URLs\":[\".simstechnology\",\"12CM lnc\",\"1NCE\",\"2Pi\",\"3drens\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `oesterreich-herold-scraper`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results.

## Machine-readable Resources

- [Template contract](https://www.octoparse.com/templates/oesterreich-herold-scraper.json)
- [Manifest](https://www.octoparse.com/templates/oesterreich-herold-scraper-manifest.json)
