Unternehmensregister Company and Financial Metadata avatar

Unternehmensregister Company and Financial Metadata

Pricing

from $18.00 / 1,000 company results

Go to Apify Store
Unternehmensregister Company and Financial Metadata

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

Dominic M. Quaiser

Maintained by Community

Actor stats

0

Bookmarked

7

Total users

2

Monthly active users

a month ago

Last modified

Categories

Features

Limited permissionsSingle-tenantServer interface

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

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

FieldDefaultDescription
company_nameUnsetCompany name or keywords. The input form prefills an example company.
euidUnsetGerman EUID, such as DER1304.HRB19107.
exact_matchfalseRequire an exact current or historical name; needs company_name.
registered_officeUnsetFilter by registered-office location.
register_numberUnsetRegister number; requires register_type and register_court.
register_type"alle"All offered registers, or HRA, HRB, GnR, PR, or GsR.
register_courtUnsetCourt name or official code, such as Kleve or R1304.
legal_formUnsetLegal-form name, abbreviation, or site ID, such as GmbH.
federal_states[]List of state names or abbreviations, such as ["NRW", "BY"].
postal_codeUnsetPostal-code filter, as a string.
cityUnsetAddress-city filter.
streetUnsetAddress-street filter.
include_deletedfalseInclude closed register entries and deleted branches.
hide_branchesfalseRequest 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

FieldDefaultDescription
include_financial_recordsfalseInclude financial listing metadata.
max_financial_records50Combined publication/deposit cap, from 1 to 1000.
max_pages5Maximum publication pages to fetch, from 1 to 100.
page_size100Source page size: 5, 10, 20, 30, 50, or 100.
download_register_documentsfalseDownload 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_mb20Maximum decoded file size per extract in MiB, from 1 to 50.

Timeouts, retries, and proxies

FieldDefaultDescription
request_timeout_secs30Timeout per HTTP request, from 5 to 120 seconds.
search_timeout_secs120Whole search timeout, including retries, from 10 to 600 seconds.
max_retries2Retries for connection failures, timeouts, blocking, rate limits, and temporary server errors, from 0 to 5. Each proxy retry uses a fresh session.
request_interval_secs2Minimum 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_urlUnsetOptional 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?

FieldTypeContents
schema_versionStringOutput contract version, currently "1.0".
companyObjectName, EUID, registered office, legal form, register court/type/number, state, active/deleted/unknown status, update date, branch flag, and listed historical names or locations.
matchObjectSelection strategy, matching candidates on the first page, source-reported total, and source limit flag.
register_informationObjectDocument availability, register search page, locking information, and download results when requested.
financial_recordsObjectListing records, returned count, section status, pagination summaries, and truncation flag when requested.
sourceObjectSource URL, search criteria without proxy credentials, UTC retrieval time, access method, and HTTP request count.
statusStringOverall complete or partial.
warningsArray of objectsSection-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 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:

{
"euid": "DER1304.HRB19107",
"download_register_documents": true,
"register_document_types": ["AD", "SI"]
}
TypeExtractFile format
ADCurrent register extractPDF
CDChronological register extractPDF
HDHistorical register extractPDF
SIStructured register informationXML

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

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 symptomWhat to check
invalid_input / HTTP 400Supply a search criterion, use the documented field names and types, and include court and type with a register number.
no_results / HTTP 404Check 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 503The source refused access or required verification. Retry later; a proxy does not guarantee access.
upstream_timeout / HTTP 504Increase the search or request timeout within its allowed range, or reduce the financial scan size.
unexpected_response or upstream_error / HTTP 502The source response could not be processed. Retry later and report persistent failures.
charge_limit / HTTP 402The remaining maximum charge cannot cover another company result. Increase the next run's limit.
download_budget_exceeded warningOnly the base fee fit the remaining budget. Metadata was returned; downloads were skipped without a surcharge.
billing_configuration / HTTP 500The publisher must enable pay-per-event pricing, configure both events in Apify Console, and verify their effective run prices.
billing_failed / HTTP 500Check the dataset and charges before starting another run. An uncertain dataset write is not repeated automatically.
Financial records are emptyCheck financial_records.enabled, section status, and warnings to distinguish disabled listings, no records, and failed requests.
A document is available but no file was savedCheck 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.