Zefix Company & Director Scraper

Search Switzerland's official Zefix company index by company name, CHE UID, or direct EHRAID. Export registry status, legal form, address, business purpose, SHAB publications, audit firms, branches, company relationships, and official management-change notices.

The Actor uses the structured REST endpoint used by the public Zefix website. It needs no browser, proxy, or Zefix API credentials.

Mobile proxies are intentionally not used for Zefix. The public structured endpoint works directly, and routing it through a paid mobile network would add cost and latency without improving the normal extraction path. If the endpoint's behavior changes in the future, proxy failover should be added only after production evidence shows it is needed.

What can you extract?

• Company name, translations, and former names
• CHE UID, CHID, EHRAID, and registry status
• Legal form in English, German, French, or Italian
• Registered address and legal seat
• Business purpose
• Latest and historical SHAB/FOSC publications
• Official management and governing-body change notices
• Audit firms, branches, main offices, mergers, and takeovers
• Cantonal registry excerpt and canonical Zefix links

Director data: an important distinction

Zefix does not expose a complete current director roster as a structured field. It publishes multilingual SHAB notices describing appointments, resignations, signing authority, and governing-body changes. This Actor returns those notices in managementChanges with their dates and source text. It does not guess a current director list from historical notices.

Input

{
  "searchTerms": ["Nestle"],
  "uids": ["CHE-107.028.276"],
  "searchType": "contains",
  "language": "en",
  "activeOnly": true,
  "includeDetails": true,
  "includeShab": true,
  "shabLimit": 20,
  "maxItems": 25
}

• searchTerms searches company names.
• uids performs exact CHE UID searches.
• ehraids fetches known Zefix entity IDs directly.
• cantons optionally filters searches using two-letter canton codes.
• includeDetails adds the complete entity record.
• shabLimit controls returned publication history per company.

Output

{
  "companyName": "Fondation Nestlé pour l'étude des problèmes de l'alimentation dans le monde",
  "translatedNames": ["Nestlé Foundation for the study of the problems of nutrition in the world"],
  "ehraid": 284234,
  "uid": "CHE107028276",
  "uidFormatted": "CHE-107.028.276",
  "legalForm": "Foundation",
  "status": "EXISTIEREND",
  "isActive": true,
  "legalSeat": "Lausanne",
  "address": {
    "street": "Avenue de Rosemont",
    "houseNumber": "5",
    "postalCode": "1006",
    "town": "Lausanne",
    "country": "CH"
  },
  "purpose": "Company purpose from the registry",
  "latestShabDate": "2025-06-25",
  "managementChanges": [
    {
      "date": "2024-12-06",
      "mutationTypes": ["aenderungorgane"],
      "message": "Official publication text describing a management change."
    }
  ],
  "cantonalExcerptUrl": "https://prestations.vd.ch/...",
  "zefixUrl": "https://www.zefix.ch/en/search/entity/list/firm/284234",
  "source": "Zefix public website REST API",
  "scrapedAt": "2026-07-29T12:00:00.000Z"
}

Pay-per-event pricing

Configure these events in Apify Console:

Event name	Title	Description	Recommended price
company-result	Company result	One structured Zefix company registry record saved to the dataset.	$0.001

Keep apify-actor-start at $0.00005. Remove apify-default-dataset-item to avoid charging twice for the same record.

API

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("dariomory/zefix-company-director-scraper").call(run_input={
    "searchTerms": ["Nestle"],
    "maxItems": 10,
    "includeDetails": True,
})

print(run["defaultDatasetId"])

Limits

• Zefix search pages return at most 30 records per API request; the Actor paginates automatically.
• Registry publication text can be German, French, Italian, or Romansh depending on the canton.
• activeOnly excludes deleted entities after retrieval.
• Be considerate when requesting large datasets from this public government service.

This Actor is independent and is not affiliated with or endorsed by Zefix or the Swiss federal commercial-register authorities.