# Tootukassa Scraper - Estonia Official Public Job Bank (`studio-amba/tootukassa-scraper`) Actor

Scrape job listings from Tootukassa.ee, Estonia's official public employment service (Eesti Töötukassa). Extract job titles, employers, locations, application deadlines and direct links. No login or cookies required.

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

## Tootukassa Scraper

Scrape job listings from [Tootukassa.ee](https://www.tootukassa.ee), Estonia's official public employment service (Eesti Töötukassa).

### What does Tootukassa Scraper do?

**Tootukassa Scraper** extracts job vacancies directly from Tootukassa.ee's own public search API — the same source the site's Angular front end uses. It collects job titles, employers, workplace addresses, full-time/part-time/remote-work flags, application deadlines, and direct links to every listing, for the full native job bank or filtered by keyword. No login or cookies required.

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

### How to scrape Tootukassa data

1. Go to the Tootukassa Scraper page on the Apify Store.
2. Click **Try for free** to open the actor in the Apify Console.
3. Enter an Estonian search keyword (e.g. "müüja" = salesperson, "ehitaja" = builder, "raamatupidaja" = accountant), or leave it empty to browse the full native job bank.
4. Set the maximum number of results you want.
5. Click **Start** and wait for the run to finish.
6. Download your data as JSON, CSV, Excel, or HTML from the Output tab.

### Why use Tootukassa Scraper?

- **Recruitment and hiring** — Monitor vacancies registered with Estonia's public employment service to understand hiring trends by region, sector, and occupation.
- **Labor market analysis** — Track which regions and employers are hiring most actively, and how many roles are full-time vs. part-time vs. remote-friendly.
- **Company research** — Cross-reference employer names and IDs against other Estonian company data sources to build a hiring signal for outbound sales or investment research.
- **Academic and public-policy research** — Gather structured Estonian labour-market data straight from the official employment service registry, without navigating the site by hand.
- **Deadline tracking** — Surface application deadlines to build alerts for roles closing soon.

### Input

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `searchQuery` | String | No | Estonian search keyword (e.g. "müüja" = salesperson, "ehitaja" = builder, "raamatupidaja" = accountant). Leave empty to browse the full native job bank (thousands of live listings). |
| `maxResults` | Integer | No | Maximum number of job listings to scrape (default: 100, max: 10,000). |
| `proxyConfiguration` | Object | No | Proxy settings. Tootukassa.ee's API works reliably over Apify's automatic proxy — no residential proxy or anti-bot handling required. |

### 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": 833709,
    "jobTitle": "Kaupluse töötaja",
    "jobTitleDetail": "Kiili Maxima",
    "company": "MAXIMA Eesti OÜ",
    "brand": null,
    "employerId": 8143,
    "location": "Harju maakond, Kiili vald, Kiili alev, Vaela tee 4",
    "addresses": [
        "Harju maakond, Kiili vald, Kiili alev, Vaela tee 4"
    ],
    "remoteWork": false,
    "fullTime": true,
    "partTime": false,
    "hasImage": true,
    "confirmedDate": "2026-08-10T00:00:00.000Z",
    "deadline": "2026-09-03T00:00:00.000Z",
    "url": "https://www.tootukassa.ee/et/toopakkumised/kaupluse-tootaja-833709",
    "scrapedAt": "2026-08-10T19:35:36.457Z"
}
```

### Data fields

| Field | Type | Description |
|-------|------|-------------|
| `jobId` | Integer | Tootukassa internal job offer identifier |
| `jobTitle` | String | Job listing title (Estonian) |
| `jobTitleDetail` | String | Additional clarification of the role or workplace (e.g. specific store/branch name), when provided |
| `company` | String | Hiring organization name |
| `brand` | String | Consumer-facing brand name, when different from the legal company name |
| `employerId` | Integer | Tootukassa internal employer/institution identifier |
| `location` | String | Job location(s), joined from all listed workplace addresses |
| `addresses` | Array | Individual workplace addresses (county, municipality, town/city, street), as a list |
| `remoteWork` | Boolean | Whether the position allows remote/home working |
| `fullTime` | Boolean | Whether the position is full-time |
| `partTime` | Boolean | Whether the position is part-time |
| `hasImage` | Boolean | Whether the listing has an employer logo/image on Tootukassa |
| `confirmedDate` | String | Last date the listing was reconfirmed as active by the employer/consultant (ISO 8601). Not a reliable original-posting date — Tootukassa requires periodic reconfirmation to keep a listing live. |
| `deadline` | String | Application deadline (ISO 8601), when disclosed |
| `url` | String | Direct URL to the job listing on Tootukassa.ee |
| `scrapedAt` | String | ISO 8601 timestamp of when the data was collected |

### Cost estimate

This actor calls Tootukassa.ee's own GraphQL search endpoint directly rather than rendering pages in a browser, so it runs fast and cheap — well under $0.30 per 1,000 job listings at standard Apify pricing. 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 Estonian job keywords to get more relevant results and reduce run time.
- Leave `searchQuery` empty to pull the full native job bank across all of Estonia.
- `confirmedDate` reflects the last reconfirmation, not the original posting date — use `deadline` for time-sensitivity instead.
- Schedule recurring runs to track new vacancies daily or weekly.

### Limitations

- The site's own UI and this actor are in Estonian; `searchQuery` keywords must be Estonian terms to match.
- `deadline` is only populated when the employer disclosed an application deadline.
- `brand` is only populated when the employer registered a separate consumer-facing brand name.
- This actor covers native Estonian listings only (`eestiToopakkumine`); it excludes EURES cross-border postings surfaced elsewhere on the site.
- Data is scraped from the public Tootukassa.ee website and may change without notice.

### Integrations

Connect Tootukassa 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 Tootukassa.ee?** Scraping publicly available data is generally permitted under EU law. This actor only accesses public job vacancies that require no login, via the same endpoint the public search page uses.

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

**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`):

Estonian search keyword (e.g. 'müüja' = salesperson, 'ehitaja' = builder, 'raamatupidaja' = accountant). Leave empty to browse the full native job bank (thousands of live listings).

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

Maximum number of job listings to scrape.

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

Proxy settings. Tootukassa.ee's API works reliably over Apify's automatic proxy -- no residential proxy or anti-bot handling required.

## Actor input object example

```json
{
  "searchQuery": "müüja",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# 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": "müüja",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/tootukassa-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": "müüja",
    "maxResults": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/tootukassa-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": "müüja",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call studio-amba/tootukassa-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/tootukassa-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/SICwZ2HgrSR9geoYA/builds/R6FDc1sSa0jbm3niN/openapi.json