# Finland YTJ Company Registry Scraper (`automation-lab/finland-ytj-company-registry-scraper`) Actor Search Finland’s public YTJ company registry by name or Business ID. Export legal names, legal forms, municipalities, industries, and source context for verified Finnish company records. - **URL**: https://apify.com/automation-lab/finland-ytj-company-registry-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## 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 ## Finland YTJ Company Registry Scraper Search public Finnish company records from the YTJ (Yritys- ja yhteisötietojärjestelmä) registry. Export Finnish Business IDs, legal names, company forms, municipalities, and industries in structured JSON. ### What does it do? This Apify Actor searches the public YTJ company and organisation registry by company name or exact Y-tunnus. Use it to turn public Finnish registry searches into records that can be filtered, exported, or sent to downstream tools. It supports discovery searches such as `Nokia` and direct verification lookups such as `0112038-9`. ### Who is it for? - Sales operations teams building a Finland-focused company prospect list. - KYB and compliance teams verifying a public Business ID. - Analysts researching Finnish corporate entities and industries. - Developers who need a repeatable YTJ registry extractor in an automated workflow. This Actor is for public registry information only. It does not provide private company data or paid PRH/Virre documents. ### Why use the YTJ registry scraper? Manual registry lookup is useful for one company, but it is slow to repeat across many name searches. The Actor produces a consistent dataset with the search query retained on every row. That makes it easy to join results with an existing lead list, deduplicate by Business ID, or audit how a company was found. ### Public data returned | Field | Description | | --- | --- | | `businessId` | Finnish Y-tunnus / Business ID | | `legalName` | Current legal company or organisation name | | `legalForm` | Public legal-form label from YTJ | | `municipality` | Registered municipality / domicile | | `industry` | Public main-industry label when available | | `query` | The input that generated the row | | `queryMode` | `companyName` or `businessId` | | `sourceUrl` | Public YTJ result or company page URL | | `scrapedAt` | ISO 8601 collection timestamp | ### Quick start 1. Open the Actor in Apify. 2. Enter one or more company names or Business IDs. 3. Keep the first run small with a low `maxItems` value. 4. Run the Actor and download the dataset as JSON, CSV, Excel, or via API. A name search can have many partial matches. Use an exact Business ID when you already know the entity to verify. ### Search by company name Use `companyNames` to discover companies that match a word or phrase. ```json { "companyNames": ["Nokia"], "maxItems": 10 } ```` The registry may return similarly named organisations as well as the best-known company. Filter by legal form, municipality, or industry after export. ### Search by Finnish Business ID Use `businessIds` for direct public company verification. ```json { "businessIds": ["0112038-9"], "maxItems": 1 } ``` The Business-ID mode opens the public company record and returns current legal-name, legal-form, municipality, and main-industry values. ### Combine searches carefully You can submit both input modes in one run. ```json { "companyNames": ["Nokia", "Kone"], "businessIds": ["0112038-9"], "maxItems": 20 } ``` `maxItems` is a global cap for the entire run. Put direct IDs first in a separate run if they must not be crowded out by a broad name search. ### Input reference | Input | Type | Purpose | | --- | --- | --- | | `companyNames` | array of strings | Name queries for public YTJ results | | `businessIds` | array of strings | Exact Y-tunnus values to look up | | `maxItems` | integer, 1–100 | Maximum dataset rows across all queries | At least one company name or Business ID is required. ### Output example ```json { "businessId": "0112038-9", "legalName": "Nokia Oyj", "legalForm": "Julkinen osakeyhtiö", "municipality": "HELSINKI", "industry": "70100 Pääkonttorien toiminta", "query": "0112038-9", "queryMode": "businessId", "sourceUrl": "https://tietopalvelu.ytj.fi/yritys/0112038-9", "scrapedAt": "2026-07-11T00:00:00.000Z" } ``` Some public records do not list an industry. In those cases `industry` is `null` rather than a guessed value. ### How much does it cost to scrape Finland YTJ company records? This Actor uses pay-per-event pricing: a small run-start event plus one event for each output company record. Current per-item prices are shown in the Apify pricing panel before a run starts. Keep initial searches small so you can confirm the returned match quality. ### Tips for better matches - Prefer a full legal name over a generic keyword. - Use a Business ID for an exact entity lookup. - Start with 5–10 results for broad names. - Deduplicate exported records using `businessId`. - Retain `query` and `queryMode` when combining searches from multiple teams. ### Integrations Use the dataset in a lead-enrichment workflow: search names from a CRM, filter Finnish entities by municipality or industry, then save the Business ID back to your CRM. For KYB workflows, submit known Business IDs and archive the returned `sourceUrl` with the verification result. For data pipelines, fetch the default dataset after each run and load rows into a warehouse keyed by `businessId`. ### API usage with Node.js ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/finland-ytj-company-registry-scraper').call({ companyNames: ['Nokia'], maxItems: 10, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` ### API usage with Python ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("automation-lab/finland-ytj-company-registry-scraper").call( run_input={"businessIds": ["0112038-9"], "maxItems": 1} ) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) ``` ### API usage with cURL ```bash curl -X POST "https://api.apify.com/v2/acts/automation-lab~finland-ytj-company-registry-scraper/runs?token=$APIFY_TOKEN" \ -H 'Content-Type: application/json' \ -d '{"companyNames":["Nokia"],"maxItems":10}' ``` ### MCP usage Add this Actor to Apify MCP tools with `?tools=automation-lab/finland-ytj-company-registry-scraper`. For Claude Code, add the Apify MCP server: ```bash claude mcp add --transport http apify https://mcp.apify.com/?tools=automation-lab/finland-ytj-company-registry-scraper ``` For Claude Desktop, add this server configuration and restart the app: ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com/?tools=automation-lab/finland-ytj-company-registry-scraper" } } } ``` Example prompts: “Search the Finnish YTJ registry for companies named Nokia and return the first five Business IDs.” “Verify Finnish Business ID 0112038-9 and return its legal form and municipality.” ### Reliability and limitations YTJ is a public website whose markup and availability can change. Broad searches can return hundreds of matches; this Actor deliberately reads only the first result page and respects `maxItems`. It does not bypass login controls, paywalls, CAPTCHA challenges, or access restrictions. No result is returned when YTJ has no matching public entry. ### Legality and responsible use Only collect and use public registry information for lawful, legitimate purposes. Respect YTJ terms, applicable Finnish and EU data-protection requirements, and your organisation’s compliance policies. Do not use public company data to make decisions about individuals or to send unlawful marketing. ### Troubleshooting **Why did a name search return unexpected companies?** YTJ name matching can include partial matches and organisations with the word in their name. Use a more specific name, reduce `maxItems`, or look up a known Y-tunnus. **Why is an industry empty?** Not every public record exposes a current main-industry value. The Actor returns `null` in that case. **Why did I receive zero rows?** Check the Business ID format, spelling, and whether the entity appears in the public YTJ service. Retry later if the public service is temporarily unavailable. ### FAQ **Does this Actor return paid Virre documents?** No. It extracts only information publicly displayed by YTJ. **Can I search terminated companies?** The current MVP searches the public default result set for active entities. Use the YTJ website directly for special search filters not exposed by this Actor. **Can I request more than 100 companies?** The Actor caps one run at 100 items to keep results predictable and avoid excessive broad searches. ### Related scrapers For adjacent European registry workflows, see the [France Sirene Company Scraper](https://apify.com/automation-lab/france-sirene-company-scraper). For broader B2B workflows, combine registry data with your CRM or a company-domain enrichment Actor. ### Support Include your non-sensitive input, run ID, and an example expected result when reporting an issue. Do not send credentials or private data in Actor support requests. # Actor input Schema ## `companyNames` (type: `array`): Company or organisation names to search. Use this for discovery. ## `businessIds` (type: `array`): Exact Finnish Business IDs to look up, for example 0112038-9. ## `maxItems` (type: `integer`): Maximum registry rows across all queries. ## Actor input object example ```json { "companyNames": [ "Nokia" ], "businessIds": [], "maxItems": 10 } ``` # Actor output Schema ## `overview` (type: `string`): No description # 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 = { "companyNames": [ "Nokia" ], "businessIds": [], "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/finland-ytj-company-registry-scraper").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 = { "companyNames": ["Nokia"], "businessIds": [], "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("automation-lab/finland-ytj-company-registry-scraper").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 '{ "companyNames": [ "Nokia" ], "businessIds": [], "maxItems": 10 }' | apify call automation-lab/finland-ytj-company-registry-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/finland-ytj-company-registry-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Finland YTJ Company Registry Scraper", "description": "Search Finland’s public YTJ company registry by name or Business ID. Export legal names, legal forms, municipalities, industries, and source context for verified Finnish company records.", "version": "0.1", "x-build-id": "Xfp0J0KhwHicQWEco" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~finland-ytj-company-registry-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-finland-ytj-company-registry-scraper", "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/automation-lab~finland-ytj-company-registry-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-finland-ytj-company-registry-scraper", "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/automation-lab~finland-ytj-company-registry-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-finland-ytj-company-registry-scraper", "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": { "companyNames": { "title": "🔎 Company names", "type": "array", "description": "Company or organisation names to search. Use this for discovery.", "items": { "type": "string" } }, "businessIds": { "title": "🏢 Business IDs (Y-tunnus)", "type": "array", "description": "Exact Finnish Business IDs to look up, for example 0112038-9.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum companies", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum registry rows across all queries.", "default": 10 } } }, "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 } } } } } } } } } } ```