# Duunitori Scraper - Finnish Job Listings & Salaries (`studio-amba/duunitori-scraper`) Actor

Scrape job listings from Duunitori.fi, Finland's leading job board with 22,000+ listings. Search by keyword, location, and category. Extract job titles, companies, salaries, employment types, descriptions, and application deadlines. No login or cookies required.

- **URL**: https://apify.com/studio-amba/duunitori-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

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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 Duunitori Scraper do?

**Duunitori Scraper** extracts job listings from [Duunitori.fi](https://duunitori.fi), Finland's largest and most popular job board with over 22,000 active listings. It collects job titles, companies, salaries, locations, employment types, categories, application deadlines, and full job descriptions. The scraper supports Finnish-language searches and covers all regions of Finland. No login or cookies required.

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

### How to scrape Duunitori data

1. Go to the Duunitori Scraper on the Apify Store.
2. Click **Try for free** to open the actor in the Apify Console.
3. Enter a search query in Finnish (e.g. "ohjelmoija" for programmer) or English (e.g. "developer").
4. Optionally set a location (e.g. "Helsinki", "Tampere", "Oulu").
5. Optionally filter by category (e.g. "IT", "myynti").
6. Set the maximum number of results you want.
7. Click **Start** and wait for the run to finish.
8. Download your data as JSON, CSV, Excel, or HTML from the Output tab.

### Why use Duunitori Scraper?

- **Recruitment and hiring** -- Monitor job postings from competitors or across sectors to understand hiring trends in Finland.
- **Salary research** -- Collect salary data across roles and regions to benchmark compensation in the Finnish market.
- **Market analysis** -- Track which sectors are growing, which companies are hiring most, and where demand is concentrated across Finland.
- **Lead generation** -- Identify companies actively hiring in Finland to target with B2B recruitment services or tools.
- **Academic research** -- Gather structured Finnish labor market data for economic, sociological, or policy studies.
- **Job aggregation** -- Feed Finnish job data into your own job board, career platform, or notification system.

### Input

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `searchQuery` | String | No | Job search keyword in Finnish or English (e.g. "ohjelmoija", "developer", "myynti"). Defaults to "ohjelmoija" if empty. |
| `location` | String | No | City or region (e.g. "Helsinki", "Tampere", "Turku", "Oulu"). Leave empty for all Finland. |
| `category` | String | No | Job category/industry filter (e.g. "IT", "myynti", "terveydenhuolto"). Leave empty for all categories. |
| `maxResults` | Integer | No | Maximum number of job listings to scrape (default: 100, max: 10000). |
| `proxyConfiguration` | Object | No | Proxy settings. Finnish residential proxies recommended for best results. |

#### Example input

```json
{
    "searchQuery": "ohjelmoija",
    "location": "Helsinki",
    "maxResults": 50,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "FI"
    }
}
````

### Output

Each result contains structured data about a single job listing scraped from both the search results page and the individual job detail page. You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

#### Example output

```json
{
    "jobTitle": "Software Developer",
    "company": "Hitachi High-Tech Analytical Science",
    "location": "Helsinki",
    "salary": "3 500 - 5 000 EUR/kk",
    "employmentType": "Kokoaikainen, Vakinainen",
    "category": "IT, ohjelmointi",
    "postedDate": "29.5",
    "applicationDeadline": "15.6.2026",
    "jobDescription": "Mitä on luvassa? We are looking for a Software Developer to join our team in Helsinki...",
    "url": "https://duunitori.fi/tyopaikat/tyo/software-developer-sdsuu-20310770",
    "scrapedAt": "2026-06-09T12:30:00.000Z"
}
```

### Data fields

| Field | Type | Description |
|-------|------|-------------|
| `jobTitle` | String | Job position title |
| `company` | String | Hiring company name |
| `location` | String | Job location (city or region in Finland) |
| `salary` | String | Salary information when available (e.g. "3 500 - 5 000 EUR/kk") |
| `employmentType` | String | Type of employment (Kokoaikainen, Osa-aikainen, Maaraaikainen, Vakinainen) |
| `category` | String | Job category or industry sector |
| `postedDate` | String | When the job was published (e.g. "29.5") |
| `applicationDeadline` | String | Last date to apply |
| `jobDescription` | String | Full job description text from the detail page |
| `url` | String | Direct URL to the job listing on Duunitori.fi |
| `scrapedAt` | String | ISO 8601 timestamp of when the data was collected |

### Cost estimate

This actor uses approximately **1 compute unit per 500 results** because it visits both search pages and individual detail pages. With the Apify free tier you can run smaller scrapes at no cost. For larger runs, expect roughly $0.50 per 500 job listings at standard Apify pricing.

### Tips

- Use Finnish keywords for better results (e.g. "ohjelmoija" instead of "programmer", "myynti" for sales).
- Set `maxResults` to a reasonable number to control cost and run time.
- Finnish residential proxies are recommended for reliable scraping.
- Schedule recurring runs to track new job postings daily or weekly.
- Combine with other Nordic/Finnish job scrapers (Arbetsformedlingen, Jobly.fi) for comprehensive market coverage.
- Empty input `{}` works out of the box -- it searches for "ohjelmoija" (programmer) across all of Finland.

### Finnish employment type reference

| Finnish | English |
|---------|---------|
| Kokoaikainen | Full-time |
| Osa-aikainen | Part-time |
| Maaraaikainen | Fixed-term |
| Vakinainen | Permanent |
| Kesatyo | Summer job |
| Harjoittelu | Internship |
| Vuokratyo | Temporary/agency work |

### Limitations

- Salary data is not available for all listings -- many Finnish employers do not publish salary ranges on Duunitori.
- Some fields may be empty depending on how the employer filled in the listing.
- The site is primarily in Finnish, so search queries in Finnish yield the best results.
- Data is scraped from the public website and may change without notice if Duunitori updates their HTML structure.

### Integrations

Connect Duunitori Scraper with your existing tools and workflows:

- **Google Sheets** -- Export Finnish job listings directly to a spreadsheet for easy filtering and sharing.
- **Slack** -- Get notified when new jobs matching your criteria appear on Duunitori.
- **Zapier / Make** -- Build workflows that react to new Finnish 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 Duunitori.fi?** Scraping publicly available data is generally permitted under EU law. This actor only accesses public job listings that require no login.

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

**Why are some fields empty?** Not all employers provide salary, employment type, or category information. The scraper extracts all available data from each listing.

**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.

# Actor input Schema

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

Job search keyword in Finnish or English (e.g. 'ohjelmoija', 'developer', 'myynti'). Defaults to 'ohjelmoija' if empty.

## `location` (type: `string`):

City or region in Finland (e.g. 'Helsinki', 'Tampere', 'Turku', 'Oulu'). Leave empty for all Finland.

## `category` (type: `string`):

Job category/industry filter (e.g. 'IT', 'myynti', 'terveydenhuolto'). Leave empty for all categories.

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

Maximum number of job listings to scrape.

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

Proxy settings. Finnish residential proxies recommended for best results.

## Actor input object example

```json
{
  "searchQuery": "ohjelmoija",
  "maxResults": 100,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "FI"
  }
}
```

# 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": "ohjelmoija",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "FI"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/duunitori-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": "ohjelmoija",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "FI",
    },
}

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

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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": "ohjelmoija",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "FI"
  }
}' |
apify call studio-amba/duunitori-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=studio-amba/duunitori-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Duunitori Scraper - Finnish Job Listings & Salaries",
        "description": "Scrape job listings from Duunitori.fi, Finland's leading job board with 22,000+ listings. Search by keyword, location, and category. Extract job titles, companies, salaries, employment types, descriptions, and application deadlines. No login or cookies required.",
        "version": "0.1",
        "x-build-id": "CTAddRdIMV5w4InuR"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/studio-amba~duunitori-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-studio-amba-duunitori-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/studio-amba~duunitori-scraper/runs": {
            "post": {
                "operationId": "runs-sync-studio-amba-duunitori-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/studio-amba~duunitori-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-studio-amba-duunitori-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "searchQuery": {
                        "title": "Search Query",
                        "type": "string",
                        "description": "Job search keyword in Finnish or English (e.g. 'ohjelmoija', 'developer', 'myynti'). Defaults to 'ohjelmoija' if empty.",
                        "default": "ohjelmoija"
                    },
                    "location": {
                        "title": "Location",
                        "type": "string",
                        "description": "City or region in Finland (e.g. 'Helsinki', 'Tampere', 'Turku', 'Oulu'). Leave empty for all Finland."
                    },
                    "category": {
                        "title": "Category",
                        "type": "string",
                        "description": "Job category/industry filter (e.g. 'IT', 'myynti', 'terveydenhuolto'). Leave empty for all categories."
                    },
                    "maxResults": {
                        "title": "Max Results",
                        "minimum": 1,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "Maximum number of job listings to scrape.",
                        "default": 100
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Proxy settings. Finnish residential proxies recommended for best results."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
