Finland Company Registry (PRH) — Businesses by Name
Pricing
from $0.50 / 1,000 results
Finland Company Registry (PRH) — Businesses by Name
Search the Finnish Trade Register and get flat rows — business ID, EU id, name, main business line, website, legal form and status. Free public PRH API, no key.
Pricing
from $0.50 / 1,000 results
Rating
0.0
(0)
Developer
alaudin burki
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
21 days ago
Last modified
Categories
Features
Share
Searches the Finnish Patent and Registration Office's open company data (the YTJ service) by name
and returns one flat row per company: name, EU identifier, main business line, legal form, website,
register status and registered address. The API is public, so the endpoint needs no key. The Finnish
Business ID (Y-tunnus) is carried on every row inside the id field.
How to use
- Put all or part of a company name in the
nameinput, e.g.supercell. - Set
maxItemsto the number of rows you want. The Actor makes a single request per run. - Run the Actor. Rows land in the default dataset and the run's
SUMMARYrecord reports how many were returned and whether the source had more.
Inputs
| Field | What it does | Default |
|---|---|---|
name | Sent as the name filter to PRH's v3 companies endpoint. All or part of a name. | none |
maxItems | Hard row cap. The runner also refuses to go above 20,000. | 500 |
maxPages | Request cap. This source is read with one request, so the default changes nothing. | 5 |
{"name": "supercell","maxItems": 100}
Output
One row per company.
| Field | Meaning |
|---|---|
name | Company name from the first entry in the register's name list (names[0].name). |
nameRegistered | The registration date of that first name entry (names[0].registrationDate). A date, despite the field name. |
euId | EU-wide identifier (euId.value), where PRH has issued one. |
businessLineCode | Code for the main business line (mainBusinessLine.typeCode), from PRH's own classification. |
businessLine | The first description of that business line (mainBusinessLine.descriptions[0].description), in whichever language PRH lists first. |
legalForm | The first description of the company form (companyForms[0].descriptions[0].description); a word, not a code. |
website | Website URL registered by the company (website.url). |
tradeRegisterStatus | The company's status value in the trade register (tradeRegisterStatus), as PRH returns it. |
status | The company's status value (status), as PRH returns it. |
street | Street of the first registered address (addresses[0].street). |
postCode | Postcode of that address (addresses[0].postCode), as text so leading zeros survive. |
city | City of that address, taken from its first post office entry (addresses[0].postOffices[0].city). |
country | Country of that address (addresses[0].country). |
Every row also carries id (prh: followed by the Business ID), plus source (finland-companies)
and scrapedAt (an ISO timestamp for the run); the first is the identifier, the last two are added by
the runner. Absent values are dropped from the row rather than written as empty strings.
Limitations
- There is no
businessIdcolumn. The Business ID (Y-tunnus) is the row identifier: it appears asid, prefixed withprh:, e.g.prh:2336509-6. nameRegisteredis a date, not a name. It is mapped fromnames[0].registrationDate; the field name is historical and the value is what the mapping says.- One request per run. The Actor reads a single result set from the companies endpoint, so a broad
name returns whatever that one response holds.
maxPagescannot fetch a second result set. - Descriptions are not translated.
businessLine,legalFormandcitycome back in the language PRH supplies first, which is usually Finnish and sometimes Swedish. statusandtradeRegisterStatusare PRH's own values, not words this Actor invented.- Only the first entry of each list is mapped. A company with several names, company forms, business lines or addresses returns the first of each.
- The registered address is not necessarily an operating site, and it is the address held at the time of the run.
- The trade register includes companies that have ceased trading.
statusandtradeRegisterStatusare what separate them from active ones. - No financial statements, officers or owners are returned. PRH publishes financial data through a separate service that this Actor does not call.
- Search is by name only. The Business ID cannot be used as a search input in this version.
Why this is different
This Actor is different because it reads PRH's official open company API directly — no page is
rendered, no HTML is parsed and no key is issued. Each row is identified by the Finnish Business ID,
so output can be joined with other Finnish business data without matching on names, and absent values
are omitted rather than blank. Every run writes a SUMMARY record with the row count and stop reason,
so an empty result is visible as an empty result.
FAQ
Is a key needed? No. The PRH open data endpoint used here is public and the Actor sends no credentials.
What is the Finnish Business ID? The Y-tunnus, a seven-digit number with a check digit, written
like 2336509-6. It is returned inside id.
Can I search by Business ID? Not in this version. The input filters by name; the Business ID comes
back in id.
Why is nameRegistered a date? The source field it maps is the registration date of the first
name entry, and the README keeps the declared field name rather than silently renaming it.
How many rows can one run return? Up to maxItems (default 500, hard-capped at 20,000), within
the single response the API returns for that name.
Pricing and limits
The price is shown on the Actor's Apify pricing panel; billing is per event under Apify's
pay-per-event model. Each run is bounded by maxItems (default 500, hard-capped at 20,000) and
maxPages (default 5, hard-capped at 200), with one request per run. SUMMARY.truncated is true
when a limit stopped the run before the source was exhausted.