🔎 Finland PRH YTJ Company Registry

One record per Finnish company from the official PRH open-data YTJ API v3 (business ID, current name, legal form, main business line, primary address, status, registry entry). The nested v3 payload is flattened to one scalar record per company; PRH status codes are carried verbatim.

Public, robots-honoured.

Output is one fi_prh_company row per result; billing is pay-per-event, the value event being one registry record (a $0.02 start fee per run, then $0.02 per registry record). Source: avoindata.prh.fi.

No login, no API key and no CAPTCHA solving are involved: the source is read logged-out with an identified contact User-Agent.

📊 Sample Output

Real rows from run p8KEUCbiULshocxl5 on build 0.1.4 (2026-09-18), the same input as the Quick start below — every value is as the source published it (emails masked, long text shortened):

business_id	name	company_form	main_business_line	registration_date	registered_entry_status
0100002-9	Artjärven Metalli Oy	Limited company	Manufacture of pumps and compressors	1976-04-23	Ceased
0100004-5	Artjärven Kauppakeskus Oy	Mutual real estate limited company	Rental and operating of own or leased non-residential real estate	1937-04-20	Registered
0100006-1	Vähämäyrä Oy	Limited company	Sawmilling and planing of wood	1973-06-08	Ceased
0100008-8	Artjärven Osuuskassa	Cooperative bank	Other monetary intermediation	1922-11-21	Ceased
0100009-6	Artjärven Kotiseutuyhdistys r.y.	Non-profit association	Activities of other miscellaneous membership organisations n.e.c.	1978-03-15	Registered
0100024-8	Asunto Oy Tammilehto	Housing corporation	Operating of own or leased dwellings and residential real estate	1974-12-05	Registered
0100032-8	Laineen Vesilämpö kommandiittiyhtiö	Limited partnership	Plumbing, heat and air-conditioning installation	1976-03-05	VAT-liable for business activity
0100036-0	Askolan Kotolämpö Oy	Limited company	Rental of own or leased dwellings and residential real estate	1976-02-06	Registered

The run finished with the status message: NORMAL: 50 unique rows (0 duplicates collapsed). billable=50

✅ What you get

Each row is flat JSON with these fields (from the dataset schema and the sample run; a field the source does not publish for a given row is null):

• record_type (string) — e.g. fi_prh_company
• business_id (string/null) — e.g. 0100002-9
• name (string/null) — e.g. Artjärven Metalli Oy
• company_form (string/null) — e.g. Limited company
• main_business_line_code (string/null) — e.g. 29120
• main_business_line (string/null) — e.g. Manufacture of pumps and compressors
• street_address (string/null) — e.g. Laukkakatu 6
• post_code (string/null) — e.g. 15830
• city (string/null) — e.g. LAHTI
• status_code (string/null) — e.g. 2
• trade_register_status_code (string/null) — e.g. 4
• registration_date (string/null) — e.g. 1976-04-23
• registered_entry_status (string/null) — e.g. Ceased
• register_code (string/null) — e.g. 1
• source (string/null) — e.g. finland-prh-ytj-company-registry
• release_date (string/null) — null in every sample row
• source_url (string/null) — e.g. https://avoindata.prh.fi/opendata-ytj-api/v3/companies
• observed_at (string/null) — e.g. 2026-09-18T19:34:11Z
• terminal (string/integer/null) — null in every sample row
• reported_total (string/integer/null) — null in every sample row
• raw_seen (string/integer/null) — null in every sample row
• duplicates (string/integer/null) — null in every sample row
• unique_found (string/integer/null) — null in every sample row
• delivered (string/integer/null) — null in every sample row
• scope (string/integer/null) — null in every sample row
• note (string/integer/null) — null in every sample row
• license (string/integer/null) — null in every sample row
• attribution (string/integer/null) — null in every sample row

What you get

One registry_record per entity, deduplicated on the source-native id. Fields the source does not publish are honest null. A run_receipt row carries the source URL, scope, reconciliation counts, and delivered/duplicate totals.

⚙️ Sample inputs

1. Quick start — the Store example (this is what the sample above came from)

{
  "maxRecords": 50,
  "maxPages": 3
}

The sample run charged exactly: 2 × $0.02 apify-actor-start + 50 × $0.02 registry_record = $1.04 on the Free tier — every delivered row was billed.

2. A smaller, narrowed run

{
  "maxRecords": 5,
  "maxPages": 3
}

Caps the run at 5 rows — about $0.12 on the Free tier ($0.02 start + 5 × $0.02).

3. A full-size run

{
  "maxRecords": 5000,
  "maxPages": 3
}

Up to 5000 rows (the schema default for maxRecords) — about $100.02 on the Free tier ($0.02 start + 5000 × $0.02) if the source has that many.

🧾 JSON sample record

One real record from run p8KEUCbiULshocxl5, exactly as it lands in the dataset (emails masked, long text shortened):

{
  "record_type": "fi_prh_company",
  "business_id": "0100002-9",
  "name": "Artjärven Metalli Oy",
  "company_form": "Limited company",
  "main_business_line_code": "29120",
  "main_business_line": "Manufacture of pumps and compressors",
  "street_address": null,
  "post_code": null,
  "city": null,
  "status_code": "2",
  "trade_register_status_code": "4",
  "registration_date": "1976-04-23",
  "registered_entry_status": "Ceased",
  "register_code": "1",
  "source": "finland-prh-ytj-company-registry",
  "release_date": null,
  "source_url": "https://avoindata.prh.fi/opendata-ytj-api/v3/companies",
  "observed_at": "2026-09-18T19:34:11Z"
}

🔧 How it works

Transport. Plain HTTPS from the Apify platform, no proxy. robots.txt is read first and a disallowed path is never fetched. Every request carries an identified contact User-Agent. Pacing: CRAWL_DELAY=0.0.

Charging. Each registry record is charged at the moment it is pushed (registry_record); a row that fails to charge is not delivered, so the dataset count always equals the charged count.

How it behaves

The PRH v3 companies endpoint is paged (100/page, ?page=N) against totalResults; pagination is proven honest to the exact tail (822,257 = 8222 full pages + a 57-row remainder), so full enumeration is real — not a preview cap. English descriptions are preferred, then Finnish, then Swedish. Streaming, bounded to maxRecords/maxPages. totalResults is reconciled in the receipt.

Source

https://avoindata.prh.fi/opendata-ytj-api/v3/companies

What is not done. No login, no cookie or CAPTCHA bypass, no private or personal-account data, no browser automation.

💰 Pricing example

Event	Free	Bronze	Silver	Gold
Actor Start (apify-actor-start)	$0.02	$0.02	$0.02	$0.02
Registry Record (registry_record)	$0.02	$0.02	$0.02	$0.01

Worked at the live Free-tier price:

• 8 registry records: $0.02 start + 8 × $0.02 = $0.18
• 25 registry records: $0.02 start + 25 × $0.02 = $0.52
• 5000 registry records: $0.02 start + 5000 × $0.02 = $100.02

A run that delivers zero rows charges the $0.02 start fee only. A BLOCKED run (source refused) fails loud and charges no value event. The start fee is charged once per GB of run memory; the default run memory is 4096 MB.

Yield on the sample run: NORMAL: 50 unique rows (0 duplicates collapsed). billable=50. maxRecords is a hard ceiling on what is delivered and billed, never a target.

⚖️ Legal & ToS

This actor reads public, logged-out pages and feeds published by avoindata.prh.fi. It collects only what the source publishes to any visitor, keeps to the source's robots rules (checked on every run), identifies itself with a contact User-Agent, and does not access accounts, private data or anything behind authentication. Use the output in line with the source's terms and your local law; the intended use is B2B research and monitoring.

❓ FAQ

Q: Do I need an API key or a login?
A: No. The source (avoindata.prh.fi) is read logged-out; the input schema has no key field and the actor carries no secrets.

Q: Why did my run return 0 rows?
A: Read the run's status message. GENUINE_EMPTY means the source was read and had nothing in scope for your input; BLOCKED means the source refused and the run failed without billing a value event — retry later or narrow the input. A zero-row run bills the start fee only.

Q: How many rows can one run return?
A: Up to maxRecords (default 5000). Raise the cap for a bigger run; you pay per delivered row.

Q: How fresh is the data?
A: Every run reads the source live at run time; nothing is cached between runs. Put it on a schedule for a continuous feed.

Q: What formats can I export?
A: The dataset downloads as JSON, CSV, Excel, XML or RSS from the run's Dataset tab or the Apify API, and any run can push to a webhook or integration.

Q: How is this different from the other company registry checks actors?
A: Same output shape and billing model; this one covers avoindata.prh.fi. The siblings under Related Actors cover the other sources or slices — run several on one schedule for a combined feed.

Q: Are there rate limits?
A: The actor paces itself against the source (CRAWL_DELAY=0.0) and honours its robots rules; there is no per-buyer limit beyond your Apify plan's concurrency.

🆘 Troubleshooting

• Run FAILED with BLOCKED → the source refused the request or changed its page shape → nothing was billed beyond the start fee; retry after a while, and if it persists open an Issue with the run id.
• Status says CAPPED → your cap (maxRecords) was reached → raise it for a bigger run.
• Input validation error on start → a field is outside the schema's allowed values → start from the Quick start block and change one field at a time.
• Run TIMED-OUT → a very wide request on a slow day → raise the run timeout in Run options or narrow the input; what was delivered before the timeout is still in the dataset.

🔗 Related Actors

• EU EORI Customs Registration Check — Validates EORI numbers against the European Commission's official EORI service — one definitive registered / not-registered answer per identifier wit…
• EU VAT Validator — VIES per-answer check — Validate EU VAT numbers against the official EU VIES service — one verdict per number with the registered name and date. No API key; pay per complete…
• Finland PRH Business Filing Lookup — Look up Finnish companies by Business ID on the official PRH open-data trade register — name, company form, trade-register status, registration date,…
• Finland Trade Register Filing Events — Finnish Trade Register (PRH) public-notice events in a date window — one record per registration notice: business ID, company name, notice type and e…
• FMCSA Motor Carrier Authority Check — Resolves USDOT numbers against the official FMCSA SAFER company snapshot — legal/DBA name, entity type, operating status, out-of-service date, MC/MX…
• 🇸🇬 MAS Financial Institutions Directory Change Watch — Auditable deltas on Singapore's MAS Financial Institutions Directory — institutions added, removed, or with a licence/profile change. Keyed on the MA…
• 🏢 About NexGenData — NexGen Watch is NexGenData's fleet of 256 public monitoring and lookup actors built on official sources, pay-per-result. Browse the catalog at apify.com/nexgenwatch.

⭐ Found this useful?

If this actor saved you a manual check, a quick review on the Apify Store helps other teams find it. Feature request or a source that changed? Open it from the Issues tab — every one is read.