# Austria WKO Business Directory Scraper (`minute_contest/wko-business-directory-scraper`) Actor Scrape 620,000+ Austrian businesses from WKO Firmen A-Z - the official Chamber of Commerce directory. Get company names, addresses, phone numbers, emails, websites, industry codes, and trade licenses. No API exists for this data. - **URL**: https://apify.com/minute\_contest/wko-business-directory-scraper.md - **Developed by:** [minute contest](https://apify.com/minute_contest) (community) - **Categories:** Business, Lead generation, Automation - **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 company records This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Austria WKO Business Directory Scraper | Firmenverzeichnis der Wirtschaftskammer Extract structured company data from Austria's official Chamber of Commerce directory - 620,000+ businesses with contact details, trade licenses, and industry classifications. No API exists for this data. ### Quick Start Click **Try it** and paste this input: ```json { "branche": "IT-Dienstleistung", "bundesland": "Wien", "maxResults": 50 } ```` ### Sample Output ```json { "companyName": "Tech Solutions GmbH", "address": "Mariahilfer Strasse 45", "postalCode": "1060", "city": "Wien", "bundesland": "Wien", "phone": "+43 1 234 5678", "email": "office@techsolutions.at", "website": "https://www.techsolutions.at", "branche": "IT-Dienstleistung", "tradeLicenses": [ "Dienstleistungen in der automatischen Datenverarbeitung und Informationstechnik" ], "certifications": null, "memberSince": "2015", "firmaId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "sourceUrl": "https://firmen.wko.at/tech-solutions-gmbh/wien/?firmaid=..." } ``` ### Pricing | Volume | Cost | |--------|------| | Start cost | $0.005 | | Per result | $0.003 | | ~100 results | ~$0.31 | | ~1,000 results | ~$3.01 | | ~10,000 results | ~$30.01 | No subscriptions, no minimum commitment - pay only for what you use. ### Features - **Industry search (Branche)** - search by trade classification (e.g. "Gastronomie", "Steuerberater") - **Location filter** - filter by Austrian state (Bundesland) and district (Bezirk) - **Keyword search** - free-text search for company names and services - **Full contact extraction** - phone, email, website from company detail pages - **Trade licenses (Gewerbeberechtigungen)** - official trade authorizations for each company - **Certifications** - quality marks and certifications - **Structured output** - clean JSON with parsed address (street, PLZ, city, state) ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `searchQuery` | string | No | - | Keyword search for company name or service | | `branche` | string | No | - | Industry/trade classification (e.g. "Gastronomie") | | `bundesland` | string | No | All | Austrian state: Wien, Niederosterreich, Oberosterreich, Steiermark, Tirol, Salzburg, Karnten, Burgenland, Vorarlberg | | `bezirk` | string | No | - | District within the selected Bundesland | | `maxResults` | integer | No | 100 | Maximum number of companies to return (1-10,000) | | `proxyConfiguration` | object | No | - | Apify Proxy configuration | At least one of `searchQuery`, `branche`, or `bundesland` must be provided. #### More Input Examples **Search by keyword across all of Austria:** ```json { "searchQuery": "Steuerberater", "maxResults": 200 } ``` **District-level search with proxy:** ```json { "branche": "Tischlerei", "bundesland": "Salzburg", "bezirk": "Hallein", "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` ### Output Fields | Field | Type | Description | |-------|------|-------------| | `companyName` | string | Official business name as registered with WKO | | `address` | string | Street address | | `postalCode` | string | Austrian postal code (PLZ, 4 digits) | | `city` | string | City name | | `bundesland` | string | Austrian federal state | | `phone` | string | Phone number | | `email` | string | Email address | | `website` | string | Company website URL | | `branche` | string | Industry/trade classification | | `tradeLicenses` | array | List of trade licenses (Gewerbeberechtigungen) | | `certifications` | string | Quality marks and certifications | | `memberSince` | string | WKO membership date | | `firmaId` | string | WKO internal company identifier (UUID) | | `sourceUrl` | string | URL of the company's WKO profile page | ### Use Cases - **B2B lead generation** - find companies in specific industries and locations with verified contact data - **Market entry research** - map the competitive landscape before entering the Austrian market - **Supplier discovery** - find certified suppliers and service providers by trade classification - **Competitive analysis** - analyze industry concentration by region and identify market gaps - **Sales prospecting** - build targeted prospect lists by industry, location, and company size ### Data Source & Compliance Data comes from **firmen.wko.at** - the official business directory of the Austrian Federal Economic Chamber (Wirtschaftskammer Osterreich). - **Coverage**: 620,000+ Austrian businesses with active trade licenses - **Public**: free access, no login required - **Official**: data originates from the Austrian trade registry (Gewerberegister) - **Real-time**: reflects current WKO membership status - Published by a public-law institution under the Austrian Economic Chamber Act (Wirtschaftskammergesetz) - Limited to business contact information (no personal data beyond what companies choose to publish) - Rate limiting (2-3 seconds between requests) to minimize server impact - Users are responsible for complying with applicable data protection laws (GDPR, DSG) when using extracted data ### European Business Data Suite This Actor is part of a growing collection of European business registry scrapers. No subscriptions, no minimum commitment - pay only for what you use. | Country | Registry | Actor | What it does | |---------|----------|-------|-------------| | **Austria** | **WKO** | **This Actor** | 620K+ businesses, trade licenses, contact data | | Poland | eKRS | [Financial Statements](https://apify.com/minute_contest/poland-krs-financial-scraper) | Balance sheets, income statements | | Poland | KRS | [Board Members](https://apify.com/minute_contest/krs-fullnames-scraper) | Full non-anonymized director names | | Poland | KRZ | [Debtor Registry](https://apify.com/minute_contest/krz-debtor-scraper) | Bankruptcy, restructuring, enforcement | | Poland | KNF | [Financial Supervision](https://apify.com/minute_contest/knf-registry-scraper) | 75,000+ regulated financial entities | | Poland | MSiG | [Court Gazette](https://apify.com/minute_contest/msig-scraper) | Court announcements since 2001 | | Poland | EKW | [Land Registry](https://apify.com/minute_contest/ekw-ksiegi-wieczyste-scraper) | Property ownership, mortgages | | Poland | CRBR | [Beneficial Owners](https://apify.com/minute_contest/crbr-beneficial-owners-scraper) | UBO verification by NIP/KRS | | Poland | UOKiK | [Abusive Clauses](https://apify.com/minute_contest/uokik-clauses-scraper) | 7,500+ banned contract clauses | | Poland | BDO | [Waste Registry](https://apify.com/minute_contest/bdo-waste-registry-scraper) | 674,000+ waste management entities | > **Full suite**: [apify.com/minute\_contest](https://apify.com/minute_contest) ### Informationen auf Deutsch #### Was ist dieses Tool? Dieser Apify Actor extrahiert Unternehmensdaten aus dem offiziellen **WKO Firmen A-Z** Verzeichnis (firmen.wko.at). Er durchsucht das Firmenverzeichnis der Wirtschaftskammer Osterreich und liefert strukturierte Daten zu uber 620.000 osterreichischen Unternehmen. #### Welche Daten werden extrahiert? - **Firmenname** - Offizieller Name laut Gewerberegister - **Adresse** - Strasse, PLZ, Ort, Bundesland - **Kontaktdaten** - Telefon, E-Mail, Website - **Gewerbeberechtigungen** - Alle aktiven Berechtigungen - **Branche** - Branchenklassifikation der WKO - **Zertifizierungen** - Gutesiegel und Qualitatsauszeichnungen #### Anwendungsbeispiele - **B2B-Leadgenerierung** - Zielgerichtete Firmenlisten nach Branche und Standort - **Marktanalyse** - Wettbewerbslandschaft in osterreichischen Branchen - **Lieferantensuche** - Zertifizierte Anbieter nach Gewerbe finden - **Vertriebsunterstutzung** - Kontaktdaten fur die Kaltakquise #### Beispiel-Eingabe ```json { "branche": "Elektrotechnik", "bundesland": "Oberosterreich", "maxResults": 100 } ``` ### Limitations - **Processing time**: 5-10 seconds per company (page load + detail extraction + rate limiting). A run with 100 companies takes approximately 10-15 minutes. - **Pagination limits**: The WKO site uses ASP.NET postback pagination which can be unreliable for very deep result sets (1000+ pages). Narrow your search with specific branche and bundesland filters. - **Detail page variations**: Not all company profiles contain the same data. Some businesses have minimal profiles with only name and address. - **Rate limiting**: The actor uses 2-3 second delays between requests. Running multiple concurrent instances may trigger server-side rate limiting. - **No historical data**: The directory reflects current WKO membership status only. - **German content**: All data is in German as published by WKO. - **Proxy recommended for bulk**: For runs with 500+ companies, using Apify Proxy (residential) is recommended to avoid IP-based throttling. # Actor input Schema ## `searchQuery` (type: `string`): Keyword search for company name or service (e.g., 'Software', 'Gastronomie', 'Steuerberater') ## `branche` (type: `string`): Industry or trade classification to search for (e.g., 'IT-Dienstleistung', 'Gastronomie', 'Tischlerei', 'Elektrotechnik'). This is used as the primary search term on firmen.wko.at. ## `bundesland` (type: `string`): Austrian federal state to filter results. Leave empty for all of Austria. ## `bezirk` (type: `string`): District within the selected Bundesland (e.g., 'Innere Stadt', 'Linz-Land', 'Hallein'). Only works when Bundesland is also set. ## `maxResults` (type: `integer`): Maximum number of company records to return. The actor stops after reaching this limit. Default: 100. Set higher for bulk extraction. ## `proxyConfiguration` (type: `object`): Apify Proxy configuration. Recommended for large-scale scraping to avoid rate limiting. ## Actor input object example ```json { "searchQuery": "IT-Dienstleistung", "bundesland": "", "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `companies` (type: `string`): Structured company data including names, addresses, phone numbers, emails, websites, trade licenses, and industry codes from the WKO business directory. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQuery": "IT-Dienstleistung", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("minute_contest/wko-business-directory-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQuery": "IT-Dienstleistung", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("minute_contest/wko-business-directory-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 '{ "searchQuery": "IT-Dienstleistung", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call minute_contest/wko-business-directory-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=minute_contest/wko-business-directory-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Austria WKO Business Directory Scraper", "description": "Scrape 620,000+ Austrian businesses from WKO Firmen A-Z - the official Chamber of Commerce directory. Get company names, addresses, phone numbers, emails, websites, industry codes, and trade licenses. No API exists for this data.", "version": "1.0", "x-build-id": "mseK5kAyV2wqlj3kw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/minute_contest~wko-business-directory-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-minute_contest-wko-business-directory-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/minute_contest~wko-business-directory-scraper/runs": { "post": { "operationId": "runs-sync-minute_contest-wko-business-directory-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/minute_contest~wko-business-directory-scraper/run-sync": { "post": { "operationId": "run-sync-minute_contest-wko-business-directory-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": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Keyword search for company name or service (e.g., 'Software', 'Gastronomie', 'Steuerberater')" }, "branche": { "title": "Industry / Branche", "type": "string", "description": "Industry or trade classification to search for (e.g., 'IT-Dienstleistung', 'Gastronomie', 'Tischlerei', 'Elektrotechnik'). This is used as the primary search term on firmen.wko.at." }, "bundesland": { "title": "Bundesland (State)", "enum": [ "", "Wien", "Niederösterreich", "Oberösterreich", "Steiermark", "Tirol", "Salzburg", "Kärnten", "Burgenland", "Vorarlberg" ], "type": "string", "description": "Austrian federal state to filter results. Leave empty for all of Austria.", "default": "" }, "bezirk": { "title": "Bezirk (District)", "type": "string", "description": "District within the selected Bundesland (e.g., 'Innere Stadt', 'Linz-Land', 'Hallein'). Only works when Bundesland is also set." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of company records to return. The actor stops after reaching this limit. Default: 100. Set higher for bulk extraction.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify Proxy configuration. Recommended for large-scale scraping to avoid rate limiting." } } }, "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 } } } } } } } } } } ```