Finland Company Search (YTJ) API and MCP — Find Companies by Name
Send a company name and this source returns matching Finnish companies: Business ID, name, legal form, home municipality, main line of business and a link to the register.
- You send
- A company name, plus optional max_items, start_page and status
- You get back
- Matching Finnish companies with Business ID, name, legal form, municipality, activity and link
- Coverage
- Finland — entities on PRH / YTJ.
- Price
- 1 point per returned record — $1 per 1,000
- Billed per record actually returned, capped by max_items. A request that returns nothing costs nothing.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| PRH / YTJ directly | Type the name into PRH / YTJ and read the results | Usually free, sometimes per-document | A different interface, language and data shape for every country you add |
| Collecting it yourself | Build and host a crawler per register, then keep each one alive | Infrastructure and maintenance | Registers change their pages without warning, and nobody is on the hook when yours breaks |
| NeuralVerge | One request, the same shape as every other source in the catalog | $1 per 1,000, misses not billed | Covers Finland — other countries are separate sources with the same request format |
What you get back
Every field in the example response below.
| Field | Type | Description |
|---|---|---|
total_items | number | Records returned in this response. |
total_found | number | Matches the register reports for the keyword. |
page_count | number | Pages read for this response. |
first_item | object | The first result, same shape as items entries. |
items | array | Returned matches. |
items[].registration_number | string | Business ID. |
items[].name | string | Company name. |
items[].company_type | string | Legal form in Finnish. |
items[].home_municipality | string | Home municipality, or ULKOMAAT for foreign entities. |
items[].activity | string | Main line of business in Finnish. |
items[].url | string | Link to the company on the register. |
items[].status | null | Null in the sample. |
items[].address | null | Null in the sample. |
items[].incorporation_date | null | Null in the sample. |
Example response
A real response, as returned.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "fi_companies_search",
"keyword": "nokia",
"max_items": 2,
"start_page": 1,
"partial": false,
"human": "# Finland — PRH / YTJ — company search\n\n- **Keyword:** nokia\n- **Results:** 2 of 300 found\n- **Proxy traffic:** 56.5 KB",
"machine": {
"total_items": 2,
"first_item": {
"registration_number": "0112038-9",
"name": "Nokia Oyj",
"status": null,
"address": null,
"url": "https://tietopalvelu.ytj.fi/en/yritys/0112038-9",
"company_type": "Julkinen osakeyhtiö",
"incorporation_date": null,
"home_municipality": "HELSINKI",
"activity": "Pääkonttorien toiminta"
},
"items": [
{
"registration_number": "0112038-9",
"name": "Nokia Oyj",
"status": null,
"address": null,
"url": "https://tietopalvelu.ytj.fi/en/yritys/0112038-9",
"company_type": "Julkinen osakeyhtiö",
"incorporation_date": null,
"home_municipality": "HELSINKI",
"activity": "Pääkonttorien toiminta"
},
{
"registration_number": "3156443-1",
"name": "Nokia (Thailand) Co., Ltd.",
"status": null,
"address": null,
"url": "https://tietopalvelu.ytj.fi/en/yritys/3156443-1",
"company_type": "Ulkomainen yhteisö",
"incorporation_date": null,
"home_municipality": "ULKOMAAT",
"activity": "Ohjelmistojen suunnittelu ja valmistus"
}
],
"total_found": 300,
"page_count": 1,
"blocked": false,
"proxy_traffic_bytes": 57840
},
"total_points": 2
}How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
Results come back in the same envelope as every other source: a session id, a readable summary, the structured result and the points charged.
curl -X POST https://api.neuralverge.ai/functions/v1/run-fi-companies-search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keyword":"nokia","max_items":2}'What teams use it for
Where this field shows up in an actual workflow.
Resolve a name to its Y-tunnus and pass it to the company source.
The legal form and municipality show whether a match is a Finnish company or a foreign entity registered in Finland.
Match company names in your own data to Finnish register entries.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
Finland — entities on PRH / YTJ.
Read at request time, so the answer reflects the register as it stands when you ask.
PRH / YTJ is a public register. Every response carries the source URL it was read from and a session id you can trace.
- —Status, address and registration date are null in search results. Use the company source for them.
- —Legal form and activity come back in Finnish.
Questions, answered
The endpoint accepts a status parameter alongside keyword, max_items and start_page. The sample does not use it, so check the docs for accepted values.
Related sources
Try finland company search on your own data
One request format across every source in the catalog.