# Praca.pl Job Scraper (`trev0n/praca-pl-scraper`) Actor

Scrape job offers from Praca.pl — one of Poland's largest general job boards. Extract titles, employers, locations, salaries, contract types, work models and full descriptions, with strict city filtering and incremental monitoring.

- **URL**: https://apify.com/trev0n/praca-pl-scraper.md
- **Developed by:** [Paweł](https://apify.com/trev0n) (community)
- **Features:** Limited permissions
- **Stats:** 5 total users, 3 monthly users, 97.1% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 💼 Praca.pl Job Scraper

🎯 **Every offer on one of Poland's biggest job boards, exported in one click — with salaries, employers, locations and full descriptions.**

Praca.pl carries openings across every field: production, logistics, warehousing, retail, healthcare, offices, finance, engineering, laboratories, construction and trades. This scraper turns a search into clean, structured data — position, employer, city, salary band, contract type, working time, work model, publication and closing dates, and the full offer text.

It also fixes the board's most annoying habit: when a city has few matches, Praca.pl quietly widens the search to neighbouring regions. Ask for Kraków and you get Łódź. **Strict city match** is on by default, so you get the city you asked for.

### 🚀 What Does It Do?

This scraper searches Praca.pl and collects **ready-to-use data** for every matching offer. No manual browsing, no copy-paste.

💡 **Two modes of operation:**

1. **🔍 Discovery Mode** — type a keyword and a city; it pages through the whole result set and exports every offer.
2. **📋 Direct URL Mode** — paste Praca.pl links (a search page or a single offer) and get exactly those.

Plus a **📡 Monitoring Mode** that remembers the previous run and returns only what is new, edited or reposted — perfect for a daily scheduled check.

### 👥 Who Is This For?

| 🏢 Use Case                           | 💬 How It Helps                                                             |
| ------------------------------------- | --------------------------------------------------------------------------- |
| 🧑‍💼 **Recruiters & staffing agencies** | See who is hiring in your city and catch fresh openings the day they appear |
| 📊 **Salary & market analysts**       | Build pay benchmarks per role, city and contract type from disclosed bands  |
| 🤖 **Job-board aggregators**          | Feed a steady stream of Polish offers into your own site                    |
| 🎯 **Lead generation**                | Companies that are hiring are companies that are growing — and buying       |
| 🏭 **Employer-brand teams**           | Watch how rivals word their offers, what they pay and how often they repost |
| 🧑‍🎓 **Job seekers & career coaches**   | Filter thousands of offers down to the handful that actually fit            |

### ✨ Features

- 🎯 **Strict city match** — drops the out-of-area offers the board slips into a thin search
- 💰 **Salary parsing that survives Polish formatting** — `12 000 - 13 000 zł brutto/mies.` and `70,00 zł brutto/godz.` both come out as proper numbers, with period and gross/net kept separate
- 📄 **Full descriptions on demand** — one switch adds the complete offer text, the closing date and a street address
- 📡 **Monitoring mode** — only new, updated and reposted offers, cutting a daily check by 80-95%
- 🗺️ **Region-wide offers kept, not lost** — postings that name only a voivodeship are tagged, never dropped
- 🔁 **Automatic pagination** — follows the board's own paging to the last page
- 🧹 **Deduplicated** — an offer appears once, however many times the board repeats it
- ⚡ **Fast and cheap** — no browser, no proxy needed

### ⚙️ Filters & Options

| 🎛️ Option                      | 💬 What It Does                                                           |
| ------------------------------ | ------------------------------------------------------------------------- |
| 🔗 **Start URLs**              | Paste search pages or single offers; overrides the keyword and city below |
| 🔎 **Keyword**                 | What to search for — `laborant`, `technolog`, `magazynier`, `księgowa`    |
| 📍 **City**                    | Where to search — `Kraków`, `Warszawa`, `Gdańsk`                          |
| 🎯 **Strict city match**       | Keep only offers whose own location matches your city (on by default)     |
| 🔢 **Max offers**              | Stop after N offers; 0 means unlimited                                    |
| 📑 **Max search pages**        | Stop after N result pages; 0 follows paging to the end                    |
| 📄 **Fetch full descriptions** | Open every offer for the complete text, closing date and address          |
| 📡 **Monitoring mode**         | Emit only what changed since the previous run                             |
| ➕ **Also emit unchanged**     | Include untouched offers while monitoring                                 |
| ⏳ **Also emit expired**       | Include offers that disappeared since last time                           |
| 🔑 **Monitoring state key**    | Name this baseline; use a different key per saved search                  |
| ⚡ **Max concurrency**         | How many pages to fetch in parallel                                       |
| 🌐 **Proxy**                   | Optional — the board works fine without one                               |

### 📤 Output Fields

#### Identity

| Field        | Description              |
| ------------ | ------------------------ |
| sourcePortal | Always `praca.pl`        |
| offerId      | The board's own offer id |
| url          | Direct link to the offer |
| title        | Position name            |

#### Employer

| Field       | Description                 |
| ----------- | --------------------------- |
| employer    | Company name                |
| employerUrl | The employer's profile page |
| logo        | Company logo image          |

#### Location

| Field             | Description                                                           |
| ----------------- | --------------------------------------------------------------------- |
| location          | Location exactly as the board prints it, e.g. `Skawina, k. Krakowa`   |
| locationPrecision | `city` or `region` — a region-wide posting names only the voivodeship |
| city              | City from the offer page (full descriptions mode)                     |
| region            | Voivodeship (full descriptions mode)                                  |
| street            | Street address (full descriptions mode)                               |
| postalCode        | Postal code (full descriptions mode)                                  |
| workModel         | On-site, hybrid or remote                                             |

#### Terms

| Field          | Description                                  |
| -------------- | -------------------------------------------- |
| seniority      | Level as the board words it                  |
| contractType   | Employment contract, mandate, temporary, B2B |
| workingTime    | Full time, part time                         |
| salaryMin      | Lower end of the band                        |
| salaryMax      | Upper end of the band                        |
| salaryCurrency | Usually PLN                                  |
| salaryPeriod   | `hour`, `day`, `month` or `year`             |
| salaryGross    | True for gross, false for net                |
| salaryText     | The band exactly as printed                  |

#### Content

| Field       | Description                                              |
| ----------- | -------------------------------------------------------- |
| teaser      | Short summary shown in the result list                   |
| description | Full offer text (full descriptions mode)                 |
| category    | Job category from the offer page                         |
| industry    | Industry label from the offer page                       |
| applyFlags  | Application shortcuts such as quick apply or no-CV apply |
| directApply | Whether the board handles the application itself         |

#### Dates & tracking

| Field        | Description                                              |
| ------------ | -------------------------------------------------------- |
| postedAgo    | How long ago it appeared, as the board words it          |
| publishedAt  | Publication date (full descriptions mode)                |
| validThrough | Closing date (full descriptions mode)                    |
| expiringSoon | True when the board flags the offer as closing shortly   |
| changeType   | `NEW`, `UPDATED`, `UNCHANGED`, `REAPPEARED` or `EXPIRED` |
| contentHash  | Fingerprint used to detect edits between runs            |
| scrapedAt    | When this record was collected                           |

### 📦 Example Output

```json
{
    "sourcePortal": "praca.pl",
    "offerId": "11277511",
    "url": "https://www.praca.pl/operator-laboratorium_11277511.html",
    "title": "Operator Laboratorium",
    "employer": "Valeo Thermal Systems",
    "employerUrl": "https://www.praca.pl/721027,valeo_autosystemy_sp_z_o_o,skawina,firma.html",
    "logo": "https://static.praca.pl/3/7/3706de2c-f08e-4506-9daf-5dea3c65228b.png",
    "location": "Skawina, k. Krakowa",
    "locationPrecision": "city",
    "city": "Skawina",
    "region": "małopolskie",
    "street": "Przemysława 3",
    "postalCode": "32-050",
    "workModel": "praca stacjonarna",
    "seniority": "pracownik fizyczny / pracowniczka fizyczna",
    "contractType": "umowa o pracę",
    "workingTime": "pełny etat",
    "salaryMin": null,
    "salaryMax": null,
    "salaryCurrency": null,
    "salaryPeriod": null,
    "salaryGross": null,
    "salaryText": null,
    "category": "Badania i rozwój",
    "industry": "Laborant",
    "applyFlags": ["aplikuj szybko"],
    "directApply": true,
    "teaser": "Opis stanowiska: Wykonywanie badań laboratoryjnych; Analiza uzyskanych wyników...",
    "description": "Wymagania:\n• Wykształcenie: mechaniczne lub elektryczne;\n• Mile widziane doświadczenie w pracy w laboratorium;\n• Znajomość j.angielskiego w stopniu podstawowym;...",
    "postedAgo": "2 dni",
    "publishedAt": "2026-07-26",
    "validThrough": "2026-08-25",
    "expiringSoon": false,
    "changeType": "NEW",
    "contentHash": "311f28e971fd744d0971155919142ee3bf19f7ef",
    "scrapedAt": "2026-08-18T15:38:13.527Z"
}
```

### 📊 Dataset Views

| 👁️ View       | 💬 Shows                                                   |
| ------------- | ---------------------------------------------------------- |
| 📋 Overview   | Position, employer, location, salary, contract, work model |
| 💰 Salaries   | Only the pay figures, ready for a benchmark spreadsheet    |
| 📡 Monitoring | What changed since the last run, with closing dates        |
| 🔬 Detailed   | Every field                                                |

### ❓ FAQ

**Why did a Kraków search return offers from another city?**
Because Praca.pl widens a thin search on its own. Keep **Strict city match** on and those rows are dropped for you.

**Why do some offers show a voivodeship instead of a city?**
The employer published it region-wide. Those rows are marked `locationPrecision: region` and kept, because they are still real offers in your area.

**Why is the salary empty on most offers?**
Because most Polish employers outside IT do not publish one. When a band is printed, you get it as proper numbers — including hourly rates, which are easy to misread as monthly figures.

**How do I get the full offer text?**
Turn on **Fetch full descriptions**. It opens each offer page and adds the description, closing date and street address.

**How do I track a search over time?**
Turn on **Monitoring mode** and give it a state key. The first run builds a baseline; later runs return only new, edited and reposted offers.

**Can I feed it my own links?**
Yes. Paste any Praca.pl search page or single offer into **Start URLs**.

**Does it need a proxy?**
No. Add one only for very large runs.

### 🛠️ Need Something Custom?

💬 **Need another portal, a different output format, or a scheduled feed straight into your database?**

We build custom scrapers and data pipelines — including cross-portal deduplication that merges the same job posted on several boards into one record. Reach out through the Apify Console and tell us what you need.

### ⚖️ Legal

This scraper collects publicly available job offers. Use the data in line with applicable law and the source website's terms. You are responsible for how you use the output.

# Actor input Schema

## `startUrls` (type: `array`):

Paste Praca.pl search pages or single offer pages. Takes precedence over the keyword and city fields below.

## `keyword` (type: `string`):

What to search for, e.g. laborant, technolog, magazynier, ksiegowa.

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

City to search in, e.g. Krakow, Warszawa, Gdansk. Praca.pl has no city-only search, so a city without a keyword is used as a search term instead of a filter.

## `strictLocation` (type: `boolean`):

Praca.pl widens a thin city search to neighbouring regions without saying so - a Krakow search can return Lodz. Turn this on to keep only offers whose own location matches the city you asked for.

## `maxItems` (type: `integer`):

Stop after this many offers. Set 0 for unlimited.

## `maxPages` (type: `integer`):

Stop after this many result pages. Set 0 to follow pagination to the end.

## `extractFullDetails` (type: `boolean`):

Open every offer page to add the full description, the closing date and a proper postal address. Slower, one extra request per offer.

## `incrementalMode` (type: `boolean`):

Only emit offers that are new, updated or reappeared since the previous run. Cuts the cost of a daily check by 80-95%.

## `emitUnchanged` (type: `boolean`):

In monitoring mode, include offers that have not changed.

## `emitExpired` (type: `boolean`):

In monitoring mode, include offers that disappeared since the previous run.

## `stateKey` (type: `string`):

Name for this monitoring baseline. Use a different key per saved search.

## `maxConcurrency` (type: `integer`):

Parallel requests.

## `minConcurrency` (type: `integer`):

Lower bound for parallel requests.

## `maxRequestRetries` (type: `integer`):

Retries per failed request.

## `maxRequestsPerMinute` (type: `integer`):

Rate limit. Praca.pl serves plain pages and does not need aggressive throttling.

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

Optional. Praca.pl works without a proxy; add one only for high-volume runs.

## Actor input object example

```json
{
  "startUrls": [],
  "keyword": "laborant",
  "location": "Krakow",
  "strictLocation": true,
  "maxItems": 100,
  "maxPages": 0,
  "extractFullDetails": false,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "maxConcurrency": 5,
  "minConcurrency": 1,
  "maxRequestRetries": 3,
  "maxRequestsPerMinute": 60,
  "proxyConfiguration": {}
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `salaries` (type: `string`):

No description

## `monitoring` (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 = {
    "startUrls": [],
    "keyword": "laborant",
    "location": "Krakow"
};

// Run the Actor and wait for it to finish
const run = await client.actor("trev0n/praca-pl-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 = {
    "startUrls": [],
    "keyword": "laborant",
    "location": "Krakow",
}

# Run the Actor and wait for it to finish
run = client.actor("trev0n/praca-pl-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 '{
  "startUrls": [],
  "keyword": "laborant",
  "location": "Krakow"
}' |
apify call trev0n/praca-pl-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,trev0n/praca-pl-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/2oWloiUVYmD8d4wX0/builds/hkV6c6nDZ5mDlnolg/openapi.json
