# Työmarkkinatori.fi Scraper - Finland Employment Service (`studio-amba/tyomarkkinatori-scraper`) Actor

Scrape job vacancies from Työmarkkinatori.fi, Finland's national public employment service (the post-TE24-reform successor to TE-palvelut/TE-toimisto). Search by keyword. Extract titles, employers, ESCO occupations, locations, employment type, and full job descriptions. No login required.

- **URL**: https://apify.com/studio-amba/tyomarkkinatori-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Jobs
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 result scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

### What does Työmarkkinatori.fi Scraper do?

**Työmarkkinatori.fi Scraper** extracts job vacancies from [Työmarkkinatori.fi](https://tyomarkkinatori.fi), the official job search of Finland's national public employment service (PES). Työmarkkinatori.fi is the current, TE24-reform site — it replaced the old TE-palvelut/TE-toimisto brand and domain in January 2025. This actor collects job titles, employers (with Finnish business ID / Y-tunnus), ESCO occupation classifications, locations, employment type, and — optionally — the full job description text plus the hiring contact's name, email, and phone, directly from the site's own JSON search API. No login or cookies required.

Use it on the Apify platform to get structured Finnish labour-market data via API, schedule recurring scrapes, and integrate with tools like Zapier, Make, Google Sheets, and Slack.

### How to scrape Finland job vacancy data

1. Go to the Työmarkkinatori.fi Scraper on the Apify Store.
2. Click **Try for free** to open the actor in the Apify Console.
3. Enter a Finnish-language job keyword (e.g. "sairaanhoitaja", "ohjelmistokehittäjä", "myyjä") or leave it empty to browse all current active vacancies nationwide.
4. Set the maximum number of results you want.
5. Optionally toggle off "Fetch Full Description" if you only need the search-result summary (faster, fewer requests).
6. Click **Start** and wait for the run to finish.
7. Download your data as JSON, CSV, Excel, or HTML from the Output tab.

### Why use Työmarkkinatori.fi Scraper?

- **Recruitment and hiring** — Monitor vacancies registered with Finland's public employment service to understand hiring trends by region, occupation, and employment type.
- **Labor market analysis** — Track which occupations and regions have the most open positions, and which employers are hiring most actively, using the same ESCO occupation taxonomy used across the EU.
- **Lead generation** — Every vacancy includes the employer's Finnish business ID (Y-tunnus) and, when enabled, a direct hiring-contact email and phone — a clean join key for B2B/recruitment outreach.
- **Full job-ad text** — Unlike some public employment services that only publish structured metadata, Työmarkkinatori.fi's employer-authored job descriptions are full free-text ads, so you get the same detail a job seeker would read.
- **Academic and public-policy research** — Gather structured Finnish labour-market data straight from the official employment service registry, including employment type (permanent, temporary, seasonal, summer job) and work-time arrangement.

### Input

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `searchQuery` | String | No | Finnish-language job keyword (e.g. "sairaanhoitaja", "ohjelmistokehittäjä", "myyjä"). Full-text matched against the vacancy title and description. Leave empty to browse all current active vacancies nationwide. |
| `maxResults` | Integer | No | Maximum number of job vacancies to scrape (default: 100, max: 15000). |
| `fetchFullDescription` | Boolean | No | Fetch the full job description text, ESCO occupation label, hiring contact name/email/phone, and exact workplace address per vacancy (default: `true`, 1 extra request per job). Disable for faster, lighter runs — this only changes how *complete* each record is, not how many records you get. |
| `proxyConfiguration` | Object | No | Proxy settings. Työmarkkinatori.fi's job API has no anti-bot protection and isn't geo-locked, so Apify's automatic/free proxy pool is used by default — no residential proxy needed. |

### Output

Each result contains structured data about a single job vacancy. You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

#### Example output

```json
{
    "jobId": "fe243c61-dc9c-413e-8340-bb2a0deefec4",
    "jobTitle": "Sairaanhoitaja, Attendo Vappula, Lohja",
    "company": "Attendo Oy",
    "companyBusinessId": "1755463-2",
    "occupation": "sairaanhoitaja",
    "occupationEn": "nurse responsible for general care",
    "numberOfPositions": 1,
    "employmentType": "Employment relationship",
    "workTime": "Full-time",
    "continuity": "Permanent",
    "city": "Lohja",
    "region": "Uusimaa",
    "country": "Suomi",
    "postalCode": "08700",
    "address": "Ansatie 30",
    "jobDescription": "Sairaanhoitaja ikäihmisten pariin Attendo Vappulaan, Lohjalle...",
    "contactName": "Tuija Hantula-Teuronen",
    "contactEmail": "tuija.hantula-teuronen@attendo.fi",
    "contactPhone": null,
    "applicationUrl": "https://ura.attendo.fi/jobs/8207983-sairaanhoitaja-attendo-vappula-lohja/applications/new?promotion=2141780-tyomarkkinatori",
    "postedDate": "2026-08-12T09:19:03.599Z",
    "expiresDate": "2026-08-30T00:00:00Z",
    "url": "https://tyomarkkinatori.fi/henkiloasiakkaat/avoimet-tyopaikat/fe243c61-dc9c-413e-8340-bb2a0deefec4/fi",
    "scrapedAt": "2026-08-12T09:29:22.407Z"
}
```

### Data fields

| Field | Type | Description |
|-------|------|-------------|
| `jobId` | String | Työmarkkinatori.fi internal vacancy identifier (UUID) |
| `jobTitle` | String | Job title as registered by the employer |
| `company` | String | Employer name |
| `companyBusinessId` | String | Finnish business ID (Y-tunnus) of the employer |
| `occupation` | String | Official ESCO occupation classification label in Finnish (only with `fetchFullDescription`) |
| `occupationEn` | String | Official ESCO occupation classification label in English (only with `fetchFullDescription`) |
| `numberOfPositions` | Integer | Number of open positions for this vacancy (only with `fetchFullDescription`) |
| `employmentType` | String | Employment relationship type, e.g. "Employment relationship", "Temporary agency work", "Entrepreneurship" |
| `workTime` | String | Working time arrangement, e.g. "Full-time", "Part-time" |
| `continuity` | String | Duration of the vacancy, e.g. "Permanent", "Temporary", "Seasonal work", "Summer job" |
| `city` | String | Municipality where the job is located |
| `region` | String | Region (maakunta) where the job is located |
| `country` | String | Country where the job is located (almost always Finland; a small number are EURES cross-border listings) |
| `postalCode` | String | Postal code of the workplace |
| `address` | String | Street address of the workplace, when disclosed (only with `fetchFullDescription`) |
| `jobDescription` | String | Full job description text in Finnish (only with `fetchFullDescription`) |
| `contactName` | String | Hiring contact's name, when disclosed (only with `fetchFullDescription`) |
| `contactEmail` | String | Hiring contact's email, when disclosed (only with `fetchFullDescription`) |
| `contactPhone` | String | Hiring contact's phone, when disclosed (only with `fetchFullDescription`) |
| `applicationUrl` | String | External URL to apply for the vacancy (employer/recruiter's own application system) |
| `postedDate` | String | ISO 8601 date the vacancy was published |
| `expiresDate` | String | ISO 8601 date the application period ends, when set |
| `url` | String | Direct URL to the vacancy detail page on Työmarkkinatori.fi |
| `scrapedAt` | String | ISO 8601 timestamp of when the data was collected |

### Cost estimate

This actor calls Työmarkkinatori.fi's own JSON search API directly rather than rendering pages in a browser, so it runs fast and cheap — roughly **0.2–0.5 compute units per 1,000 results** with full description enabled (1 extra request per job), or about half that with `fetchFullDescription` off. At standard Apify pricing that's well under $0.30 per 1,000 job vacancies. As with any Apify actor, the run's usage cost only settles once the run reports SUCCEEDED — reading a mid-run/in-progress dataset understates the eventual cost.

### Tips

- Use specific job keywords to get more relevant results and reduce run time.
- Leave `searchQuery` empty to pull the newest vacancies across all of Finland — the site currently lists over 10,000 active vacancies.
- Turn off `fetchFullDescription` if you only need title/company/location/employment type — it roughly halves the number of requests.
- Schedule recurring runs to track new vacancies daily or weekly.
- Combine with other Nordic/Baltic PES scrapers for full regional coverage of public-sector job registries.

### Limitations

- Structured salary data is not exposed by this API — when employers disclose a pay range, it's embedded in the free-text job description rather than a separate field.
- Contact email/phone and full description are only populated when `fetchFullDescription` is enabled, and even then some employers leave contact details blank.
- `occupation`/`occupationEn` (ESCO classification) and `numberOfPositions` also require `fetchFullDescription`, since the search-result summary doesn't include them.
- Data is scraped from the public Työmarkkinatori.fi website and may change without notice.

### Integrations

Connect Työmarkkinatori.fi Scraper with your existing tools and workflows:

- **Google Sheets** — Export vacancies directly to a spreadsheet for easy filtering and sharing.
- **Slack** — Get notified when new vacancies matching your criteria appear.
- **Zapier / Make** — Build workflows that react to new job postings in real time.
- **Custom API** — Access all results programmatically via the Apify API in JSON format.

### FAQ and support

**Is it legal to scrape Työmarkkinatori.fi?** Scraping publicly available data is generally permitted under EU law. This actor only accesses public job vacancies that require no login, via the same API the public search page uses.

**How often is the data updated?** The actor scrapes live data from Työmarkkinatori.fi each time it runs. Schedule it daily or weekly to track changes.

**What happened to TE-palvelut / TE-toimisto?** Työmarkkinatori.fi is the current site. Finland's PES reformed its services (the "TE24" reform) and retired the old te-palvelut.fi domain and TE-toimisto brand in January 2025 — this actor targets the live successor site.

**I found a bug or have a feature request.** Open an issue in the Issues tab on the actor page. You can also request a custom scraping solution.

### Need this data on a schedule, or a custom version?

We run this scraper as a managed service for businesses: scheduled runs,
deduplication, delta detection, and delivery to your inbox, Google Sheets,
or API — maintenance included. We can also build a custom version with your
exact fields and filters, or combine multiple sources into one feed.

See [studioamba.dev/services](https://studioamba.dev/services/) or email
<hello@studioamba.dev> for a free data sample.
We maintain 300+ European web scrapers and answer within one business day.

# Actor input Schema

## `searchQuery` (type: `string`):

Job/occupation keyword in Finnish (e.g. 'sairaanhoitaja', 'ohjelmistokehittäjä', 'myyjä'). Matched as full-text search against the vacancy title and description. Leave empty to browse all current active vacancies nationwide.

## `maxResults` (type: `integer`):

Maximum number of job vacancies to scrape.

## `fetchFullDescription` (type: `boolean`):

Fetch the full job description text, ESCO occupation label, hiring contact name/email/phone, and exact workplace address for each vacancy (1 extra request per job). Disable for faster runs when you only need the search-result summary fields (title, employer, location, employment type).

## `proxyConfiguration` (type: `object`):

Proxy settings. Työmarkkinatori.fi's job API has no anti-bot protection and is not geo-locked, so Apify's automatic/free proxy pool works fine — no residential proxy needed. See docs/site-recon/tyomarkkinatori-fi.md.

## Actor input object example

```json
{
  "searchQuery": "sairaanhoitaja",
  "maxResults": 20,
  "fetchFullDescription": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQuery": "sairaanhoitaja",
    "maxResults": 20,
    "fetchFullDescription": true,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/tyomarkkinatori-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQuery": "sairaanhoitaja",
    "maxResults": 20,
    "fetchFullDescription": True,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/tyomarkkinatori-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQuery": "sairaanhoitaja",
  "maxResults": 20,
  "fetchFullDescription": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call studio-amba/tyomarkkinatori-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/tyomarkkinatori-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/NKMInl8SiQ8lau26w/builds/s7hCQPGdB1fhaUHS1/openapi.json