Unternehmensregister Company and Financial Metadata
Pricing
from $18.00 / 1,000 company results
Unternehmensregister Company and Financial Metadata
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.
Pricing
from $18.00 / 1,000 company results
Rating
0.0
(0)
Developer
Dominic M. Quaiser
Maintained by CommunityActor stats
0
Bookmarked
7
Total users
2
Monthly active users
a month ago
Last modified
Categories
Features
Share
💡 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
- Open the Actor in Apify Console and go to Input.
- Enter a company name, or switch to JSON input and paste an example below. For an EUID-only search, clear any prefilled company name.
- Leave financial listings and document downloads off for a basic company lookup. Enable them if you need the additional results.
- Click Start and wait for the run to finish.
- 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. JSON preserves the nested financial-record and document details.
Search by company name
{"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:
{"euid": "DER1304.HRB19107"}
Alternatively, supply all three register fields. Enter the number as a string without the register type:
{"register_number": "19107","register_type": "HRB","register_court": "Kleve"}
Include financial-record listings
{"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.
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.
{"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 emptyrecordsarray does not mean the company has no filings.financial_records.status: "limited"ortruncated: trueindicates 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"andwarningsidentify 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:
{"euid": "DER1304.HRB19107","download_register_documents": true,"register_document_types": ["AD", "SI"]}
| Type | Extract | File format |
|---|---|---|
AD | Current register extract | |
CD | Chronological register extract | |
HD | Historical register extract | |
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:
{"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