# Unternehmensregister Company and Financial Metadata (`dominic-quaiser/unternehmensregister-scraper`) Actor

Extract German company profiles from Unternehmensregister by company name, EUID, or register number. Get legal forms, registered offices, register details, and optional financial filing metadata. Download selected free register extracts as PDF or XML when available. Returns one company per lookup.

- **URL**: https://apify.com/dominic-quaiser/unternehmensregister-scraper.md
- **Developed by:** [Dominic M. Quaiser](https://apify.com/dominic-quaiser) (community)
- **Features:** Limited permissions, Single-tenant, Server interface
- **Stats:** 7 total users, 2 monthly users, 81.9% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $18.00 / 1,000 company results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### 💡 What does Unternehmensregister Scraper do?

Look up a German company in `unternehmensregister.de` and get its **company profile, register identity, and register-document availability**. Search by company name, EUID (European Unique Identifier), register number with court and type, or location filters.

Each search returns **one company**. You can also enable financial-record listings to see accounting publication and deposited-account metadata, or request selected free register extracts as PDF or XML files.

The Actor provides company data through Apify's Console and API without a Unternehmensregister account. Financial listings contain metadata only: it does not extract revenue, profit, balance-sheet figures, officers, or shareholders, and it never purchases documents.

#### Why use this Actor?

- Enrich company databases with registered names, legal forms, and EUIDs.
- Check company identities against their register court, type, and number.
- Track listed accounting publications and deposited accounts, including their reporting periods and dates.
- Check register-extract availability and request selected free files when the source permits retrieval.

### 🔌 How to scrape Unternehmensregister on Apify

1. Open the Actor in Apify Console and go to **Input**.
2. Enter a company name, or switch to JSON input and paste an example below. For an EUID-only search, clear any prefilled company name.
3. Leave financial listings and document downloads off for a basic company lookup. Enable them if you need the additional results.
4. Click **Start** and wait for the run to finish.
5. Open **Output** to view the company profile. Open the run's default dataset to export the results.

Apify datasets support [JSON, CSV, Excel, and other export formats](https://docs.apify.com/storage/dataset). JSON preserves the nested financial-record and document details.

#### Search by company name

```json
{
  "company_name": "Katjes Fassin Immobilien GmbH",
  "exact_match": true
}
```

Exact matching checks the listed current or historical company name. Use the full name: `Siemens AG` and `Siemens Aktiengesellschaft` are different names.

#### Search by EUID or register identity

An EUID is useful when companies have similar names:

```json
{
  "euid": "DER1304.HRB19107"
}
```

Alternatively, supply all three register fields. Enter the number as a string without the register type:

```json
{
  "register_number": "19107",
  "register_type": "HRB",
  "register_court": "Kleve"
}
```

#### Include financial-record listings

```json
{
  "company_name": "Katjes Fassin Immobilien GmbH",
  "exact_match": true,
  "include_financial_records": true,
  "max_financial_records": 50,
  "max_pages": 5
}
```

This adds publication and deposit titles, reporting periods when recognized, listing dates, and available formats. It does not download financial documents. Records are sorted by publication or deposit date, newest first, and share one combined output limit.

### ⚙️ Input reference

See the Actor's **Input** tab for the configuration form and JSON editor.

Provide at least one company name, EUID, complete register identity, or registered-office/address criterion. State, legal form, and court filters alone are not enough to start a search. Empty strings are ignored; unknown fields and invalid types produce an input error.

#### Company search

| Field | Default | Description |
| --- | --- | --- |
| `company_name` | Unset | Company name or keywords. The input form prefills an example company. |
| `euid` | Unset | German EUID, such as `DER1304.HRB19107`. |
| `exact_match` | `false` | Require an exact current or historical name; needs `company_name`. |
| `registered_office` | Unset | Filter by registered-office location. |
| `register_number` | Unset | Register number; requires `register_type` and `register_court`. |
| `register_type` | `"alle"` | All offered registers, or `HRA`, `HRB`, `GnR`, `PR`, or `GsR`. |
| `register_court` | Unset | Court name or official code, such as `Kleve` or `R1304`. |
| `legal_form` | Unset | Legal-form name, abbreviation, or site ID, such as `GmbH`. |
| `federal_states` | `[]` | List of state names or abbreviations, such as `["NRW", "BY"]`. |
| `postal_code` | Unset | Postal-code filter, as a string. |
| `city` | Unset | Address-city filter. |
| `street` | Unset | Address-street filter. |
| `include_deleted` | `false` | Include closed register entries and deleted branches. |
| `hide_branches` | `false` | Request that the source search hide branches. |

Court names, legal forms, and states are resolved against the website's current filter lists. Both `München` and `Muenchen` are accepted. Unknown or ambiguous values return an error, with suggestions when available. `VR`, phonetic search, and OR-keyword search are unsupported.

**A broad search still returns only the first matching company on the first source page.** It does not collect all companies in a city or state. Use an EUID or complete register identity to make the selection more specific. `page_size` affects the source page; it does not increase the number of company profiles returned.

#### Financial listings and document downloads

| Field | Default | Description |
| --- | --- | --- |
| `include_financial_records` | `false` | Include financial listing metadata. |
| `max_financial_records` | `50` | Combined publication/deposit cap, from 1 to 1000. |
| `max_pages` | `5` | Maximum publication pages to fetch, from 1 to 100. |
| `page_size` | `100` | Source page size: 5, 10, 20, 30, 50, or 100. |
| `download_register_documents` | `false` | Download selected extracts that are free at the source. Adds $0.02 per result on Free when at least one file is saved; subscription discounts apply. |
| `register_document_types` | `["AD"]` | Extracts to download: `AD`, `CD`, `HD`, or `SI`. Used only when downloads are enabled. |
| `max_document_size_mb` | `20` | Maximum decoded file size per extract in MiB, from 1 to 50. |

#### Timeouts, retries, and proxies

| Field | Default | Description |
| --- | --- | --- |
| `request_timeout_secs` | `30` | Timeout per HTTP request, from 5 to 120 seconds. |
| `search_timeout_secs` | `120` | Whole search timeout, including retries, from 10 to 600 seconds. |
| `max_retries` | `2` | Retries for connection failures, timeouts, blocking, rate limits, and temporary server errors, from 0 to 5. Each proxy retry uses a fresh session. |
| `request_interval_secs` | `2` | Minimum interval between source requests per search, from 0 to 10 seconds. |
| `proxyConfiguration` | `{"useApifyProxy": true, "apifyProxyGroups": []}` | Apify datacenter proxies with automatic group selection. Supports custom proxy URLs and other Apify proxy groups. |
| `proxy_url` | Unset | Optional direct HTTP(S) proxy URL. Supply either this field or `proxyConfiguration`, not both. |

Apify datacenter proxies are enabled by default for both normal runs and Standby requests. On a retryable request failure, the Actor closes the HTTP client, requests a fresh proxy session, and restarts the lookup with new cookies and search tokens. With `max_retries: 2`, it makes at most three lookup attempts within `search_timeout_secs`. Completed downloads are retained, and only the final result is published and billed.

To use direct access, set `"proxyConfiguration": {"useApifyProxy": false}`. To rotate your own proxies, use `"proxyConfiguration": {"useApifyProxy": false, "proxyUrls": ["http://first.example:8000", "http://second.example:8000"]}`. A single `proxy_url` uses the same proxy for its retries. New Apify session IDs request a new route; the available proxy pool determines the exit IP.

### 📦 Output and completeness

A successful normal run stores one profile in the default dataset and the same JSON in the default key-value store under `OUTPUT`. If the search fails, the run fails and `OUTPUT` contains a structured error instead of a profile.

You can download the dataset in formats such as [JSON, HTML, CSV, or Excel](https://docs.apify.com/storage/dataset).

#### What data can you extract?

| Field                  | Type             | Contents                                                                                                                                                                         |
| ---------------------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `schema_version`       | String           | Output contract version, currently `"1.0"`.                                                                                                                                      |
| `company`              | Object           | Name, EUID, registered office, legal form, register court/type/number, state, active/deleted/unknown status, update date, branch flag, and listed historical names or locations. |
| `match`                | Object           | Selection strategy, matching candidates on the first page, source-reported total, and source limit flag.                                                                         |
| `register_information` | Object           | Document availability, register search page, locking information, and download results when requested.                                                                           |
| `financial_records`    | Object           | Listing records, returned count, section status, pagination summaries, and truncation flag when requested.                                                                       |
| `source`               | Object           | Source URL, search criteria without proxy credentials, UTC retrieval time, access method, and HTTP request count.                                                                |
| `status`               | String           | Overall `complete` or `partial`.                                                                                                                                                 |
| `warnings`             | Array of objects | Section-specific warning codes and messages.                                                                                                                                     |

Missing source values are omitted. Financial records use `record_type: "publication"` or `"deposit"`. Publications can include category, type, language, correction details, and PDF/XML/ESEF availability. Deposits can include year, balance-sheet and deposit dates, amendment details, and `document_access: "purchase_required"`. This value describes access on the source website; the Actor does not make a purchase.

#### Example result

This captured result corresponds to the financial-listing input above. Values and record availability can change on later runs.

```json
{
  "schema_version": "1.0",
  "company": {
    "name": "Katjes Fassin Immobilien GmbH",
    "euid": "DER1304.HRB19107",
    "registered_office": "Emmerich am Rhein",
    "legal_form": {
      "id": 9,
      "name": "Gesellschaft mit beschränkter Haftung",
      "abbreviation": "GmbH"
    },
    "register": {"court": "Kleve", "court_code": "R1304", "type": "HRB", "number": "19107"},
    "state": {"name": "Nordrhein-Westfalen", "code": "NW"},
    "status": "active",
    "last_updated": "2023-10-05",
    "has_branches": false,
    "history": [{"name": "Katjes Fassin Immobilien GmbH", "registered_office": "Emmerich am Rhein"}]
  },
  "match": {
    "strategy": "first_company_in_source_order",
    "company_candidates_on_page": 1,
    "multiple_candidates_on_page": false,
    "source_reported_total_items": 121,
    "source_limit_reached": false
  },
  "register_information": {
    "status": "complete",
    "search_page": "https://www.unternehmensregister.de/de/suche/registerinformationen",
    "documents": [
      {"type": "AD", "name": "Current register extract", "available": true},
      {"type": "CD", "name": "Chronological register extract", "available": true},
      {"type": "HD", "name": "Historical register extract", "available": false},
      {"type": "DK", "name": "Filed register documents", "available": true},
      {"type": "UT", "name": "Company holder information", "available": true},
      {"type": "SI", "name": "Structured register information", "available": true}
    ],
    "locking_status": "Freigegeben"
  },
  "financial_records": {
    "enabled": true,
    "status": "complete",
    "records": [
      {
        "id": "154a9310-3698-49ee-910b-cdeb3f4b3dfa",
        "record_type": "deposit",
        "title": "Jahresabschluss zum Geschäftsjahr vom 01.01.2024 bis zum 31.12.2024",
        "company_name": "Katjes Fassin Immobilien GmbH",
        "company_match": "selected_company",
        "year": 2024,
        "reporting_period": {"start": "2024-01-01", "end": "2024-12-31"},
        "balance_sheet_date": "2024-12-31",
        "deposit_date": "2026-01-15",
        "source": "Unternehmensregister",
        "amended_by": [],
        "amendment_of": [],
        "document_access": "purchase_required"
      },
      {
        "id": "686dc796-0549-49c1-8d33-33f8cf69db69",
        "record_type": "deposit",
        "title": "Jahresabschluss zum Geschäftsjahr vom 01.01.2023 bis zum 31.12.2023",
        "company_name": "Katjes Fassin Immobilien GmbH",
        "company_match": "selected_company",
        "year": 2023,
        "reporting_period": {"start": "2023-01-01", "end": "2023-12-31"},
        "balance_sheet_date": "2023-12-31",
        "deposit_date": "2025-01-31",
        "source": "Unternehmensregister",
        "amended_by": [],
        "amendment_of": [],
        "document_access": "purchase_required"
      }
    ],
    "returned_count": 2,
    "truncated": false,
    "deposits": {"status": "complete", "listed_count": 2, "document_access": "purchase_required"},
    "publications": {
      "status": "complete",
      "pages_fetched": 1,
      "total_pages": 0,
      "source_reported_total_results": 0,
      "source_limit_reached": false,
      "listed_count": 0
    }
  },
  "source": {
    "name": "Unternehmensregister",
    "url": "https://www.unternehmensregister.de/de",
    "query": {"company_name": "Katjes Fassin Immobilien GmbH", "exact_match": true},
    "retrieved_at": "2026-10-11T14:34:30.777277+00:00",
    "method": "http",
    "requests_made": 6
  },
  "status": "complete",
  "warnings": []
}
```

#### How to assess completeness

- Top-level `status: "complete"` means no section request failed. It does not guarantee every financial record was collected.
- `financial_records.status: "not_requested"` means financial listings were disabled. Its empty `records` array does not mean the company has no filings.
- `financial_records.status: "limited"` or `truncated: true` indicates an output cap, page limit, or source limit. Increase the relevant input limits if you need a broader scan; source limits may still apply.
- `status: "partial"` and `warnings` identify enrichment or download failures. The company profile and any collected records remain available.

Source-reported totals can include publications and related-company headers, so they are not counts of matching companies. Accounting searches can also return related companies' publications. Use `company_match` to distinguish `current_name`, `historical_name`, and `related_search_result`; deposits use `selected_company`. Filter out `related_search_result` if you need records only under the selected company's names.

Publication IDs are derived from visible listing metadata. Deposit IDs come from the website and may change between sessions; do not rely on them alone to deduplicate repeated runs.

### 📄 Optional register-file downloads

Enable downloads explicitly and choose the extracts you need:

```json
{
  "euid": "DER1304.HRB19107",
  "download_register_documents": true,
  "register_document_types": ["AD", "SI"]
}
```

| Type | Extract | File format |
| --- | --- | --- |
| `AD` | Current register extract | PDF |
| `CD` | Chronological register extract | PDF |
| `HD` | Historical register extract | PDF |
| `SI` | Structured register information | XML |

`DK` and `UT` availability is reported, but their browsing views are not supported for automatic download. Financial publications and deposited accounts are never downloaded. Downloaded SI files are stored as XML; their contents are not parsed into the company profile.

**Availability still does not guarantee retrieval:** unsupported or rejected verification returns `verification_required`. If Unternehmensregister cannot reach the register portal, downloads return `failed` with a `register_portal_unavailable` warning (`NO_RESPONSE`, HTTP 520); retry later. Company metadata and files already saved remain available.

### ❓ FAQ and troubleshooting

#### Can I get every company matching a search?

Each lookup selects one company from the first source page. For a known list of companies, send a separate EUID or register-identity lookup for each one. Broad searches are useful for locating a company, but do not produce a bulk company directory.

#### Can I download annual accounts or financial statements?

The Actor lists their metadata when `include_financial_records` is enabled. It does not retrieve financial-document contents or purchase deposited accounts. The download option applies only to the selected free register extracts described above.

#### What should I do if a run fails?

| Error or symptom | What to check |
| --- | --- |
| `invalid_input` / HTTP 400 | Supply a search criterion, use the documented field names and types, and include court and type with a register number. |
| `no_results` / HTTP 404 | Check the full registered name or EUID. Try disabling exact matching, removing extra filters, or enabling `include_deleted` if appropriate. Only the first source page is searched for company matches. |
| `access_blocked` / HTTP 503 | The source refused access or required verification. Retry later; a proxy does not guarantee access. |
| `upstream_timeout` / HTTP 504 | Increase the search or request timeout within its allowed range, or reduce the financial scan size. |
| `unexpected_response` or `upstream_error` / HTTP 502 | The source response could not be processed. Retry later and report persistent failures. |
| `charge_limit` / HTTP 402 | The remaining maximum charge cannot cover another company result. Increase the next run's limit. |
| `download_budget_exceeded` warning | Only the base fee fit the remaining budget. Metadata was returned; downloads were skipped without a surcharge. |
| `billing_configuration` / HTTP 500 | The publisher must enable pay-per-event pricing, configure both events in Apify Console, and verify their effective run prices. |
| `billing_failed` / HTTP 500 | Check the dataset and charges before starting another run. An uncertain dataset write is not repeated automatically. |
| Financial records are empty | Check `financial_records.enabled`, section status, and `warnings` to distinguish disabled listings, no records, and failed requests. |
| A document is available but no file was saved | Check `download.status`, `download_summary`, and `warnings`. `register_portal_unavailable` means Unternehmensregister could not reach its register-file provider; retry later. |

These HTTP codes describe the Standby API. Normal runs report search failures through the run status and the `OUTPUT` error record. Standby errors use this structure:

```json
{
  "error": {
    "status_code": 404,
    "code": "no_results",
    "message": "No company profiles found for the supplied search criteria."
  }
}
```

### 🛠️ Maintainer

For help or feedback, use the **Issues** tab on the Actor's Apify page and include the run URL or ID, your search input without secrets, and the error code or warning. Results reflect what Unternehmensregister lists at retrieval time; missing fields and incomplete scans should be considered when using the data.

- **Author**: Dominic M. Quaiser
- **Contact**: <dev@krake.run>
- **Website**: [krake.run](https://krake.run/)

# Actor input Schema

## `company_name` (type: `string`):

Selects the first company in the site's result order. Use an EUID or register filters to disambiguate.

## `euid` (type: `string`):

German company EUID, for example DER1304.HRB19107.

## `exact_match` (type: `boolean`):

Use the site's exact company-name search.

## `registered_office` (type: `string`):

Filter by the registered-office location.

## `register_number` (type: `string`):

Requires register_type and register_court.

## `register_type` (type: `string`):

The registers offered by Unternehmensregister.

## `register_court` (type: `string`):

Court name (Kleve, München, Berlin (Charlottenburg)) or its official code. Names are resolved from the live website.

## `legal_form` (type: `string`):

A legal-form name, abbreviation or site ID, such as GmbH, KG or 9.

## `federal_states` (type: `array`):

State names or abbreviations, such as Nordrhein-Westfalen, NRW, NW, BY or BE.

## `postal_code` (type: `string`):

Postal-code filter.

## `city` (type: `string`):

Address-city filter.

## `street` (type: `string`):

Address-street filter.

## `include_deleted` (type: `boolean`):

Include closed register entries and deleted branches.

## `hide_branches` (type: `boolean`):

Hide branches in the website search.

## `include_financial_records` (type: `boolean`):

List public accounting-publication and deposited-account metadata. Does not download content or buy documents.

## `max_financial_records` (type: `integer`):

Combined cap for publication and deposit metadata, newest publication/deposit date first.

## `max_pages` (type: `integer`):

Limits publication pagination. Output reports incomplete scans.

## `page_size` (type: `integer`):

Results per website page: 5, 10, 20, 30, 50 or 100.

## `request_timeout_secs` (type: `integer`):

Time limit for each HTTP request.

## `search_timeout_secs` (type: `integer`):

Time limit for the complete metadata search, including retries.

## `max_retries` (type: `integer`):

Retries for network errors, rate limits, blocking and temporary server failures. With proxyConfiguration, each retry restarts the lookup using a fresh proxy session; direct access and a single proxy_url retry on the same route. Zero disables retries.

## `request_interval_secs` (type: `number`):

Minimum interval between public website requests per search.

## `proxyConfiguration` (type: `object`):

Apify datacenter proxies are enabled by default (automatic group selection). Failed requests restart the lookup with a fresh proxy session. Supply custom proxy URLs or set useApifyProxy to false for direct access.

## `proxy_url` (type: `string`):

Optional HTTP(S) proxy for standalone usage. Use either this field or an enabled proxyConfiguration.

## `download_register_documents` (type: `boolean`):

Opt in to downloading selected register extracts that are free at the source. On Apify Free, an extra $0.02 is charged once per result with at least one file successfully saved and linked, regardless of file count ($0.05 including the base fee). Starter/Bronze, Scale/Silver and Business/Gold discounts of 20%, 30% and 40% apply to both fees. If only your plan's base fee fits the run budget, downloads are skipped with a warning. Financial documents are never downloaded.

## `register_document_types` (type: `array`):

AD (current PDF), CD (chronological PDF), HD (historical PDF) or SI (structured XML). Only used when download_register_documents is true. DK and UT open separate browsing views and are not supported for automatic download.

## `max_document_size_mb` (type: `integer`):

Maximum decoded file size per register extract. Oversized files are rejected without saving them.

## Actor input object example

```json
{
  "company_name": "Katjes Fassin Immobilien GmbH",
  "euid": "",
  "exact_match": false,
  "registered_office": "",
  "register_number": "",
  "register_type": "alle",
  "register_court": "",
  "legal_form": "",
  "federal_states": [],
  "postal_code": "",
  "city": "",
  "street": "",
  "include_deleted": false,
  "hide_branches": false,
  "include_financial_records": true,
  "max_financial_records": 50,
  "max_pages": 5,
  "page_size": 100,
  "request_timeout_secs": 30,
  "search_timeout_secs": 120,
  "max_retries": 2,
  "request_interval_secs": 2,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": []
  },
  "proxy_url": "",
  "download_register_documents": false,
  "register_document_types": [
    "AD"
  ],
  "max_document_size_mb": 20
}
```

# Actor output Schema

## `profiles` (type: `string`):

One company per successful search, with financial listing metadata.

## `output` (type: `string`):

Normal runs store the profile or a structured error in OUTPUT. Standby responses are stored in the dataset.

## `documents` (type: `string`):

Opt-in free register extracts use REGISTER- keys. The dataset links each downloaded file to its register entry.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "company_name": "Katjes Fassin Immobilien GmbH",
    "euid": "",
    "registered_office": "",
    "register_number": "",
    "register_court": "",
    "legal_form": "",
    "federal_states": [],
    "postal_code": "",
    "city": "",
    "street": "",
    "proxy_url": ""
};

// Run the Actor and wait for it to finish
const run = await client.actor("dominic-quaiser/unternehmensregister-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "company_name": "Katjes Fassin Immobilien GmbH",
    "euid": "",
    "registered_office": "",
    "register_number": "",
    "register_court": "",
    "legal_form": "",
    "federal_states": [],
    "postal_code": "",
    "city": "",
    "street": "",
    "proxy_url": "",
}

# Run the Actor and wait for it to finish
run = client.actor("dominic-quaiser/unternehmensregister-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "company_name": "Katjes Fassin Immobilien GmbH",
  "euid": "",
  "registered_office": "",
  "register_number": "",
  "register_court": "",
  "legal_form": "",
  "federal_states": [],
  "postal_code": "",
  "city": "",
  "street": "",
  "proxy_url": ""
}' |
apify call dominic-quaiser/unternehmensregister-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dominic-quaiser/unternehmensregister-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/RI6LsfcpXqyJs8G2B/builds/g6cYsx1Iq08CA8xh7/openapi.json
