Address Parser DACH

Raw DACH addresses -> street, ZIP, city, region, country and geocoding-ready fields.

What this Actor does

• Runs the exact address-parser-dach contract against only the inputs and sources documented below.
• Emits records that are validated against the bundled dataset schema before they are written.
• Keeps source references and stable record identifiers in the output when those fields are declared.
• Provides a bounded sample path for Store inspection; the sample path does not emit a paid event.

Inputs

• buyerQuery: Buyer-safe query or scope for the records returned by this product.
• taskIntent: Stable product-specific purpose for this saved Apify task.
• sourceMode: Sample emits public-safe Apify Actor Record rows. Approved live source mode keeps the same output fields and only uses owner-approved public URLs.
• outputMode: Use sample records for Apify Store QA or buyer-ready records for approved Apify Actor Record delivery.
• startUrls: Public URLs to use for live Apify Actor Record extraction after source-policy approval. Leave empty for sample mode.
• maxItems: Caps the number of Apify Actor Record rows written to the dataset.
• perSourceLimit: Caps validated rows from any one source before cross-source deduplication.
• maxTotalChargeUsd: Buyer-selected spend ceiling; the Apify run-level maximum remains authoritative.
• overallTimeoutSecs: Stops additional source work once the bounded run deadline is reached.
• requestTimeoutSecs: Timeout applied independently to each approved source request.
• maxRequestRetries: Bounded retry count for transient source failures.
• sinceLastRun: Uses stable Actor state to skip logical records delivered by earlier runs.
• deltaMode: Preserves stable deduplication keys for recurring tasks and schedules.

Sources and access boundary

• https://www.govdata.de/
• User-supplied public or authorized source URLs provided through startUrls; live mode fails closed when neither an approved fallback nor a supplied URL exists.

Only public or user-authorized inputs may be processed. The Actor does not bypass authentication, paywalls, CAPTCHAs, access controls, or source terms.

Output

The default dataset exposes these Actor-relevant fields:

• entityName: Public-safe entity or subject of the record.
• signalType: Buyer-facing signal category.
• recordId: Record Id value.
• sourceName: Source Name value.
• sourceUrl: Source Url value.
• retrievedAt: Retrieved At value.
• confidence: Normalized record confidence.
• errors: Errors value.
• runSummary: Run Summary value.

The output link exposed by .actor/OUTPUT_SCHEMA.json points to the default dataset: {{links.apiDefaultDatasetUrl}}/items.

Sample run

{
  "buyerQuery": "buyer-ready records with source evidence",
  "taskIntent": "buyer-ready-product-run",
  "sourceMode": "sample",
  "outputMode": "sample-records",
  "startUrls": [],
  "maxItems": 1,
  "perSourceLimit": 25,
  "maxTotalChargeUsd": 5,
  "overallTimeoutSecs": 900,
  "requestTimeoutSecs": 30,
  "maxRequestRetries": 2,
  "sinceLastRun": false,
  "deltaMode": true
}

Example fields from the bundled deterministic sample:

{
  "entityName": "Address Parser DACH sample",
  "signalType": "sample",
  "recordId": "address-parser-dach-sample-1",
  "sourceName": "Address Parser DACH",
  "sourceUrl": "https://www.govdata.de/",
  "retrievedAt": "2026-01-15T09:00:00Z",
  "confidence": 0.9,
  "errors": [],
  "runSummary": {}
}

Sample values are labeled as sample data and are not claims about a live source result.

Pricing and cost control

This source package preserves the Actor's current Apify pay-per-event configuration. The authenticated current event definitions are:

• result-delivered: Charged once for each validated buyer-facing result written to the dataset.

The per-result source event is result-delivered. Production output uses Apify's charged dataset push path and checks the returned charge limit before continuing. Sample, demo, test, and quality-validation paths do not emit a paid event. Start production runs with a small maxItems and an Apify run spending limit.

Reliability and limitations

• Live results depend on the supplied source availability and the fields the source actually returns.
• Missing values remain missing, null, or warning-backed according to the schema; they are not invented.
• A live run that cannot produce a schema-valid result fails instead of publishing a generic substitute.
• Output is decision-support data and does not replace legal, financial, medical, safety, procurement, or compliance review.

Existing public Actor identity

• Owner: zentrafoundry
• Actor ID: ixvlro4MZylJmltKB
• Slug: address-parser-dach
• Store URL: https://apify.com/zentrafoundry/address-parser-dach

This package updates that exact existing public Actor in place. It does not create, clone, upsert, duplicate, draft, privatize, or change pricing or visibility.