# Barona.fi Scraper — Finnish Staffing Agency Job Listings (`studio-amba/barona-scraper`) Actor

Scrape job listings from Barona.fi, one of the largest staffing and recruitment agencies in Finland. Search by keyword, filter by location or country. No login or cookies required.

- **URL**: https://apify.com/studio-amba/barona-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/actors/running/actors-in-store.md#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

## Barona.fi Scraper

Extract job listings from [Barona.fi](https://www.barona.fi), one of the largest staffing and recruitment agencies in Finland, as clean structured JSON. Search by keyword, filter by city or country, and get job titles, companies, locations, contract type and full descriptions in one run.

No login. No cookies. No browser automation. The actor reads the same JSON feed the Barona.fi website itself calls to render its job-search page, so it is fast and stable.

### What this actor does

Given an optional search keyword, this actor collects the matching job listings from Barona.fi and returns one row per job with:

- Job title
- Hiring company (a Barona subsidiary like "Barona Rakennus Oy", or a named end client such as Ramirent)
- City and all covered work locations
- Country (Barona.fi mostly lists Finnish roles, but occasionally carries postings for other Barona markets)
- Industry and profession taxonomy labels
- Seniority level, job type (full-time/part-time) and contract type (permanent, fixed-term, temporary, gig, seasonal)
- Posting language, campaign start/end dates
- Full plain-text description (HTML stripped)
- The job's unique ID and direct application URL (Barona Careers / Fuzu)

Leave the search query empty and the actor returns Barona's full active catalog — no keyword is required to get data.

### Why use it

- **Staffing market research** — track what roles Finland's largest staffing agency is placing, for whom, and where.
- **Recruitment and sourcing** — build a live feed of temp and permanent positions for a role or region.
- **Competitive intelligence** — compare Barona's open roles against TE-palvelut public listings or Duunitori's aggregated board.
- **Aggregators and job boards** — feed Finnish staffing-agency listings into your own product.

### How to scrape Barona data

1. Open the actor and set a **Search Query** (for example `logistiikka`, `myyjä`, `asentaja`) — or leave it empty to pull the entire active job catalog.
2. Optionally set a **Location filter** such as `Helsinki`, `Tampere` or `Jyväskylä` to narrow results to that city.
3. Optionally set a **Country filter** (ISO code, e.g. `FI`) if you want to isolate Finland-only postings from the occasional cross-border listing.
4. Set **Max Results**.
5. Leave the proxy on the default automatic setting (Barona.fi has no anti-bot protection) and click **Start**.

The actor calls Barona.fi's own job-feed API for your keyword, paginates through the results, applies your location/country filters client-side, and writes everything to the dataset. You can export the result as JSON, CSV or Excel.

### Input

| Field | Type | Description |
|-------|------|-------------|
| `searchQuery` | string | Keyword to search for (matched server-side against title/content). Leave empty for the full active catalog. Default (prefill): `logistiikka`. |
| `location` | string | Optional city filter, applied client-side (e.g. `Helsinki`, `Tampere`). |
| `country` | string | Optional ISO country code filter, applied client-side (e.g. `FI`, `SE`, `NO`). |
| `maxResults` | integer | Maximum number of listings to return. Default: `100`. |
| `proxyConfiguration` | object | Apify proxy settings. Default: automatic (no residential needed). |

#### Example input

```json
{
    "searchQuery": "logistiikka",
    "location": "Helsinki",
    "maxResults": 50,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
}
```

### Output

Each dataset item looks like this (real output from a test run):

```json
{
    "jobId": "102544",
    "fuzuJobId": "71430",
    "title": "Rakennuslogistiikkatyöntekijöitä Uudellemaalle",
    "company": "Suomen Rakennuslogistiikka Oy",
    "companyBusinessId": "2085490-0",
    "companyLogoUrl": "https://fuzu-barona-production-public.s3.eu-west-1.amazonaws.com/employers/e903bb33-0474-45d9-b4ca-6a0dfb45f6a9.png",
    "city": "Helsinki",
    "cities": ["Helsinki", "Vantaa", "Espoo", "Kirkkonummi"],
    "country": "FI",
    "postalCode": null,
    "street": null,
    "industry": "Rakentaminen, kiinteistöt ja arkkitehtuuri",
    "profession": "Rakentaminen, kiinteistöt ja arkkitehtuuri",
    "seniorityLevel": "junior",
    "jobType": "full_time",
    "permanentPosition": "permanent",
    "postingLanguage": "fi",
    "description": "Etsimme vahvistuksia rakennuslogistiikan tiimeihin eri työmaille ympäri Uuttamaata...",
    "campaignStartDate": "2026-08-05",
    "campaignEndDate": "2026-09-19",
    "url": "https://www.baronacareers.com/fi/fi/jobs/rakennuslogistiikkatyontekijoita-uudellemaalle-suomen-rakennuslogistiikka-oy-15219a05",
    "source": "barona.fi",
    "scrapedAt": "2026-09-02T10:12:03.512Z"
}
```

#### Output fields

| Field | Type | Description |
|-------|------|-------------|
| `jobId` | string | Unique Barona job identifier |
| `fuzuJobId` | string | Underlying Fuzu ATS job identifier |
| `title` | string | Job title |
| `company` | string | Hiring company as posted — a Barona subsidiary or a named end client |
| `companyBusinessId` | string | Finnish Y-tunnus (business ID) of the hiring company |
| `companyLogoUrl` | string | Hiring company's logo image URL |
| `city` | string | Primary city of the job listing |
| `cities` | array | All cities this listing applies to |
| `country` | string | ISO country code of the job location |
| `postalCode` | string | Postal code, when disclosed |
| `street` | string | Street address, when disclosed |
| `industry` | string | Barona industry taxonomy label |
| `profession` | string | Barona profession taxonomy label |
| `seniorityLevel` | string | `junior`, `mid` or `high` |
| `jobType` | string | `full_time` or `part_time` |
| `permanentPosition` | string | `permanent`, `fixed_term`, `temporary`, `gig` or `seasonal_work` |
| `postingLanguage` | string | Language the listing was written in (`fi` or `en`) |
| `description` | string | Plain-text job description (HTML stripped), truncated to 8000 characters |
| `campaignStartDate` | string | Date the listing went live (YYYY-MM-DD) |
| `campaignEndDate` | string | Application deadline (YYYY-MM-DD) |
| `url` | string | Application URL (Barona Careers / Fuzu ATS) |
| `source` | string | Source site identifier (`barona.fi`) |
| `scrapedAt` | string | ISO 8601 timestamp of collection |

### Cost estimate

This actor makes one lightweight JSON API request per 100 results — no browser, no per-item detail-page fetches. A 100-result run typically finishes in a few seconds; cost is dominated by the per-result charge, not compute or proxy traffic. Usage is only charged after a run finishes with status SUCCEEDED — a failed or aborted run doesn't bill for partial results.

### Limitations

- **Finland-focused, not strictly Finland-only.** Barona.fi's feed is ~96% Finnish listings, but occasionally carries a handful of postings for other Barona markets (Sweden, Norway, Poland, and others observed). Use the `country` filter to isolate Finland-only results if you need a clean single-market dataset.
- **Barona.fi only — sibling country sites are a different platform.** `barona.se` and `barona.no` are backed by a completely different ATS (recman.io) with an unrelated response shape; `barona.ee` returned no data in testing. Each would need its own recon and actor, the same way Randstad's country sites each run on a different platform under one brand.
- **Location filtering is client-side.** Barona's own location-taxonomy filter parameter did not reliably narrow results to the requested city in testing, so the `location` input matches by substring against each listing's city/cities fields instead.
- **Salary is not published.** Barona.fi listings don't expose structured pay-rate data.

### Related scrapers

Building a Nordic staffing and public-employment dataset? These sibling actors follow the same clean-JSON approach:

- **Adecco Scraper** — multi-country staffing agency job listings
- **Academic Work Scraper** — Nordic staffing agency, Sweden listings
- **Randstad Belgium Scraper** — Belgian arm of the world's largest staffing agency
- **Duunitori Scraper** — Finnish aggregated job board with salary data
- **NAV Norway Scraper** — Norway's public employment service listings
- **Arbetsformedlingen Scraper** — Sweden's public employment service listings

### Disclaimer

This actor collects publicly available data from Barona.fi for legitimate research and aggregation use. Respect Barona's terms of service and applicable data protection law when using the output.

# Actor input Schema

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

Keyword to search for (e.g. 'logistiikka', 'myyjä', 'asentaja'). Matched server-side against the job title and content. Leave empty to return the full active job catalog (no filter).

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

Optional city to filter results by (e.g. 'Helsinki', 'Tampere', 'Jyväskylä'). Applied client-side against each listing's city/cities fields — Barona's own location taxonomy filter did not reliably narrow results in testing.

## `country` (type: `string`):

Optional ISO country code to filter results by (e.g. 'FI', 'SE', 'NO'). Barona.fi's feed is FI-dominant (~96% of listings) but also carries occasional postings for other Barona markets. Applied client-side.

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

Maximum number of job listings to return.

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

Proxy settings. Barona.fi has no anti-bot protection (plain WordPress AJAX endpoint) — Apify's automatic/free proxy pool is sufficient.

## Actor input object example

```json
{
  "searchQuery": "logistiikka",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

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

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

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

```

## MCP server setup

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