EU Companies Registry Scraper (DE / FR / NL)

Unified scraper for public company registers across three EU jurisdictions:

Country	Source	Notes
🇩🇪 Germany	handelsregister.de	Full Schlagwort search (JSF form), residential DE IP required
🇫🇷 France	recherche-entreprises.api.gouv.fr	Official government open API, no key, very rich data
🇳🇱 Netherlands	kvk.nl	Public search via internal JSON endpoint (HTML fallback)

Features

• Bulk search by {query, country} pairs
• Unified output schema — same fields across all three sources
• Rich data from FR API: registration number (SIREN), legal form, full address, status, directors with roles, NACE codes, employee range, last INSEE update
• Pagination until your maxResultsPerQuery or end of results
• Residential proxy support — KvK and Handelsregister geofence/rate-limit aggressive IPs

Input

{
  "queries": [
    { "query": "BNP Paribas", "country": "FR" },
    { "query": "Volkswagen",  "country": "DE" },
    { "query": "Shell",       "country": "NL" }
  ],
  "maxResultsPerQuery": 20,
  "proxyConfig": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Field	Type	Default	Notes
queries	array	(required)	{query, country} pairs
maxResultsPerQuery	int	20	Cap per query
proxyConfig	object	residential	Per-query the actor selects DE/FR/NL country automatically

Output (unified across countries)

{
  "country": "FR",
  "registrationNumber": "662042449",
  "name": "BNP PARIBAS",
  "legalForm": "Société Anonyme",
  "address": "16 BOULEVARD DES ITALIENS 75009 PARIS",
  "postalCode": "75009",
  "city": "PARIS",
  "status": "Active",
  "registrationDate": "1966-07-01",
  "lastUpdatedDate": "2025-12-05T16:28:51",
  "directors": [
    { "name": "Jane Doe", "role": "Président", "birthDate": "1970-01" }
  ],
  "naceCode": "64.19Z",
  "naceLabel": "Banking",
  "employeeRange": "10000 et plus",
  "sourceUrl": "https://annuaire-entreprises.data.gouv.fr/entreprise/662042449",
  "rawData": { "...": "source-specific original record" },
  "searchQuery": "BNP Paribas",
  "scrapedAt": "2026-05-18T12:00:00.000Z"
}

Note that not all fields are present for every source — FR returns the richest data, DE and NL are more constrained (registration #, name, address mostly).

Use cases

• KYC / compliance: verify a counterparty's registration status across EU jurisdictions
• B2B lead generation: discover companies by name fragment / sector for sales outreach
• Due diligence: cross-jurisdiction company background checks
• Competitor monitoring: track new entity registrations in your industry

Notes

• FR is the gold standard: the official government API is free, no key, rich data including directors, NACE codes, INSEE updates. Use FR for the deepest data.
• DE Handelsregister: JSF-based, fragile; the actor handles ViewState extraction + form POST. Residential DE proxy mandatory — datacenter IPs blocked.
• NL KvK: the public search has both an internal JSON endpoint and HTML fallback. For richer per-company data (UBOs, statutory directors, financial filings), you need the official KvK API key — that's beyond what this actor does.
• For programmatic compliance use (regulated KYC) consider supplementing with the official APIs of each country — this actor returns public-record data, suitable for prospecting and screening but not formal verification.

---

Changelog

• 2026-05-20 — Maintenance pass: reviewed the input schema and default values for a smooth one-click start, and rebuilt the Actor on the latest base image.

Last reviewed: 2026-05-20.