# Pracuj.pl Scraper ($0.94/1K): Polish Jobs & Salaries (`tsutseisoftware/pracuj-scraper`) Actor

Scrape Pracuj.pl jobs: salary in PLN per month and hour (gross, net, B2B), company, town, voivodeship, GPS, contracts, work mode, seniority, technologies. All website filters, monitoring of new and removed jobs, hiring signals, market summary. Residential proxy included. Unofficial. Oferty pracy.

- **URL**: https://apify.com/tsutseisoftware/pracuj-scraper.md
- **Developed by:** [Tsutsei Software](https://apify.com/tsutseisoftware) (community)
- **Categories:** Jobs
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.74 / 1,000 jobs

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?

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

## Pracuj.pl Scraper: Polish Jobs, Salaries & Companies

Get job offers from **Pracuj.pl**, the largest Polish job board, as clean structured data. Search by **keywords**, **towns with a radius**, **voivodeships**, **categories**, **companies**, the **website's own filters** (contract type including B2B, working time, work mode, seniority, minimum salary, posting date, without agencies, for Ukrainians, without Polish, one-click apply) or paste any Pracuj.pl search URL. For each job you get the title, company, town with its **voivodeship and GPS**, all towns of the ad, **salary in PLN with monthly and hourly equivalents and its kind (gross, net or net + VAT for B2B)**, contract types, working time, work modes, seniority, publication dates, the website's AI summary and labels (immediate start, many vacancies, one-click apply). Optionally the actor opens each job page and adds the **description** (with e-mails and phone numbers removed), **responsibilities, requirements, technologies**, benefits, categories, **salary per contract type**, required languages, street address, ad language and the apply links.

Built for **watching the Polish job market**: schedule it daily in monitoring mode and you get, and pay for, only jobs that are new or changed, plus, if you want, the jobs that **disappeared**, checked on the job page (ad ended or no longer matching the search) with the number of days they were online. Every run also saves a free **market summary** (salary median and quartiles by salary kind, voivodeship and category, top employers, remote share, contract types).

The output has the same fields and values as our **Jobs.cz**, **Prace.cz** and **Profesia** scrapers, so Polish, Czech and Slovak job data can go into one table.

> **Po polsku:** Scraper i API ofert pracy z **Pracuj.pl**, największego portalu z ofertami pracy w Polsce: pobiera wynagrodzenie w PLN miesięcznie i godzinowo (brutto, netto + VAT dla B2B), firmę, miejscowość, województwo, GPS, rodzaje umów, tryb pracy, poziom stanowiska i technologie. Wyszukiwanie po słowach kluczowych, miastach z promieniem (np. praca w Warszawie, Krakowie lub Wrocławiu), województwach i kategoriach, wszystkie filtry serwisu (także praca zdalna, umowa B2B i minimalne wynagrodzenie), monitoring nowych i usuniętych ofert, sygnały rekrutacyjne (liczba otwartych rekrutacji pracodawcy, dni online, ponowne publikacje), opcjonalnie kontakty, powiadomienia w Telegramie, Slacku, Discordzie i WhatsAppie oraz podsumowanie rynku. Proxy rezydencjalne w cenie. Eksport do Excela, CSV lub JSON.

### Why use this Pracuj.pl scraper?

- 💰 **Salaries you can compare.** Pracuj.pl mixes gross salaries (umowa o pracę), net + VAT rates (B2B) and hourly rates. You get `salaryMin`/`salaryMax` as numbers, `salaryKind` (`gross`, `net`, `netPlusVat`), **monthly and hourly equivalents** (standard full-time hours) and, with details, the salary of **each contract type** separately.
- 🔎 **All website filters,** applied by the website itself (filtered-out jobs cost nothing): 35 categories and 200 subcategories, 16 voivodeships and abroad, town + radius, 8 contract types (umowa o pracę, zlecenie, o dzieło, B2B…), full-time / part-time / temporary, on site / hybrid / remote / mobile, 11 seniority levels, minimum salary, posted in the last 1/3/7/14/30 days, without agencies, for Ukrainians, without Polish, for seniors, for people with disabilities, one-click apply, newest first.
- 🧮 **Plus filters the website doesn't have:** hourly minimum salary, salary up to, title must (not) contain, company include/exclude, only "praca od zaraz", exclude "whole Poland" offers.
- 🗺️ **Voivodeship for 95 % of jobs without opening them,** matched from the town or powiat at no extra cost, GPS of the workplace when the website has it. Voivodeships, categories, benefits and languages are always the website's Polish names (`mazowieckie`, `IT - Rozwój oprogramowania`, `prywatna opieka medyczna`, `angielski`), also for ads written in English.
- 🏙️ **One row per ad or per town.** An ad offered in several towns is one row with all towns and their links (`locations`, `offerUrls`); switch on **One row per town** for one row per workplace.
- 📬 **Monitoring mode:** a daily feed of new and changed jobs (`changeType`), optionally with **removed jobs** checked on the job page: `removedReason` `expired` or `noLongerMatches`, with `daysOnline`.
- 📈 **Hiring signals (optional):** for every job the number of **open positions of its employer**, **days online** and **hard to fill** (online much longer than usual or reposted repeatedly); with monitoring also **reposts** of the same position under a new job ID (`isRepost`, `repostOf`, `repostCount`). For sales prospecting, recruitment agencies and labour-market research. No extra run time.
- 🛡️ **Residential proxy included.** Pracuj.pl needs a residential proxy. It is set by default and its cost is included in the price. No extra platform cost.
- ⚡ **Fast and cheap:** 1 000 ads from the list take under 30 seconds and cost **$0.94**, with full details about 17 minutes (7 minutes in fast mode). 256 MB of memory.
- 📇 **Contacts (optional, personal data, extra charge):** the phone of the apply box and the e-mails, phone numbers and names of contact persons written in the ad, in their own fields (`contactEmails`, `contactPhones`, `contactNames`). Off by default; never for private employers.
- 🔔 **Notifications:** after each run (in monitoring mode: only when there are new or changed jobs) a message with the jobs to **Telegram, Slack, Discord, WhatsApp** or **your webhook**.
- 🤖 **Output for AI agents:** **compact output** with the core fields only, and the description as **plain text, Markdown or HTML**.
- 🔒 **Privacy first.** No contacts unless you turn them on; e-mails and phone numbers inside descriptions (also Polish landlines and numbers split with asterisks) are replaced with `[e-mail removed]` / `[phone removed]`, together with the first name of the contact person written next to a number. The company is hidden for **sole traders** (whose business name by law contains their first name and surname, e.g. "Usługi Transportowe Jan Kowalski"), for **general, limited and professional partnerships** (sp.j., sp.k., sp.p., whose name by law contains a partner's surname) and for civil partnerships (s.c.) named after their partners; a hidden employer's name is also replaced with `[employer]` in the title and every text of the ad. See the FAQ for how it works and its limits.

### What data can you get?

| Field | Example |
|---|---|
| Title, company, company ID, profile | Accounting Supervisor, Vistra Poland, 18801415 |
| Location, borough, powiat, voivodeship | Kraków, Prądnik Czerwony, –, małopolskie |
| All towns of the ad, their job IDs and URLs | Kraków, Lublin, Warszawa |
| GPS, whole Poland, abroad | 50.0912, 19.9595; isWholePoland; isAbroad + workCountry |
| Salary | 7 500 – 9 500 PLN per month, gross (monthly 7 500 – 9 500, hourly 46.88 – 59.38), "7 500–9 500 zł brutto / mies." |
| Contract and working time | polishContractTypes `employment`, `b2b`, `mandate`…; contractTypes `employee`/`freelance`/`workAgreement`; employmentType `fullTime` |
| Work mode, seniority | workModes `hybrid`, workArrangement `hybrid`; seniority `senior` |
| Labels | isPromoted (super oferta), immediateStart, manyVacancies, applyWithoutCv, isOneClickApply, suitableFor `refugees`, `withoutPolish`, `seniors`, `disabled`, `noExperience` |
| Dates | postedAt (first publication), updatedAt (last publication), validThrough |
| Texts from the list | descriptionSnippet, aiSummary (the website's AI summary) |
| With **Add description and details** | description, responsibilities, requirements, nice to have, what we offer, benefits, technologies (required and nice to have), IT specializations, categories with IDs and main category, salary per contract type, required languages, ad language, street and postal code, agency or employer, company description, apply URL and the employer's own form |
| With **Monitoring: include removed jobs** | changeType `removed` with removedReason, removedAt, firstSeenAt, lastSeenAt, daysOnline; `reappeared` |
| With **Hiring signals** | companyOpenPositions, daysOnline, hardToFill; with monitoring also isRepost, repostOf, repostCount |
| With **Contacts (personal data)** | contactPhones, contactEmails, contactNames |

See the **Output** tab for all fields. The dataset has views for **Overview**, **Salaries**, **Places**, **Details**, **Companies**, **Labels**, **Monitoring**, **Hiring signals**, **Contacts** and **Removed jobs**.

### How to scrape Pracuj.pl

1. Enter **Search queries** (e.g. `python`, `magazynier`, `księgowa`) and **Locations** (e.g. `Warszawa`, `Kraków`) with an optional **Distance from the place**, pick **Voivodeships** or **Categories**, or paste Pracuj.pl URLs into **Pracuj.pl URLs**: set your search and filters on the website and copy the URL, e.g. `https://www.pracuj.pl/praca/python;kw/warszawa;wp?rd=30`.
2. Optionally set website filters (contract type, work mode, seniority, salary…) and actor filters.
3. Turn on **Add description and details** if you need the description, requirements, technologies and the salary per contract type.
4. Set **Max jobs** and click **Start**. Download the results as JSON, CSV or Excel, or connect them to Google Sheets, Slack or Make.

### Use cases

#### New Python jobs in Warsaw every morning

Schedule a daily run in monitoring mode; each run returns only new or changed jobs (and those that disappeared).

```json
{
  "searchQueries": ["python", "data engineer"],
  "locations": ["Warszawa"],
  "radiusKm": 30,
  "maxItems": 0,
  "onlyNewOrChanged": true,
  "includeRemovedJobs": true,
  "monitoringKey": "python-warszawa"
}
```

#### B2B rates of senior developers working remotely

```json
{
  "categories": ["5016"],
  "contractTypes": ["b2b"],
  "workArrangement": ["remote"],
  "seniority": ["senior", "expert"],
  "onlyWithSalary": true,
  "includeDetails": true,
  "maxItems": 500
}
```

`salaries` has the rate of each contract type, `salaryKind` is `netPlusVat` for B2B, and the free `SUMMARY` record has the median and quartiles by salary kind.

#### Salary research for a voivodeship

```json
{
  "regions": ["6"],
  "onlyWithSalary": true,
  "maxItems": 2000
}
```

Voivodeships are the website's IDs: 1 dolnośląskie, 2 kujawsko-pomorskie, 3 lubelskie, 4 lubuskie, 5 łódzkie, 6 małopolskie, 7 mazowieckie, 8 opolskie, 9 pomorskie, 10 podkarpackie, 11 podlaskie, 12 świętokrzyskie, 13 śląskie, 14 warmińsko-mazurskie, 15 wielkopolskie, 16 zachodniopomorskie, `abroad`.

#### Warehouse jobs for people from Ukraine, start right away

```json
{
  "searchQueries": ["magazynier"],
  "suitableFor": ["refugees"],
  "onlyImmediateStart": true,
  "maxItems": 300
}
```

#### All jobs of a company

```json
{
  "companyIds": ["18801415"],
  "includeDetails": true,
  "splitLocations": true
}
```

`companyId` of any result works, or paste the company profile URL (`https://pracodawcy.pracuj.pl/company/18801415`) into **Pracuj.pl URLs**.

#### Jobs published today, newest first

```json
{
  "postedWithinDays": 1,
  "sortBy": "newest",
  "maxItems": 0
}
```

#### Website filters (applied by Pracuj.pl)

| Input | Website filter |
|---|---|
| Search queries | słowo kluczowe |
| Locations + Distance from the place | miejscowość + odległość, one search per town |
| Voivodeships | województwo or zagranica |
| Categories | kategoria and podkategoria |
| Company IDs | pracodawca |
| Contract type | umowa o pracę, o dzieło, zlecenie, B2B, na zastępstwo, agencyjna, o pracę tymczasową, staż / praktyki |
| Working time | pełny etat, część etatu, dodatkowa / tymczasowa |
| Work mode | stacjonarna, hybrydowa, zdalna, mobilna |
| Seniority | praktykant … prezes, pracownik fizyczny |
| Posted in the last N days | 24 h, 3, 7, 14, 30 days |
| Salary from (per month), Only jobs with a salary | wynagrodzenie od |
| Without recruitment agencies | bez agencji |
| Suitable for | dla Ukraińców, bez znajomości polskiego, dla seniorów, dla osób z niepełnosprawnościami |
| Only "apply in one click" | aplikuj jednym kliknięciem |
| Sort by | newest first |

#### Filters (applied by the actor, you don't pay for filtered-out jobs)

Salary from per hour, Salary up to, Title must contain, Title must not contain, Company, Exclude companies, Only "immediate start", Exclude "whole Poland" offers.

#### Ads in several towns

Pracuj.pl groups one ad published in several towns (one job ID and URL per town). By default you get **one row per ad** (`id` = `pracuj:<groupId>`) with all towns in `locations`, their voivodeships in `regions` and their job IDs and URLs in `offerIds` / `offerUrls`; the street address is filled only for ads in one town. With **One row per town** every town is its own row (`id` = `pracuj:<job ID>`), with its own address and link. Remote ads "for the whole of Poland" can list 15+ towns; **Exclude "whole Poland" offers** keeps only ads in the town you searched.

#### Monitoring mode explained

With **Monitoring: only new or changed jobs** the actor remembers the jobs of the previous run with the same **Monitoring key** and saves only jobs that are new (`changeType: new`) or whose title, company, salary, towns or work mode changed (`updated`; `changedFields` lists every field that changed, e.g. `["company", "locations"]`). If a run is interrupted (crash, out of memory), the next run does not return the jobs that were already saved again. Unchanged jobs are free. With **Monitoring: include removed jobs**, jobs of the previous run that are no longer in the search are checked on their job page and returned as `removed` with `removedReason` `expired` (the ad ended) or `noLongerMatches` (the ad is live but left the search). When a removed job comes back it is returned as `reappeared`. Removed jobs are only checked when the run read every search completely.

#### Hiring signals

Turn on **Hiring signals** and every saved job gets:

| Field | What it says |
|---|---|
| `companyOpenPositions` | Different positions of the same employer seen so far in the run (a lower bound: later rows of the same employer can show more); with monitoring also those seen in the last 14 days. A company hiring for 30 positions is a hot lead for agencies and HR tools. |
| `daysOnline` | Days since the ad was first published (or first seen). |
| `hardToFill` | `true` when the job has stayed online much longer than usual or was reposted repeatedly. Pracuj.pl ads run for up to about 30 days, so it is mostly found with monitoring, which counts the reposts. |
| `isRepost`, `repostOf`, `repostCount` | With monitoring: the same position posted again under a new job ID, the `id` of the earlier row and how many times in the last 90 days. |

No extra run time. Only jobs that got the signals pay the **Hiring signals** event (+$0.20 per 1 000). Signals count what the run (and your earlier runs with the same monitoring key) saw: a run limited to 100 jobs sees fewer positions of each employer than a run over the whole search.

#### Contacts (optional, personal data)

Turn on **Contacts (personal data, extra charge)** together with **Add description and details** and every job gets the contacts its job page shows:

| Field | What it is |
|---|---|
| `contactPhones` | The phone of the apply box ("Zadzwoń") and phone numbers written in the ad, as `+48XXXXXXXXX` |
| `contactEmails` | E-mail addresses written in the ad (also "rekrutacja(at)firma.pl") |
| `contactNames` | Names of contact persons written right next to an e-mail or phone ("Anna Kowalska, tel. 600 123 456") |

How many ads show a contact depends on the trade: in our runs of 2026-11-09, 29 of 34 driver ads (mostly the phone of the apply box) and 5 of 28 accounting ads. E-mails and contact names are rarer; most employers use the website's application form (`applyUrl`, `externalApplyUrl`). The descriptions keep their contacts replaced with `[e-mail removed]` / `[phone removed]`, and private employers (sole traders and partnerships, whose name is hidden) never get contacts. Only jobs with at least one contact pay the **Contact details** event (+$0.40 per 1 000), so 1 000 jobs with details and contacts cost at most **$1.73** (Gold: $1.53).

These are **personal data**: you are responsible for using them lawfully (GDPR: a legal basis such as legitimate interest for B2B recruiting outreach, no unsolicited marketing, and honouring objections). A person who objects is excluded from all runs on request (open an issue in the **Issues** tab).

#### Notifications (Telegram, Slack, Discord, WhatsApp, webhook)

Fill in one or more channels in the **Notifications** section. After the run, the actor sends a message with the title, company, place, salary and link of the saved jobs (at most **Notifications: max jobs per message**, 10 by default, then "…and N more") and links to the run and the dataset. With **Notifications: only when something was saved** (on by default) a monitoring run without new jobs sends nothing, so a daily schedule gives you one message a day only when there is something new.

| Channel | What you need |
|---|---|
| Telegram | A bot token from @BotFather and the chat ID |
| Slack | An incoming webhook URL (`https://hooks.slack.com/services/...`) |
| Discord | A channel webhook URL (`https://discord.com/api/webhooks/...`) |
| WhatsApp | The WhatsApp Cloud API access token of your Meta business account, the phone number ID of your business number, up to 5 recipient numbers and an approved message template, so that the message arrives at any time; step by step in [WhatsApp notifications: setup](#whatsapp-notifications-setup) |
| Webhook | Any HTTPS URL; it gets a POST with JSON `{title, summary, totalSaved, runUrl, datasetUrl, items}` |

The tokens and URLs are secret inputs (encrypted by Apify, never logged). Descriptions and contacts are never sent in notifications. A failing channel is logged and never fails the run. Notifications are free.

#### Compact output and description format

**Compact output** saves only `id`, `url`, `title`, `company`, `location`, `region`, the salary fields, `workArrangement`, `seniority`, `employmentType`, `polishContractTypes`, `technologies`, `postedAt` and `scrapedAt`, plus the fields of the options you turned on (description, monitoring, hiring signals, contacts). **Description format** gives `description` as plain text (default), **Markdown** (`### heading`, `- item`, good for LLMs and Notion) or simple **HTML** (`<h3>`, `<ul>`, `<p>`).

#### Market summary (SUMMARY)

Every run saves a free JSON record `SUMMARY` in the key-value store: number of jobs, salary median and quartiles in PLN per month overall, **by salary kind** (gross vs. net + VAT), by voivodeship and by category, top 20 employers, the share of on-site/hybrid/remote jobs, working time, contract types, seniority and voivodeships.

#### Fast mode (optional, small extra charge)

Fast mode reads up to about 2.5× faster and drops back to the normal speed for the rest of the run at the first sign of load. It never changes IP address to get around a limit. Only jobs saved while the fast speed was on pay the **Fast mode** event.

### How much does it cost to scrape Pracuj.pl?

This actor uses pay-per-event pricing (see the **Pricing** tab for the current prices):

| Event | Price per 1 000 | Bronze | Silver | Gold and higher |
|---|---|---|---|---|
| Job saved in the dataset | **$0.94** | $0.84 | $0.74 | $0.74 |
| Job page read ("Add description and details") | + $0.39 | + $0.39 | + $0.39 | + $0.39 |
| Hiring signals (only jobs that got them) | + $0.20 | + $0.20 | + $0.20 | + $0.20 |
| Contact details (only jobs with at least one contact) | + $0.40 | + $0.40 | + $0.40 | + $0.40 |
| Monitoring: listing page checked (one page = up to 50 ads) | $1.50 per 1 000 pages | | | |
| Fast mode | + $0.01 | | | |

Platform usage and the residential proxy are included. There is also a start fee of $0.002 per run. 1 000 jobs from the list cost **$0.94**, with full details **$1.33** (Gold: $0.74 and $1.13). A daily monitoring run of a search with 3 pages and 10 new jobs costs $0.002 + 3 × $0.0015 + 10 × $0.00094 ≈ $0.016. Filtered-out jobs, unchanged jobs in monitoring mode and the market summary are free; jobs whose page could not be read are not charged the details price. You can set a maximum cost per run; the actor stops when it is reached.

### Input example

```json
{
  "searchQueries": ["python"],
  "locations": ["Kraków"],
  "includeDetails": true,
  "maxItems": 100
}
```

### Output example

```json
{
  "id": "pracuj:8c230000-56be-0050-e6fd-08df2f4ef435",
  "source": "pracuj.pl",
  "url": "https://www.pracuj.pl/praca/java-developer-ka-krakow,oferta,1005171304",
  "jobId": "1005171304",
  "title": "Java Developer/-ka",
  "company": "Mindbox Sp. z o.o.",
  "companyId": "1074221283",
  "isAgency": false,
  "location": "Kraków",
  "locations": ["Kraków"],
  "region": "małopolskie",
  "regions": ["małopolskie"],
  "workArrangement": "remote",
  "remote": true,
  "salaryMin": 19200,
  "salaryMax": 20800,
  "salaryCurrency": "PLN",
  "salaryPeriod": "month",
  "salaryMonthlyMin": 19200,
  "salaryMonthlyMax": 20800,
  "salaryHourlyMin": 120,
  "salaryHourlyMax": 130,
  "employmentType": ["fullTime"],
  "contractTypes": ["freelance"],
  "language": "pl",
  "categories": ["Analiza biznesowa i systemowa", "Architektura", "Programowanie"],
  "benefits": ["prywatna opieka medyczna", "możliwość pracy zdalnej", "elastyczny czas pracy"],
  "postedAt": "2026-10-21T08:50:55Z",
  "updatedAt": "2026-11-05T09:51:00Z",
  "validThrough": "2026-11-20T22:59:59Z",
  "isPromoted": true,
  "description": "Technologie, których używamy\nWymagane\n- Java\n- Spring Framework…",
  "detailScraped": true,
  "country": "PL",
  "groupId": "8c230000-56be-0050-e6fd-08df2f4ef435",
  "workModes": ["remote"],
  "seniority": ["senior"],
  "polishContractTypes": ["b2b"],
  "salaryText": "19 200–20 800 zł netto (+ VAT) / mies.",
  "salaryKind": "netPlusVat",
  "salaries": [{"contractType": "b2b", "min": 19200, "max": 20800, "currency": "PLN", "period": "month", "kind": "netPlusVat"}],
  "technologies": ["Java", "Spring Framework", "Spring Boot", "SQL", "Docker"],
  "technologiesOptional": ["Varnish"],
  "itSpecializations": ["Backend", "DevOps"],
  "requirements": ["Minimum 5 lat doświadczenia w Javie (Java 8+).", "Znajomość Spring Framework i Spring Boot."],
  "mainCategory": "IT - Rozwój oprogramowania",
  "applyUrl": "https://www.pracuj.pl/aplikuj/java-developer-ka-krakow,oferta,1005171304",
  "scrapedAt": "2026-11-05T10:00:00Z"
}
```

### Limitations

- The list has no description, categories, required languages or street address: they need **Add description and details**.
- `isAgency` is known only with details (the website's "directly from the employer" flag).
- The voivodeship is matched from the town or powiat of the workplace, at no extra cost; a few ambiguous village names stay without a voivodeship in list mode (with details the job page gives it).
- The list shows one salary range for ads with several contract types ("13 000–23 240 zł / mies. (zal. od umowy)": from the lowest gross salary to the highest B2B rate), with `salaryKind` null. With **Add description and details**, `salaryMin`/`salaryMax`/`salaryKind` are those of the first contract type of the ad (e.g. the gross salary of the employment contract) and `salaries` has every contract type separately; gross and net + VAT amounts are never mixed in one range.
- Free texts (description, requirements, the employer's own benefits) stay in the language of the ad.
- Pages of a search are read one after another while the website keeps adding new ads, so in a long search an ad can move from one page to the next: duplicates are removed, but an ad can occasionally be missed. Monitoring runs catch it next time.
- Promoted ads that the website shows between the results are results of the same search: they are read in their regular place, once.
- Measured fill rates from the list (600 driver jobs and 20 IT jobs, 2026-11-05): title, towns, dates, contract types, work mode 100 %, voivodeship 95 %, salary 56 % (drivers) to 65 % (IT), company 80 % for drivers (the rest are sole traders, hidden for privacy) and 96 % for office jobs. With details (30 jobs): description, requirements, categories, ad language 100 %, benefits 76 %, technologies 56 %, required languages 43 %, street address 36 % (ads in one town).
- A job URL whose job page the website rejects is looked up in the website's search (the same job ID) and saved with its listing data (no description and other job-page fields); a job ID alone cannot be looked up that way.
- Pracuj.pl needs a residential proxy. It is set by default and its cost is included in the price; keep the default (Apify Proxy, RESIDENTIAL, country Poland). A page the website rejects is retried once a little later, never from another IP address; if rejections continue, the run stops with what it has saved and says so. It never solves captchas or other challenges.

### For AI agents and API users

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("tsutseisoftware/pracuj-scraper").call(run_input={
    "searchQueries": ["python"], "locations": ["Warszawa"], "maxItems": 100,
})
for job in client.dataset(run.default_dataset_id).iterate_items():
    print(job["title"], job["company"], job["salaryMin"], job["salaryKind"], job["region"])
```

### Troubleshooting

- **"rejecting requests"**: set **Proxy configuration** back to the default (Apify Proxy, group RESIDENTIAL, country Poland), or try again later.
- **"Location not found"**: type a Polish town as on the website (`Warszawa`, `Kraków`, `Gdańsk`; `lodz` works too). For a voivodeship use **Voivodeships**. This applies to towns in Pracuj.pl URLs too.
- **"The website did not apply the filters of …"**: the URL has a category, voivodeship or other value that Pracuj.pl does not know, so the website would show all jobs instead. Such a URL is skipped (nothing unfiltered is saved or charged); set the filters on Pracuj.pl and copy the URL again.
- **Jobs from other towns in a town search**: those are remote ads for the whole of Poland; turn on **Exclude "whole Poland" offers**.
- **Fewer jobs than expected**: check the filters summary in the status message ("filtered out: …") and **Max jobs per search** / **Max pages per search**.

### Integrations

Connect the results to the tools you already use with the built-in integrations of Apify (the **Integrations** tab of the actor or of a saved task), with no code:

- **Google Sheets or Google Drive:** the results of every run in a spreadsheet or a file.
- **Zapier, Make and n8n:** start a workflow when a run finishes, or start the actor from one.
- **Slack or e-mail:** a message from Apify when a run finishes or fails.
- **Webhooks:** your own address gets the details of each run.
- **API and MCP:** run the actor from your code, or let an AI assistant run it through the Apify MCP server.

The results also download as Excel, CSV, JSON or XML from the **Output** tab.

### Privacy and error reports

When a run fails, the actor sends its developer a short error report: the error, the run ID and your input with secrets left out (tokens, webhooks, e-mails and similar values are hidden). Your results are never sent. Reports are deleted after at most 120 hours (5 days). To send nothing, turn off **Send error reports** (`sendErrorReports: false`). Questions about your data: open an issue in the **Issues** tab of this actor.

### More Polish job scrapers

The same output format for the other Polish job boards (monitoring mode, salaries as numbers):

- [Polish Jobs Aggregator](https://apify.com/tsutseisoftware/polish-jobs-aggregator): all these Polish job boards in one run: duplicates merged, one output format, salaries as numbers, monitoring
- [NoFluffJobs Scraper](https://apify.com/tsutseisoftware/nofluffjobs-scraper): Polish IT jobs: salary per month and hour, B2B or employment, technologies, salary benchmark, monitoring
- [JustJoin.it Scraper](https://apify.com/tsutseisoftware/justjoin-it-scraper): Polish IT jobs: salary per contract type, technologies with level, seniority, remote, radius from a city, alerts
- [RocketJobs.pl Scraper](https://apify.com/tsutseisoftware/rocketjobs-pl-scraper): Polish non-IT jobs (sales, marketing, logistics and more): salary per contract type, subcategories, radius from a city, alerts
- [Praca.pl Scraper](https://apify.com/tsutseisoftware/praca-pl-scraper): jobs from one of the oldest Polish job boards: salary, contract type, work mode, relocation offers, monitoring
- [OLX Praca Scraper](https://apify.com/tsutseisoftware/olx-praca-scraper): Polish job ads from OLX: salary as written, place, company or private advertiser, optional job data and phone numbers of companies
- [theprotocol.it Scraper](https://apify.com/tsutseisoftware/theprotocol-it-scraper): Polish IT jobs: B2B and employment salary apart, seniority, technologies, hiring signals, monitoring
- [Praca.gov.pl Scraper](https://apify.com/tsutseisoftware/praca-gov-pl-scraper): all Polish labour office offers (CBOP): gross salary, employer and contact, voivodeship, contract, monitoring
- [Aplikuj.pl Scraper](https://apify.com/tsutseisoftware/aplikuj-pl-scraper): Polish jobs from Aplikuj.pl: salary per month and hour, direct employers only, contract, benefits, phone numbers of employers, monitoring
- [InfoPraca Scraper](https://apify.com/tsutseisoftware/infopraca-scraper): Polish jobs and jobs abroad from InfoPraca.pl: salary per month and hour, voivodeship, category, phone numbers of companies, monitoring

Need jobs straight from company career sites in any country? [Career Site Job Search](https://apify.com/tsutseisoftware/ats-jobs-scraper) searches Greenhouse, Workday, Lever, Ashby and SmartRecruiters job boards without a company list, including the jobs that just closed.

### WhatsApp notifications: setup

The actor sends the message from your own WhatsApp business number through the WhatsApp Cloud API of your Meta business account. You need a Meta business account; the actor uses only the values you enter in the **Notifications** section (the token and the numbers are stored encrypted and never written to the log).

1. **Create an app.** In Meta for Developers open **My Apps → Create app** and choose the use case **Connect with customers through WhatsApp**.
2. **Get a sending number.** In the app open **WhatsApp → API Setup**. You can start with the test number Meta gives you and add your own business number there later. Copy the **Phone number ID** (not the number itself) into **WhatsApp phone number ID**.
3. **Confirm the recipients (test number only).** A test number sends only to numbers on its list: in **API Setup**, under **To**, add each recipient's number and confirm it with the code WhatsApp sends to it.
4. **Create a permanent access token.** The token shown in API Setup expires within hours. In **Business settings → System users** add a system user, use **Assign assets** to give it your app (and your WhatsApp account), then **Generate token** for the app with the permissions `whatsapp_business_messaging` and `whatsapp_business_management` and the expiry you want. Paste it into **WhatsApp access token**.
5. **Create a message template (recommended).** In **WhatsApp Manager → Message templates → Create template** choose the category **Utility**, a name (e.g. `apify_results`) and a language, and write a body with two variables, for example: `New results of your Apify task: {{1}} Open the dataset: {{2}} (sent automatically after each run).` Meta does not accept a body that starts or ends with a variable and asks for sample values (e.g. `3 new jobs` and a dataset link); keep the text factual, a promotional text is moved to the Marketing category. Approval can take up to 24 hours. Enter the name in **WhatsApp template name** and its language code (e.g. `en_US`, `cs`, `pl`, `de`, as WhatsApp Manager shows it) in **WhatsApp template language**.
6. **Enter the recipients.** **WhatsApp recipient number** takes up to 5 numbers with the country code (e.g. `+420601234567`), separated by commas or new lines. Each number gets its own message.

**What the message contains.** With a template: `{{1}}` is the run summary with the first results on one line (title, company or price, place; never descriptions or contacts) and `{{2}}` the link to the dataset. A template with only `{{1}}` works too, it then gets the link at the end. Without a template the actor sends a text message with one link per result, like in Slack or Telegram.

**Without a template** WhatsApp delivers the message only when the recipient wrote to your business number in the last 24 hours (the customer service window), so a daily or hourly schedule needs a template. The run log says so once per run.

**What it costs.** Meta bills your business account, not this actor: per delivered message, by the message category (a template of the Utility category, or a service message for text in the 24-hour window, with a monthly free allowance per business number) and by the recipient's country. The current rates are in Meta's pricing of the WhatsApp Business Platform. The actor's own notification charge (see the **Pricing** tab) is once per run that delivered its notification, whatever the number of channels and recipients.

**Checked at the start.** When the run starts, the actor checks the token, the phone number ID and, when the token shows its WhatsApp account, the template (name, language, approval), without sending anything. Settings that can't work stop the run with a message that says what to fix, before anything is read from the website.

**When nothing arrives**, the run log names the WhatsApp error and what to do: a template that does not exist in that language or is not approved yet, a template with another number of variables, a recipient missing from the test number's list, an expired token, or the 24-hour window. A failed notification never fails the run and is not charged. Meta can accept a message and still not deliver it later (for example when the recipient's phone is not on WhatsApp); such a run counts as notified.

### FAQ

#### Is it legal to scrape Pracuj.pl?

It reads only publicly available data, without logging in, at most 60 requests per minute (150 in the fast mode), slows down when the website asks, never changes IP address to get around a limit and never solves captchas or other challenges. It returns contacts only if you turn on **Contacts (personal data)** (then you are responsible for using them lawfully), removes e-mails and phone numbers from descriptions and hides the names of sole traders and partnerships that advertise (see below). The website's terms of use restrict copying its content and databases; you are responsible for how you use the data (GDPR, database rights and the website's terms). If in doubt, consult a lawyer. This actor is not affiliated with Pracuj.pl or Grupa Pracuj.

#### Why is the company empty for some jobs?

Employer names that look like a private person are hidden automatically, together with their address; in doubt, privacy wins. This covers sole traders (jednoosobowa działalność gospodarcza) and partnerships whose names by law contain a person's name: for them `company`, the company ID, logo, profile and address are null, and the name is replaced with `[employer]` in the title, the description and the other texts of the ad ("Firma \[employer] zatrudni kierowcę"). Capital companies (sp. z o.o., S.A.…), foreign company forms, public institutions and foundations are shown. A sole trader who trades under a nickname can still be shown. On 747 real employer names (2026-11-05) it hid 70, each with a person's name or a partnership form. The share depends on the trade: about a fifth of driver ads and up to three quarters in trades dominated by small businesses (e.g. hairdressers, 2026-11-05), a few per cent in office and IT jobs.

#### How are salaries converted?

Hourly and monthly equivalents use standard full-time hours; obviously mislabelled periods (e.g. "120 zł / mies.") are shown in `salaryMin` but get no equivalent. `salaryKind` tells whether the amount is gross, net or net + VAT (B2B invoice), which are not comparable with each other.

#### Do I need a proxy?

Pracuj.pl needs a residential proxy. It is set by default and its cost is included in the price, so no setup is needed; keep the default (Apify Proxy, RESIDENTIAL, country PL).

#### Can I get recruiters' e-mails or phone numbers?

Yes, with **Contacts (personal data, extra charge)** and **Add description and details**: the phone of the apply box and the e-mails, phones and contact names written in the ad (see [Contacts](#contacts-optional-personal-data)). Off by default, never for private employers, +$0.40 per 1 000 jobs with a contact.

***

Also known as a Pracuj.pl API or Pracuj.pl job scraper (Polish: "scraper ofert pracy Pracuj.pl", "oferty pracy Pracuj.pl do Excela", "pobieranie ofert pracy").

# Changelog

This Actor's version history is a separate document: https://apify.com/tsutseisoftware/pracuj-scraper/changelog.md

# Actor input Schema

## `searchQueries` (type: `array`):

Keywords to search for, e.g. "python", "magazynier", "księgowa", "kierowca C+E". Each query is a separate search (combined with the locations and website filters). At most 20.

## `locations` (type: `array`):

Polish towns, one search each, e.g. "Warszawa", "Kraków", "Gdańsk" (diacritics are optional: "lodz" works). A town the website doesn't know is reported, not replaced by the whole country. For a voivodeship use "Voivodeships" below.

## `radiusKm` (type: `integer`):

With "Locations": also jobs up to this many km from the town (the website's own radius, e.g. 0, 10, 30, 50, 100). Empty = the website's default (30 km).

## `regions` (type: `array`):

Only jobs in these voivodeships (województwa), or abroad. Applied by the website to every search.

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

Search URLs from Pracuj.pl, e.g. https://www.pracuj.pl/praca/python;kw/warszawa;wp?rd=30 (set the search and filters on the website and paste the URL), company profiles (https://pracodawcy.pracuj.pl/company/18801415) or job URLs (https://www.pracuj.pl/praca/…,oferta,1005162335). Website filters below are added to these URLs too, unless the URL already sets them.

## `jobIds` (type: `array`):

Pracuj.pl job IDs (the number at the end of a job URL, e.g. 1005162335) to read one by one with all details. At most 2000.

## `companyIds` (type: `array`):

All current jobs of these companies: the companyId of a result or the number of a company profile URL (https://pracodawcy.pracuj.pl/company/18801415). At most 100.

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

Maximum number of jobs saved. You pay per saved job. 0 = no limit.

## `maxItemsPerSearch` (type: `integer`):

Limit for each search, URL or company separately, so one large search doesn't use up the whole Max jobs. 0 = no limit.

## `splitLocations` (type: `boolean`):

Pracuj.pl shows one ad offered in several towns as one group (e.g. one job in Kraków, Lublin and Warszawa). Off: one row per ad, with all towns in "locations" and their links in "offerUrls". On: one row per town, with that town's address and link (each row is a saved job).

## `includeDetails` (type: `boolean`):

Open each job page to add the description (e-mails and phone numbers removed), responsibilities, requirements, technologies, benefits, categories, salary per contract type, required languages, street address and postal code, ad language, employer vs. agency and the apply links. Extra charge "Job page read" (see the Pricing tab) per job whose page was read.

## `descriptionMaxLength` (type: `integer`):

With "Add description and details": shorten the description to about this many characters (e.g. 300 for a snippet). 0 = full text.

## `categories` (type: `array`):

Only jobs in at least one of these categories (a main category includes all its subcategories), applied by the website.

## `contractTypes` (type: `array`):

Only these types of contract. Several values = any of them.

## `employmentType` (type: `array`):

Only these working times. Several values = any of them.

## `workArrangement` (type: `array`):

Only jobs offering one of these work modes.

## `seniority` (type: `array`):

Only jobs for these position levels (poziom stanowiska).

## `postedWithinDays` (type: `integer`):

Only jobs published or refreshed in the last N days. 1, 3, 7, 14 and 30 days are applied by the website; for other values the website gives the next longer period and the actor checks the date. 0 = any time.

## `minSalary` (type: `integer`):

Only jobs with a salary that reaches at least this amount in PLN per "Salary period", e.g. 8000 per month or 50 per hour. Per month the website applies it (it compares the top of the salary range, hourly rates converted); per hour the website keeps jobs with a salary and the actor checks the hourly rate (standard full-time hours).

## `salaryPeriod` (type: `string`):

The period of "Salary from" and "Salary up to".

## `onlyWithSalary` (type: `boolean`):

Skip jobs that show no salary. Applied by the website.

## `directEmployersOnly` (type: `boolean`):

Hide offers of employment agencies (the website's "bez agencji" filter).

## `suitableFor` (type: `array`):

Only jobs the employer marked as suitable for these groups. Several values = all of them.

## `onlyOneClickApply` (type: `boolean`):

Only jobs with the website's one-click application (aplikuj jednym kliknięciem).

## `maxSalary` (type: `integer`):

Skip jobs whose salary starts above this amount (per "Salary period"), e.g. to find entry-level jobs. Jobs without a salary are kept.

## `titleKeywords` (type: `array`):

Keep only jobs whose title contains at least one of these words (case and diacritics don't matter).

## `excludeKeywords` (type: `array`):

Skip jobs whose title contains any of these words, e.g. "senior", "praktykant".

## `companies` (type: `array`):

Keep only jobs of companies whose name contains one of these texts.

## `excludeCompanies` (type: `array`):

Skip jobs of companies whose name contains any of these texts.

## `onlyImmediateStart` (type: `boolean`):

Only jobs labelled "praca od zaraz" (start right away).

## `excludeWholePoland` (type: `boolean`):

Skip offers published for the whole country (mostly remote jobs listed in every town), so that a search for a town returns jobs in that town.

## `onlyNewOrChanged` (type: `boolean`):

Return only jobs that are new or whose title, company, salary, towns or work mode changed since the previous run with the same Monitoring key. Unchanged jobs are free; every listing page read in this mode is $0.0015 (the monitoring-page event; one page = up to 50 ads).

## `monitoringKey` (type: `string`):

Name of the saved state. Use a different key for each watched search (e.g. "python-warszawa"). Empty = "default". The value is stored encrypted.

## `includeRemovedJobs` (type: `boolean`):

With "Monitoring: only new or changed jobs": also return jobs of the previous run that are no longer in the search, as rows with changeType "removed" and removedReason "expired" (the ad ended) or "noLongerMatches" (the ad is live but no longer matches the search), checked on the job page. Checked only when the run reads every search completely (limits, unread pages or rejected requests skip the check, and the status message says why). Removed rows are charged like any other job.

## `includeHiringSignals` (type: `boolean`):

Adds to every job how many open positions its employer has (companyOpenPositions), days online (daysOnline) and hardToFill (online much longer than usual or reposted repeatedly); with monitoring also reposts of the same position under a new job ID (isRepost, repostOf, repostCount). No extra run time. $0.20 per 1 000 jobs that got the signals (the hiring-signals event).

## `includeContacts` (type: `boolean`):

Adds the contacts the job page shows: the phone of the apply box and the e-mails, phone numbers and names of contact persons written in the ad (contactEmails, contactPhones, contactNames). Needs "Add description and details". Never for private employers. These are personal data: you are responsible for using them lawfully (GDPR, e.g. no unsolicited marketing). Descriptions keep their contacts removed. $0.40 per 1 000 jobs that got at least one contact (the contact-details event).

## `descriptionFormat` (type: `string`):

Format of "description" (with "Add description and details"): plain text, Markdown (headings and lists, good for AI agents and Notion) or simple HTML (<h3>, <ul>, <p>).

## `compactOutput` (type: `boolean`):

Only the core fields (title, company, place, salary, work mode, seniority, contract types, technologies, dates, URL) plus the fields of the options you turned on. Smaller rows for AI agents, MCP clients and spreadsheets.

## `telegramBotToken` (type: `string`):

Token of your Telegram bot (from @BotFather), e.g. 123456789:AA... Used with "Telegram chat ID".

## `telegramChatId` (type: `string`):

Chat, group or channel ID the bot writes to (e.g. -1001234567890).

## `slackWebhookUrl` (type: `string`):

Incoming webhook of your Slack channel (https://hooks.slack.com/services/...).

## `discordWebhookUrl` (type: `string`):

Webhook of your Discord channel (https://discord.com/api/webhooks/...). In Discord: channel settings → Integrations → Webhooks → Copy Webhook URL. Stored encrypted.

## `webhookUrl` (type: `string`):

Any HTTPS URL: gets a POST with JSON {title, summary, totalSaved, runUrl, datasetUrl, items}.

## `whatsappAccessToken` (type: `string`):

Access token of the WhatsApp Cloud API of your Meta business account, used with "WhatsApp phone number ID" and "WhatsApp recipient number" (step by step in the README, section "WhatsApp notifications: setup"). For scheduled runs use a permanent token of a system user: Business settings → System users → Generate token, with the permissions whatsapp_business_messaging and whatsapp_business_management; the token of WhatsApp → API Setup expires within hours. Stored encrypted.

## `whatsappPhoneNumberId` (type: `string`):

ID of your WhatsApp business number that sends the message (not the number itself), e.g. 106540352242922. In your Meta app: WhatsApp → API Setup → Phone number ID.

## `whatsappTo` (type: `string`):

Phone number that gets the message, in international format with the country code (e.g. +420601234567); up to 5 numbers separated by commas or new lines, each gets its own message and the notification is charged once per run. A test number of Meta sends only to numbers you added and confirmed under API Setup → To. Stored encrypted.

## `whatsappTemplateName` (type: `string`):

Name of your approved message template (WhatsApp Manager → Message templates, e.g. apify_results), recommended: WhatsApp delivers a template message at any time. Its body gets the run summary with the first results in {{1}} and the dataset link in {{2}} (a template with only {{1}} gets both in {{1}}). Empty: a plain text message, which WhatsApp delivers only when the recipient wrote to your business number in the last 24 hours, so a scheduled run usually needs a template. Meta charges your business account for template messages (step by step in the README, section "WhatsApp notifications: setup").

## `whatsappTemplateLanguage` (type: `string`):

Language code of the template exactly as WhatsApp Manager → Message templates shows it next to the template, e.g. en_US, en_GB, cs, sk, pl or de. Used only with "WhatsApp template name".

## `notificationLimit` (type: `integer`):

How many jobs are listed in one notification (the rest as "…and N more").

## `notifyOnlyChanges` (type: `boolean`):

Send nothing when the run saved no job (e.g. a monitoring run without new jobs).

## `fastMode` (type: `boolean`):

Fast mode reads up to about 2.5× faster and drops back to the normal speed for the rest of the run at the first sign of load. It never changes IP address to get around a limit. Helps most with job pages ("Add description and details"). Extra charge "Fast mode" (see the Pricing tab) only for jobs saved while the fast speed was on.

## `sortBy` (type: `string`):

Order of the website's search results (matters with Max jobs). Pracuj.pl URLs keep their own order unless this is "Newest first".

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

Safety limit for each search or URL (50 groups of offers per page). 0 = no limit.

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

Pracuj.pl needs a residential proxy. It is set by default (Apify Proxy, RESIDENTIAL group, country Poland) and its cost is included in the price.

## `sendErrorReports` (type: `boolean`):

When a run fails, send the developer a short error report: the error and your input with secrets left out (tokens, webhooks and e-mails are hidden). Your results are never sent. Reports are deleted after at most 120 hours. Turn off to send nothing.

## Actor input object example

```json
{
  "searchQueries": [
    "python"
  ],
  "maxItems": 20,
  "maxItemsPerSearch": 0,
  "splitLocations": false,
  "includeDetails": false,
  "descriptionMaxLength": 0,
  "salaryPeriod": "month",
  "onlyWithSalary": false,
  "directEmployersOnly": false,
  "onlyOneClickApply": false,
  "onlyImmediateStart": false,
  "excludeWholePoland": false,
  "onlyNewOrChanged": false,
  "includeRemovedJobs": false,
  "includeHiringSignals": false,
  "includeContacts": false,
  "descriptionFormat": "text",
  "compactOutput": false,
  "whatsappTemplateLanguage": "en_US",
  "notificationLimit": 10,
  "notifyOnlyChanges": true,
  "fastMode": false,
  "sortBy": "relevance",
  "maxPages": 0,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "PL"
  },
  "sendErrorReports": true
}
```

# Actor output Schema

## `jobs` (type: `string`):

No description

## `summary` (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 = {
    "searchQueries": [
        "python"
    ],
    "maxItems": 20,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "PL"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("tsutseisoftware/pracuj-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 = {
    "searchQueries": ["python"],
    "maxItems": 20,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "PL",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("tsutseisoftware/pracuj-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 '{
  "searchQueries": [
    "python"
  ],
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "PL"
  }
}' |
apify call tsutseisoftware/pracuj-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tsutseisoftware/pracuj-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/jMLxZmi1NIljjO5vw/builds/w9xY5kRGI6WpjTwvH/openapi.json
