{ "openapi": "3.0.1", "info": { "title": "Herold.at Scraper", "description": "[💰 $1.5 / 1K] Extract Austrian business listings from Herold.at — name, address, phone, email, website, categories, opening hours, rating, and review count, plus optional individual customer reviews. Search by what + where, browse by category, or paste Herold.at URLs directly.", "version": "1.0", "x-build-id": "LUyfuSFAywm0g9nK6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~herold-at-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-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/solidcode~herold-at-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-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/solidcode~herold-at-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-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", "properties": { "searchQueries": { "title": "Search Queries", "type": "array", "description": "What to search for on Herold.at (e.g. 'Restaurant', 'Zahnarzt', 'Elektriker', 'Rechtsanwalt'). One row per search term. Leave empty if you're using direct URLs below.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Where in Austria to search. Accepts a state ('Wien', 'Niederösterreich', 'Oberösterreich', 'Steiermark', 'Tirol', 'Salzburg', 'Kärnten', 'Vorarlberg', 'Burgenland') or a city or district ('Graz', 'Linz', 'Innsbruck', 'Klagenfurt', 'Villach', 'Wels', 'Sankt Pölten', 'Dornbirn'). Leave empty to search all of Austria. (Tip: smaller villages may have no page of their own — use the surrounding district or state, or leave this empty and add the village to your search term.)" }, "searchUrls": { "title": "Herold.at URLs", "type": "array", "description": "Paste Herold.at URLs directly: search / category result pages (e.g. https://www.herold.at/gelbe-seiten/wien/restaurant/) or individual business pages. Filters baked into the URL are honored as-is. When provided, these are scraped in addition to the search above.", "items": { "type": "string" } }, "includeDetails": { "title": "Include Detail-Page Data", "type": "boolean", "description": "Visit each business's detail page to add the business description, founding year, company register number (Firmenbuchnummer) and extra photos. Everything else — name, address, phone, email, website, categories, rating and the opening-hours table — already comes with the fast listing data, so turn this off for quicker, cheaper runs unless you need those four extras. Slower when on (one extra request per business).", "default": true }, "includeReviews": { "title": "Include Individual Reviews", "type": "boolean", "description": "Also collect every individual customer review for each business and add each one as its own separate row in the results (with reviewer name, title, review text, date, and per-category star scores). IMPORTANT: each review is counted and billed as a separate result. Collecting reviews requires visiting each business's detail page, so turning this on automatically fetches detail pages even if 'Include Detail-Page Data' is off. Leave off to get only one row per business with an aggregate rating and review count.", "default": false }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "How many businesses to collect in total, across every search term and URL. Default 100. Herold hands out businesses 30 to a page and a page is always kept whole, so the number you actually get is rounded up to the next 30 — ask for 1 and you get 30, ask for 40 and you get 60, ask for 100 and you get 120. Set to 0 for no limit. This counts businesses only: if you switch on 'Include Individual Reviews', every review is saved as its own extra row on top, so the total number of results — and your bill — can be several times this number. Whatever you put here, a single run always stops once it has saved 50,000 results in total, counting businesses and reviews together, so no one run can bill without end. To gather very large datasets, split the work across several search terms or locations.", "default": 100 } } }, "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 } } } } } } } } } }