Työmarkkinatori.fi Scraper

Scrape structured job listings from Työmarkkinatori.fi — Finland. 30,000+ active listings. No API key required.

---

Why this scraper?

🏛️ Finland's official employment service

Työmarkkinatori.fi is Finland's government employment portal, operated by the Ministry of Economic Affairs and Employment.

📄 Full job descriptions

Enable fetchDetails to retrieve complete job descriptions in all three formats.

💰 EUR salary data

Salary data extracted where published.

🔄 Repost detection

Cross-run deduplication with a 90-day TTL. Use skipReposts: true for new-only feeds.

🔗 Direct URL scraping

Supply specific Työmarkkinatori search or category URLs via startUrls.

⚙️ No API key required

Runs without any third-party credentials.

---

Input parameters

Parameter	Type	Description	Default
query	string	Job title, keyword, or skill to search for.	—
municipalities	array	Filter by municipalities.	—
regions	array	Filter by regions.	—
employmentRelationships	string	employmentRelationships.	—
continuityOfWork	string	continuityOfWork.	—
workTimes	string	workTimes.	—
postingLanguages	string	postingLanguages.	—
sorting	string	Sort order for results.	LATEST
daysOld	integer	Only return listings published within the last N days.	0
publishedAfterISO	string	Search or filter by publishedAfterISO.	—
maxResults	integer	Maximum number of results to return.	0
fetchDetails	boolean	Fetch full job description from each listing detail page. Disable for faster list-only results.	true
skipReposts	boolean	Skip listings already seen in previous runs (90-day deduplication window).	false
startUrls	array	List of specific URLs to scrape. Bypasses the search input.	—

---

Output schema

Each result contains the following fields.

Always present:

Field	Type	Description
id	string	Unique job listing ID from the source platform.
url	string	Direct URL to the job listing.
title	string	Job title as published.
company	string	Employer / company name.
location	string	Full location string as published.
city	string	City of the work location.
country	string	Country code (ISO 3166-1 alpha-2).
contractType	string	Contract type (permanent, contract, temporary, etc.).
workSchedule	string	Work schedule (full-time, part-time, etc.).
salaryMin	number	Minimum salary (null if not published by employer).
salaryMax	number	Maximum salary (null if not published by employer).
salaryCurrency	string	ISO 4217 currency code (null if no salary published).
salaryPeriod	string	Salary period: YEAR / MONTH / WEEK / DAY / HOUR.
publishDate	string	Publication date (YYYY-MM-DD).
publishDateISO	string	Publication date in ISO 8601 format.
source	string	Source domain name.
scrapedAt	string	ISO 8601 timestamp of when this item was scraped.
contentHash	string	MD5 hash of key fields for change detection (16 chars).
summary	string	Human-readable one-line summary of the listing.
changeStatus	string	Change status: NEW / MODIFIED / UNCHANGED.
isRepost	boolean	True if this listing was seen in a previous run (90-day window).
originalPublishDate	string	Original publish date if this is a repost (null otherwise).
originalUrl	string	Original URL if this is a repost (null otherwise).

With fetchDetails: true (default):

Field	Type	Description
descriptionHtml	string	Full job description as raw HTML (null if fetchDetails is false).
descriptionText	string	Full job description as plain text (null if fetchDetails is false).
descriptionMarkdown	string	Full job description in Markdown format (null if fetchDetails is false).

Example output record:

{
  "id": "123456",
  "url": "https://tyomarkkinatori.fi/jobs/senior-developer/123456",
  "title": "Insinööri",
  "company": "Tampere University",
  "location": "Tampere",
  "city": "Tampere",
  "country": "FI",
  "contractType": "Permanent",
  "workSchedule": "Full-time",
  "salaryMin": 45000,
  "salaryMax": 60750,
  "salaryCurrency": "EUR",
  "salaryPeriod": "YEAR",
  "publishDate": "2026-04-15",
  "publishDateISO": "2026-04-15",
  "source": "tyomarkkinatori.fi",
  "scrapedAt": "2026-04-24T09:00:00.000Z",
  "contentHash": "a3f1b2c4d5e67890",
  "summary": "Insinööri · Tampere University · Tampere",
  "changeStatus": "NEW",
  "isRepost": false,
  "originalPublishDate": null,
  "originalUrl": null,
  "descriptionHtml": "<p>We are looking for an experienced professional to join our growing team...</p>",
  "descriptionText": "We are looking for an experienced professional to join our growing team...",
  "descriptionMarkdown": "We are looking for an experienced professional to join our growing team..."
}

---

Examples

1 — Search for Insinööri roles in Tampere

{
  "searchQuery": "insin\u00f6\u00f6ri",
  "maxResults": 100
}

2 — All listings without filters

{
  "searchQuery": "",
  "maxResults": 500
}

3 — Scrape a specific search page directly via startUrls

{
  "startUrls": [
    {
      "url": "https://tyomarkkinatori.fi/jobs?q=insin\u00f6\u00f6ri"
    }
  ],
  "maxResults": 50
}

4 — Daily feed — new listings only, past 24 hours, no reposts

{
  "searchQuery": "",
  "fetchDetails": false,
  "daysOld": 1,
  "skipReposts": true,
  "maxResults": 1000
}

---

💰 Pricing

$1.50 per 1,000 results — you only pay for successfully retrieved listings. Failed retries and filtered reposts are never charged.

Results	Cost
100	~$0.15
1,000	~$1.50
10,000	~$15.00
100,000	~$150.00

Flat-rate alternatives typically charge $29–$49/month regardless of usage.

Use the Max results cap in the input to control your spend exactly.

---

Performance

Run size	Approx. time
100 listings	~2 min
1,000 listings	~15 min
10,000 listings	~2.5 hours

---

Known limitations

• Salary: Not all employers publish salary information — salaryMin and salaryMax may be null.
• fetchDetails: Setting fetchDetails: false returns list-page fields only; description fields will be null.

---

Technical details

• Source: tyomarkkinatori.fi — Finland's job market
• Memory: 256 MB
• Repost storage: KeyValueStore tyomarkkinatori-fi-job-dedup, 90-day TTL
• Retry: Automatic retry on network errors, exponential backoff, 3 attempts per request

---

Additional services

Need a custom actor, additional filters, scheduled runs, or integration support? Send an email to info@unfencedgroup.nl — we build on request.

---

Part of the Unfenced Group European job board scraper portfolio — 50+ job markets covered. Built by unfenced-group · Issues? Open a ticket or send a message.