# European Company Search — 6 Country Registry Lookup (`studio-amba/european-company-search`) Actor Search company registries across 6 European countries from one query. Covers Belgium (KBO), Netherlands (KVK), Germany (Handelsregister), France (INSEE), Spain (BORME), and Italy. Returns unified data with registration numbers, VAT, legal form, and addresses. - **URL**: https://apify.com/studio-amba/european-company-search.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## European Company Search Search company registries across 6 European countries from a single query. Enter a company name, VAT number, or registration number and get unified results from Belgium (KBO), Netherlands (KVK), Germany (Handelsregister), France (INSEE), Spain (BORME), and Italy (Registro Imprese). No login required. No cookies. One input, six registries, one unified output. ### How to search European company registries This actor orchestrates 6 specialized company registry scrapers via the Apify API. Instead of running each registry scraper manually, you run this single actor and get results from all selected countries in parallel. Each underlying actor handles its own proxy configuration and anti-bot measures. You simply provide a search query and optionally select which countries to include. ### Features - Search up to 6 European company registries simultaneously - Unified output format regardless of source country - Parallel execution for fast results - Graceful error handling — if one country fails, you still get results from others - Configurable per-country result limits - Works with company names, VAT numbers, or registration numbers - No login or authentication required ### Input parameters | Parameter | Type | Description | Default | |-----------|------|-------------|---------| | `searchQuery` | string | Company name, VAT number, or registration number | `Deloitte` | | `countries` | array | Countries to search (empty = all 6) | `[]` | | `maxResultsPerCountry` | integer | Maximum results per country (1-50) | `5` | #### Country codes Use ISO 2-letter codes: `BE`, `NL`, `DE`, `FR`, `ES`, `IT` ### Output format Each result in the dataset follows this unified structure: ```json { "country": "BE", "registrySource": "KBO", "companyName": "Deloitte Belgium BV", "registrationNumber": "0429.053.863", "vatNumber": "BE0429053863", "legalForm": "Besloten vennootschap", "status": "Active", "address": { "street": "Luchthaven Brussel Nationaal 1 J", "city": "Zaventem", "postalCode": "1930", "country": "Belgium" }, "activities": [ { "code": "69.201", "description": "Accountancy and auditing activities" } ], "incorporationDate": "1988-01-04", "url": "https://kbopub.economie.fgov.be/kbopub/toonondernemingps.html?ondernemingsnummer=0429053863", "rawData": { "...original fields from underlying actor..." } } ```` The `rawData` field contains the complete response from the underlying actor, preserving all country-specific fields that may not fit the unified schema. ### Supported countries | Country | Registry | Key data returned | |---------|----------|-------------------| | Belgium (BE) | KBO/BCE | Enterprise number, VAT, NACE codes, legal form, capital, management | | Netherlands (NL) | KVK | KVK number, trade names, SBI codes, legal form, address | | Germany (DE) | Handelsregister | HRB/HRA number, legal form, address, registered capital | | France (FR) | INSEE/RCS | SIREN/SIRET, NAF codes, legal form, creation date, TVA number | | Spain (ES) | BORME | CIF number, legal form, registered office, incorporation acts | | Italy (IT) | Registro Imprese | Codice fiscale, partita IVA, ATECO codes, legal form | ### Use cases - **Due diligence**: Verify a company exists across multiple jurisdictions - **Lead generation**: Find branches of multinational companies across Europe - **Compliance/KYC**: Collect registration and VAT numbers for regulatory checks - **Market research**: Identify competitors operating in multiple European countries - **Supply chain verification**: Confirm suppliers are registered and active - **M\&A research**: Map a group's corporate structure across countries ### Cost and performance This actor calls up to 6 underlying actors in parallel. Each underlying actor run counts toward your Apify platform usage. **Typical run time**: 30-90 seconds (all 6 countries) **Typical cost**: Depends on underlying actor pricing. Each sub-actor run is billed at its own PPE rate. To reduce cost, select only the countries you need via the `countries` input parameter. ### API integration example #### Start a run via API ```bash curl -X POST "https://api.apify.com/v2/acts/studio-amba~european-company-search/runs?token=YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "searchQuery": "Siemens", "countries": ["DE", "NL", "BE"], "maxResultsPerCountry": 10 }' ``` #### Fetch results from the dataset ```bash curl "https://api.apify.com/v2/datasets/DATASET_ID/items?token=YOUR_TOKEN&format=json" ``` #### Use with the Apify JavaScript client ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_TOKEN' }); const run = await client.actor('studio-amba/european-company-search').call({ searchQuery: 'IKEA', countries: ['NL', 'DE', 'FR'], maxResultsPerCountry: 5, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`Found ${items.length} companies across 3 countries`); ``` ### Limitations - Results depend on the availability and accuracy of each underlying registry scraper - Some registries have stricter search matching (exact vs. fuzzy) - VAT number search works best for Belgium and France; other countries may require the company name - Rate limits on underlying registries may affect results during peak hours # Actor input Schema ## `searchQuery` (type: `string`): Company name, VAT number, or registration number to search across European registries. ## `countries` (type: `array`): Select countries to search. Leave empty to search all 6 countries. ## `maxResultsPerCountry` (type: `integer`): Maximum number of results to return from each country registry. ## `proxyConfiguration` (type: `object`): Proxy settings. The underlying actors handle their own proxy connections, so this is optional. ## Actor input object example ```json { "searchQuery": "Deloitte", "countries": [], "maxResultsPerCountry": 5, "proxyConfiguration": { "useApifyProxy": true } } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQuery": "Deloitte", "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/european-company-search").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQuery": "Deloitte", "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/european-company-search").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQuery": "Deloitte", "proxyConfiguration": { "useApifyProxy": true } }' | apify call studio-amba/european-company-search --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/european-company-search", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "European Company Search — 6 Country Registry Lookup", "description": "Search company registries across 6 European countries from one query. Covers Belgium (KBO), Netherlands (KVK), Germany (Handelsregister), France (INSEE), Spain (BORME), and Italy. Returns unified data with registration numbers, VAT, legal form, and addresses.", "version": "0.0", "x-build-id": "fuU6kfiF70cP4YC2W" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~european-company-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-european-company-search", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/studio-amba~european-company-search/runs": { "post": { "operationId": "runs-sync-studio-amba-european-company-search", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/studio-amba~european-company-search/run-sync": { "post": { "operationId": "run-sync-studio-amba-european-company-search", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchQuery": { "title": "Company Name or VAT Number", "type": "string", "description": "Company name, VAT number, or registration number to search across European registries." }, "countries": { "title": "Countries", "type": "array", "description": "Select countries to search. Leave empty to search all 6 countries.", "items": { "type": "string", "enum": [ "BE", "NL", "DE", "FR", "ES", "IT" ] }, "default": [] }, "maxResultsPerCountry": { "title": "Max Results Per Country", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of results to return from each country registry.", "default": 5 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. The underlying actors handle their own proxy connections, so this is optional." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```