Finland Company Registry (PRH) — Businesses by Name avatar

Finland Company Registry (PRH) — Businesses by Name

Pricing

from $0.50 / 1,000 results

Go to Apify Store
Finland Company Registry (PRH) — Businesses by Name

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

alaudin burki

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

21 days ago

Last modified

Features

Limited permissions

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

  1. Put all or part of a company name in the name input, e.g. supercell.
  2. Set maxItems to the number of rows you want. The Actor makes a single request per run.
  3. Run the Actor. Rows land in the default dataset and the run's SUMMARY record reports how many were returned and whether the source had more.

Inputs

FieldWhat it doesDefault
nameSent as the name filter to PRH's v3 companies endpoint. All or part of a name.none
maxItemsHard row cap. The runner also refuses to go above 20,000.500
maxPagesRequest cap. This source is read with one request, so the default changes nothing.5
{
"name": "supercell",
"maxItems": 100
}

Output

One row per company.

FieldMeaning
nameCompany name from the first entry in the register's name list (names[0].name).
nameRegisteredThe registration date of that first name entry (names[0].registrationDate). A date, despite the field name.
euIdEU-wide identifier (euId.value), where PRH has issued one.
businessLineCodeCode for the main business line (mainBusinessLine.typeCode), from PRH's own classification.
businessLineThe first description of that business line (mainBusinessLine.descriptions[0].description), in whichever language PRH lists first.
legalFormThe first description of the company form (companyForms[0].descriptions[0].description); a word, not a code.
websiteWebsite URL registered by the company (website.url).
tradeRegisterStatusThe company's status value in the trade register (tradeRegisterStatus), as PRH returns it.
statusThe company's status value (status), as PRH returns it.
streetStreet of the first registered address (addresses[0].street).
postCodePostcode of that address (addresses[0].postCode), as text so leading zeros survive.
cityCity of that address, taken from its first post office entry (addresses[0].postOffices[0].city).
countryCountry 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 businessId column. The Business ID (Y-tunnus) is the row identifier: it appears as id, prefixed with prh:, e.g. prh:2336509-6.
  • nameRegistered is a date, not a name. It is mapped from names[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. maxPages cannot fetch a second result set.
  • Descriptions are not translated. businessLine, legalForm and city come back in the language PRH supplies first, which is usually Finnish and sometimes Swedish.
  • status and tradeRegisterStatus are 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. status and tradeRegisterStatus are 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.