{ "openapi": "3.0.1", "info": { "title": "Herold.at Scraper & API - Austrian Business Leads & Emails", "description": "Herold.at scraper and API for Austrian B2B leads: search Herold (Gelbe Seiten Austria) by category and city or Bundesland. One result = one business: name, phone, email, website, address, Bezirk, rating, Firmenbuchnummer, founding year, hours. No login. $0.70 per 1,000, cheapest on 5 Nov 2026.", "version": "1.0", "x-build-id": "I0vufb9IWX5foTJgJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rel8ble~herold-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rel8ble-herold-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/rel8ble~herold-scraper/runs": { "post": { "operationId": "runs-sync-rel8ble-herold-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/rel8ble~herold-scraper/run-sync": { "post": { "operationId": "run-sync-rel8ble-herold-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", "properties": { "categories": { "title": "Categories (Branchen)", "type": "array", "description": "What to search: Herold categories in German, one per line, e.g. \"Installateur\", \"Steuerberater\", \"Zahnarzt\", \"Elektriker\", \"Rechtsanwälte\", \"Hotels\". Every category is searched in every location below. A word that is not an exact Herold category is matched against Herold's Branchen A-Z list automatically (e.g. \"Psychologe\" -> \"Psychologen\").", "items": { "type": "string" } }, "locations": { "title": "Locations (optional)", "type": "array", "description": "Where to search: Austrian cities, Bundesländer or 4-digit postal codes, one per line, e.g. \"Wien\", \"Graz\", \"Salzburg\", \"Tirol\", \"1010\". Leave empty to search all of Austria.", "items": { "type": "string" } }, "startUrls": { "title": "Herold.at URLs", "type": "array", "description": "Optional. Result pages (https://www.herold.at/gelbe-seiten/wien/installateur/) and/or single business pages (https://www.herold.at/gelbe-seiten/wien/N1JdH/lugar-installateur-gmbh/), one per line. Use these instead of, or on top of, categories x locations.", "items": { "type": "string" } }, "maxResultsPerSearch": { "title": "Max businesses per category + location", "minimum": 0, "type": "integer", "description": "Optional. Businesses saved per category-location pair, integer >= 0. Default 100; 0 = every listing (up to 6,000 per pair). You pay per business, so start small.", "default": 100 }, "scrapeDetails": { "title": "Open each business page (company register no., hours, fax, services)", "type": "boolean", "description": "Optional boolean. true (default) = also open every business page for the Firmenbuchnummer, founding year, employees, fax, social links, opening hours, services, products, categories and coordinates. false = result list only (name, phone, email, website, address, rating): about 3x faster. Same price either way.", "default": true }, "requireEmail": { "title": "Only businesses with an email", "type": "boolean", "description": "Optional filter. Skip businesses without an email address. Skipped businesses are not charged.", "default": false }, "requireWebsite": { "title": "Only businesses with a website", "type": "boolean", "description": "Optional filter. Skip businesses without a website. Skipped businesses are not charged.", "default": false }, "requirePhone": { "title": "Only businesses with a phone number", "type": "boolean", "description": "Optional filter. Skip businesses without a phone number. Skipped businesses are not charged.", "default": false }, "verifiedOnly": { "title": "Only verified listings", "type": "boolean", "description": "Optional filter. Keep only listings Herold marks as \"Verifiziert\" (claimed and checked by the owner). Skipped businesses are not charged.", "default": false }, "minRating": { "title": "Min rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Optional filter, 0-5. Skip businesses rated below this (unrated businesses are skipped too). Skipped businesses are not charged." }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Optional, advanced. Parallel requests, integer 1-20. Default 8. Leave unset.", "default": 8 }, "maxRequestRetries": { "title": "Max retries per request", "minimum": 0, "maximum": 20, "type": "integer", "description": "Optional, advanced. Retries per failed or blocked request, integer 0-20; each retry uses a new session. Default 6.", "default": 6 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional, advanced. Leave as is. Default {\"useApifyProxy\": false} = automatic: direct connection first, and only requests that get blocked are retried through Apify Proxy (datacenter, then residential). Set your own Apify Proxy groups or proxy URLs to force them for every request.", "default": { "useApifyProxy": false } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }