# Zefix Scraper - Swiss Company Registry Data (`studio-amba/zefix-scraper`) Actor Scrape Swiss company data from the Zefix central business name index. Search by company name, UID (CHE number), or canton. Extract company name, legal form, purpose, address, and registration details from Switzerland's official commercial register. No login required. - **URL**: https://apify.com/studio-amba/zefix-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** Business, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Zefix Scraper - Swiss Company Registry Data Extract structured company data from Zefix (Zentraler Firmenindex), Switzerland's official central business name index operated by the Federal Office of Justice. Searches all 26 cantonal commercial registers in one query. No cookies, no login required. ### How to scrape Zefix data This actor queries the official Swiss government Linked Data service (LINDAS) to extract company information from the Zefix central business name index. The data is updated daily and covers all active legal entities registered in Switzerland's commercial register system. #### Search by company name Enter a company name or keyword in the **Search Query** field. The actor searches across all registered company names in Switzerland. Minimum 3 characters. Examples: - `zurich` -- find companies with "zurich" in their name - `novartis` -- find Novartis and related entities - `blockchain` -- find blockchain-related companies #### Look up by UID (CHE number) Every Swiss company has a unique UID number (Unternehmens-Identifikationsnummer). Enter it in the **UID** field to get a specific company's full details. Accepts multiple formats: - `CHE-123.456.789` (formatted) - `CHE123456789` (compact) - `123456789` (digits only) #### Filter by canton Narrow your search to a specific Swiss canton using the dropdown. All 26 cantons are supported: AG, AI, AR, BE, BL, BS, FR, GE, GL, GR, JU, LU, NE, NW, OW, SG, SH, SO, SZ, TG, TI, UR, VD, VS, ZG, ZH. #### Filter by legal form Filter by legal form code (eCH-0097 standard). Common codes: | Code | Legal Form (German) | Legal Form (English) | |------|---------------------|---------------------| | 0106 | Aktiengesellschaft (AG) | Corporation | | 0107 | Gesellschaft mit beschrankter Haftung (GmbH) | Limited liability company | | 0108 | Kommanditaktiengesellschaft | Limited partnership with shares | | 0109 | Einzelunternehmen | Sole proprietorship | | 0110 | Kollektivgesellschaft | General partnership | | 0111 | Auslandische Niederlassung | Foreign branch | | 0302 | Verein | Association | | 0327 | Stiftung | Foundation | ### What data does Zefix Scraper extract? | Field | Type | Description | |-------|------|-------------| | **companyName** | String | Company name (English translation if available) | | **legalName** | String | Official registered company name | | **uid** | String | Swiss UID number (CHE-XXX.XXX.XXX) | | **chid** | String | Old Swiss CH identification number | | **legalForm** | String | Legal form name in German | | **legalFormCode** | String | Legal form code (eCH-0097) | | **purpose** | String | Official company purpose from the commercial register | | **canton** | String | Two-letter canton code (ZH, BE, GE, etc.) | | **municipality** | String | Municipality where the company is registered | | **street** | String | Street address with house number | | **postalCode** | String | Swiss postal code (PLZ) | | **city** | String | City name | | **status** | String | Company status | | **zefixUrl** | String | Direct link to the company on zefix.ch | | **cantonalRegisterUrl** | String | Link to cantonal register entry | | **scrapedAt** | String | ISO 8601 extraction timestamp | ### Example output ```json { "companyName": "Zurich Convention Center Ltd.", "legalName": "Kongresshaus Zurich AG", "uid": "CHE-105.951.817", "chid": "CH02039026672", "legalForm": "Aktiengesellschaft", "legalFormCode": "0106", "purpose": "Betrieb des Kongresshauses Zurich...", "canton": "ZH", "municipality": "Zurich", "street": "Claridenstrasse 5", "postalCode": "8002", "city": "Zurich", "status": "active", "zefixUrl": "https://www.zefix.ch/en/search/entity/list/firm/19135", "cantonalRegisterUrl": "https://www.zefix.admin.ch/en/search/entity/list?name=CHE105951817&directLink=true", "scrapedAt": "2026-06-09T14:30:00.000Z" } ```` ### Data source This actor queries the LINDAS (Linked Data Service) SPARQL endpoint maintained by the Swiss Federal Archives. The data originates from the Federal Commercial Registry Office (EHRA) and is updated daily. It covers all active legal entities from all 26 cantonal commercial registers. The data is published under the OGD (Open Government Data) license -- open use with source attribution required. Source: Swiss Federal Office of Justice via opendata.swiss. ### Use cases - **B2B lead generation**: Find companies in specific cantons or industries by searching purpose descriptions - **Due diligence**: Look up company details, legal form, and registration data by UID - **Market research**: Map the Swiss corporate landscape by canton, legal form, or keyword - **Competitor analysis**: Search for companies in your sector across Switzerland - **CRM enrichment**: Feed a list of UIDs and get back full company profiles with addresses - **Compliance**: Verify company registration details against the official government source ### Technical details - **Data source**: LINDAS SPARQL endpoint (Swiss government Linked Data service) - **Authentication**: None required -- uses the publicly accessible open data endpoint - **Rate limiting**: The government endpoint is generally reliable but may throttle very large queries - **Update frequency**: Source data is updated daily by the Federal Commercial Registry Office - **Coverage**: All active legal entities in all 26 Swiss cantonal commercial registers ### Input example ```json { "searchQuery": "fintech", "canton": "ZH", "maxResults": 50 } ``` ### Cost of usage This actor uses the Apify platform. Proxy usage is optional since the LINDAS endpoint is a public government service. A typical run searching 100 companies takes under 30 seconds and costs minimal compute units. ### Is it legal to scrape Zefix? Yes. The Zefix data is published as Open Government Data (OGD) by the Swiss Federal Office of Justice under an open-use license. The LINDAS SPARQL endpoint is explicitly designed for programmatic access. Source attribution is required per the license terms. # Actor input Schema ## `searchQuery` (type: `string`): Company name or keyword to search. Minimum 3 characters. Defaults to 'zurich' if no UID is provided. ## `uid` (type: `string`): Look up a specific company by its Swiss UID number. Accepts formats: CHE-123.456.789, CHE123456789, or just 123456789. ## `canton` (type: `string`): Filter results by Swiss canton (two-letter code). ## `legalForm` (type: `string`): Filter results by legal form code (eCH-0097 standard). Common codes: 0106 = AG, 0107 = GmbH, 0109 = Einzelunternehmen, 0302 = Verein. ## `maxResults` (type: `integer`): Maximum number of companies to return. ## `proxyConfiguration` (type: `object`): Apify proxy configuration. The LINDAS SPARQL endpoint is a Swiss government service and usually does not require proxies. ## Actor input object example ```json { "searchQuery": "zurich", "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "CH" } } ``` # 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": "zurich", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "CH" } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/zefix-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": "zurich", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "CH", }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/zefix-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": "zurich", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "CH" } }' | apify call studio-amba/zefix-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/zefix-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Zefix Scraper - Swiss Company Registry Data", "description": "Scrape Swiss company data from the Zefix central business name index. Search by company name, UID (CHE number), or canton. Extract company name, legal form, purpose, address, and registration details from Switzerland's official commercial register. No login required.", "version": "0.0", "x-build-id": "OcDqw5TX1ZJ3Jwmof" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~zefix-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-zefix-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/studio-amba~zefix-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-zefix-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/studio-amba~zefix-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-zefix-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": "Company name or keyword to search. Minimum 3 characters. Defaults to 'zurich' if no UID is provided." }, "uid": { "title": "UID (CHE Number)", "type": "string", "description": "Look up a specific company by its Swiss UID number. Accepts formats: CHE-123.456.789, CHE123456789, or just 123456789." }, "canton": { "title": "Canton", "enum": [ "", "AG", "AI", "AR", "BE", "BL", "BS", "FR", "GE", "GL", "GR", "JU", "LU", "NE", "NW", "OW", "SG", "SH", "SO", "SZ", "TG", "TI", "UR", "VD", "VS", "ZG", "ZH" ], "type": "string", "description": "Filter results by Swiss canton (two-letter code)." }, "legalForm": { "title": "Legal Form", "type": "string", "description": "Filter results by legal form code (eCH-0097 standard). Common codes: 0106 = AG, 0107 = GmbH, 0109 = Einzelunternehmen, 0302 = Verein." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of companies to return.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy configuration. The LINDAS SPARQL endpoint is a Swiss government service and usually does not require proxies." } } }, "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 } } } } } } } } } } ```