# Aplikuj.pl Scraper ($0.36/1K): Polish Jobs & Salaries (`tsutseisoftware/aplikuj-pl-scraper`) Actor

Scrape Aplikuj.pl jobs: salary in PLN per month and hour, company, town, voivodeship, contract, working time, seniority, benefits. Website filters incl. direct employers only, monitoring of new and removed jobs, notifications, phone numbers of employers.

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

## Pricing

from $0.30 / 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

## Aplikuj.pl Scraper: Polish Jobs & Salaries

Get job offers from **Aplikuj.pl**, a large general Polish job board (about 38 000 offers: warehouse, production, drivers, sales, care, teachers, office jobs and many agency offers), as a clean table. Search by **keywords**, **towns or voivodeships** (with the website's **distance** around a town), **categories**, or paste any Aplikuj.pl listing or job URL with the filters you set on the website. For each job you get the title, company, town with its **voivodeship**, the distance of a nearby town, **salary in PLN (or EUR abroad) with monthly and hourly equivalents and its kind (gross, net or net + VAT for B2B)**, contract type, labels (start immediately, no experience needed, online recruitment, workers from Ukraine welcome, promoted, recommended) and the day the offer was added. Optionally the actor opens each job page and adds the **full description** (e-mails and phone numbers removed), the **responsibilities, requirements and offer as lists**, the **benefits**, working time, seniority, work mode, the first publication and end dates, the category, the profession and the apply link.

The filters are applied by the website itself: **contract type, working time, seniority, work mode, only with a salary, direct employers only (no agencies), posted in the last N days, start immediately, no experience needed**, and more. Only matching jobs are read and charged.

> **Po polsku:** Scraper i API ofert pracy z **Aplikuj.pl**: pobiera wynagrodzenie w PLN miesięcznie i godzinowo (brutto, netto, netto + VAT dla B2B), firmę, miejscowość, województwo, odległość, rodzaj umowy, wymiar i tryb pracy, poziom stanowiska, obowiązki, wymagania i benefity. Wyszukiwanie po słowach kluczowych, miastach z odległością, województwach i kategoriach. Filtry serwisu (umowa, wymiar, poziom, tryb pracy, np. praca zdalna, tylko z wynagrodzeniem, tylko bezpośrednio od pracodawcy, data, praca od zaraz, bez doświadczenia), tylko wybrana miejscowość, monitoring nowych i usuniętych ofert, powiadomienia w Telegramie, Slacku, Discordzie i WhatsAppie, numery telefonów firm na życzenie. Bez proxy. Eksport do Excela, CSV lub JSON.

### Why use this Aplikuj.pl scraper?

- 🏢 **Direct employers only.** Employment and temporary work agencies (Work\&Profit, APC Tempus, Trenkwalder and others) post a large part of Aplikuj.pl; without the filter the website counts 38 433 offers, with it 34 780. Turn on **Direct employers only (no agencies)** to get offers posted by the employers themselves.
- 🎯 **Only this location.** Town searches include jobs within 30 km by default and offers for a whole voivodeship. Choose the **distance** (+0 to +50 km) and turn on **Only this location** to keep just the town; nearby towns come with `distanceKm`.
- 🔎 **The website's own filters:** contract type (umowa o pracę, zlecenie, o dzieło, tymczasowa, na zastępstwo, agencyjna, B2B, staż, wolontariat), working time, 10 seniority levels, work mode (on site, hybrid, remote, mobile), only with a salary, posted in the last 1, 3, 7 or 14 days, start immediately, no experience needed, online recruitment, workers from Ukraine welcome, only jobs in Poland, 38 categories. Plus salary from / up to per month or hour, title must (not) contain and exclude companies.
- 💰 **Salaries you can compare.** `salaryMin`/`salaryMax` as numbers, `salaryCurrency`, `salaryKind` (`gross`, `net`, `netPlusVat`) and **monthly and hourly equivalents**; obviously mislabelled amounts (52 zł per month) are kept as shown but not converted.
- 📋 **Structured job pages:** with details, the responsibilities, requirements and the employer's offer come as lists, the benefits as a list, next to the full description in text, Markdown or HTML.
- ✅ **Complete results.** When a search is read in full, the actor checks it against the website's own count and adds any offers missed while the list was changing ("the website reported 165 offers, 165 read").
- 📬 **Monitoring mode:** a daily feed of new and changed jobs (`changeType`), optionally with **removed jobs** checked on the job page: `removedReason` `expired` or `noLongerMatches`.
- 📞 **Phone numbers of employers (optional, paid):** the recruitment number the website shows behind its "Pokaż nr telefonu" button, for business employers only.
- 🔔 **Notifications** to **Telegram, Slack, Discord, WhatsApp** or **your webhook** after each run.
- 📊 **Free market summary** (SUMMARY): salary median and quartiles by salary kind, voivodeship and category, top employers, contract types and the website's count for every search.
- 🛡️ **No proxy needed**, no extra platform cost: you pay only the prices below.
- 🔒 **Privacy first.** E-mails and phone numbers in texts are replaced with `[e-mail removed]` / `[phone removed]`. Employer names that look like a private person (sole traders such as "Usługi Transportowe Jan Kowalski") are hidden automatically, together with the profile, and the job URL then has no name in it; in doubt, privacy wins. In our sample of 109 employers, 8 were hidden.

### What data can you get?

| Field | Example |
|---|---|
| Title, company, company ID, profile, logo | Specjalista ds. sprzedaży telefonicznej (k/m), PREMIUM PRO GROUP Sp. z o.o., 14320 |
| Location, voivodeship, distance | Kraków, małopolskie; "Katowice (Tychy - 15km)": Katowice, distanceKm 15, nearTo Tychy |
| Whole voivodeship, abroad | wholeRegion; isAbroad, workCountry `Niemcy` |
| Salary | 4 806 – 6 000 PLN per month, gross (hourly 30.04 – 37.50), "4 806-6 000 zł brutto / mies." |
| Contract | polishContractTypes `employment`, `mandate`, `temporaryWork`, `b2b`…; contractTypes `employee`/`workAgreement`/`freelance` |
| Labels | immediateStart, noExperienceRequired, onlineRecruitment, ukrainianWelcome, hasVideo, isPromoted, isRecommended |
| Dates | postedAt `2026-11-17` (added or refreshed), expiresInDays; with details firstPublishedAt `2026-10-21`, validThrough `2026-11-20` |
| With details | description (text, Markdown or HTML), responsibilities, requirements, offer, benefits, employmentType `fullTime`, seniority `mid`, workModes `onsite`, category, profession, applyUrl, directApply, isPopular |
| With phone numbers | phoneNumber `+48…` (business employers only) |
| Monitoring | changeType, changedFields, firstSeenAt, removedAt, removedReason |

**How complete the data is** (our sample of 202 offers, November 2026): salary on 25 % of the offers (the website shows no salary for the rest), voivodeship or country for 95 %, contract type for 92 %, the day added for 76 % on the list (the cards of offers that end soon show the end date instead; with details 100 %). With details the description, category and dates for 100 % of the jobs read. About 4 % of the offers are abroad.

### How to scrape Aplikuj.pl

1. Enter **Search queries** (e.g. `magazynier`, `kierowca`), **Locations** (`Warszawa`, `mazowieckie`), **Categories**, or paste **Aplikuj.pl URLs**.
2. Set **Max jobs** and the filters you need; choose **Distance from the town** or turn on **Only this location** for jobs in that town only.
3. Turn on **Add description and details** if you need the full text, the lists and the benefits.
4. Run it and download the results as Excel, CSV, JSON or via the API. Schedule it with **Monitoring** on for a daily feed. Extra export formats: a printable HTML report or a Markdown table, besides Excel, CSV and JSON.

### Use cases

#### New warehouse jobs in Warsaw every morning, direct employers only

```json
{
  "searchQueries": ["magazynier"],
  "locations": ["Warszawa"],
  "directEmployersOnly": true,
  "maxItems": 0,
  "onlyNewOrChanged": true,
  "monitoringKey": "magazynier-warszawa"
}
```

#### Drivers in Silesia with an employment contract and a salary

```json
{
  "searchQueries": ["kierowca"],
  "locations": ["śląskie"],
  "contractTypes": ["employment"],
  "onlyWithSalary": true,
  "maxItems": 200
}
```

#### Jobs without experience in Kraków only, from the last 3 days

```json
{
  "locations": ["Kraków"],
  "distanceKm": "0",
  "strictLocation": true,
  "noExperience": true,
  "postedWithinDays": 3,
  "maxItems": 0
}
```

#### Teachers with full job pages for an AI agent

```json
{
  "searchQueries": ["nauczyciel"],
  "categories": ["edukacja-badania-naukowe-szkolenia-tlumaczenia"],
  "includeDetails": true,
  "descriptionFormat": "markdown",
  "compactOutput": true,
  "maxItems": 100
}
```

#### Selected offers and searches by URL

```json
{
  "startUrls": [
    { "url": "https://www.aplikuj.pl/oferta/3359533/specjalista-ds-sprzedazy-telefonicznej-k-m-umowa-o-prace-premium-pro-group-sp-z-o-o" },
    { "url": "https://www.aplikuj.pl/praca/krakow?keyword=kierowca" }
  ]
}
```

A job URL always comes with its job page data (description, lists, dates) and is charged as one job; the job-page charge is added only when **Add description and details** is on. When the website rejects the job page, the job is looked up in the website's search (the same job ID) and saved with its listing data instead.

#### Monitoring mode explained

With **Monitoring: only new or changed jobs** the actor remembers what it saw (under your **Monitoring key**) and returns only jobs that are new or whose title, company, salary, place, contract types or work mode changed. Unchanged jobs are free; every listing page read is charged as a monitoring page. With **Monitoring: include removed jobs** you also get the jobs that left the search since the last run, checked on the job page.

#### Phone numbers (optional)

With **Phone numbers** on, the actor adds `phoneNumber`: the recruitment number the website shows to job seekers behind its "Pokaż nr telefonu" button, as `+48XXXXXXXXX`. Only for business employers; never for an employer that is a private person. In our sample 6 of 10 job pages had the button. A recruitment number can be the personal number of a recruiter, so it is **personal data**: you are responsible for using it lawfully (GDPR), for example only to apply for the job. The option reads each job page (the job-page charge applies) and charges only the numbers returned. **Max phone numbers** caps the lookups per run (default 500). Without the option, the status tells how many saved jobs have a number behind the button.

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

Fill in a Telegram bot token and chat ID, a Slack or Discord webhook, a WhatsApp access token with your business phone number ID and the recipient's number, or your own HTTPS URL. After each run (by default only when something was saved) you get the title, company, place, salary and link of the saved jobs. Nothing else is sent (never a phone number).

#### Market summary (SUMMARY)

Every run saves a free summary in the key-value store (record `SUMMARY`): counts, the website's count for every search, salary quartiles overall, by salary kind, voivodeship and category, top companies, work arrangement, contract types and seniority.

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

Pay per result, no subscription, **no proxy or platform costs on top**.

| What | FREE | BRONZE | SILVER | GOLD+ |
|---|---|---|---|---|
| 1 000 jobs | **$0.36** | $0.34 | $0.32 | $0.30 |
| Job page read ("Add description and details", per 1 000 jobs) | +$1.25 | +$1.25 | +$1.25 | +$1.25 |
| **1 000 jobs with details** | **$1.61** | $1.59 | $1.57 | $1.55 |
| Phone number returned (per 1 000 numbers, optional) | +$3.00 | +$3.00 | +$3.00 | +$3.00 |
| Run start | $0.003 | $0.003 | $0.003 | $0.003 |

Other events, only when they happen: **monitoring page** $0.30 per 1 000 pages of results read in monitoring mode, **extra page** $0.30 per 1 000 pages read beyond what the saved jobs cover (a filter that keeps few jobs, a search without results, ended job URLs, phone lookups without a number, pages read again to complete a search), **notification** $0.001 per run that sent one, **fast mode** $0.01 per 1 000 jobs saved at the fast speed. If the saved jobs don't cover a run's cost (e.g. the website answers very slowly), the difference is charged as extra pages; the log says how many. A normal run pays nothing more.

| Typical run | Price (FREE) | Typical time |
|---|---|---|
| 20 jobs (the example input) | $0.01 | under 10 s |
| 1 000 jobs | $0.36 | about 30 s |
| 1 000 jobs with details | $1.61 | about 17 min (about 7 min in fast mode) |
| Daily monitoring of a town search, ~10 new jobs a day | about $0.01 a day | a few seconds |

### Input example

```json
{
  "searchQueries": ["magazynier"],
  "locations": ["Warszawa"],
  "maxItems": 20
}
```

### Output example

```json
{
  "id": "aplikuj:3359533",
  "source": "aplikuj.pl",
  "url": "https://www.aplikuj.pl/oferta/3359533/specjalista-ds-sprzedazy-telefonicznej-k-m-umowa-o-prace-premium-pro-group-sp-z-o-o",
  "jobId": "3359533",
  "title": "Specjalista ds. sprzedaży telefonicznej (k/m)",
  "company": "PREMIUM PRO GROUP Sp. z o.o.",
  "companyId": "14320",
  "location": "Kraków",
  "region": "małopolskie",
  "distanceKm": null,
  "isAbroad": false,
  "workArrangement": "onsite",
  "salaryMin": 4806,
  "salaryMax": 6000,
  "salaryCurrency": "PLN",
  "salaryPeriod": "month",
  "salaryKind": "gross",
  "salaryText": "4 806-6 000 zł brutto / mies.",
  "salaryHourlyMin": 30.04,
  "employmentType": ["fullTime"],
  "polishContractTypes": ["employment"],
  "seniority": ["mid"],
  "category": "Sprzedaż / Zakupy",
  "profession": "Specjalista ds. sprzedaży",
  "immediateStart": true,
  "noExperienceRequired": true,
  "postedAt": "2026-11-16",
  "firstPublishedAt": "2026-10-21",
  "validThrough": "2026-11-20",
  "responsibilities": ["pozyskiwanie nowych klientów dla firmy,", "dbałość o dobry wizerunek firmy,"],
  "benefits": ["Prywatna opieka medyczna", "Karta sportowa"],
  "directApply": true,
  "detailScraped": true,
  "scrapedAt": "2026-11-17T09:24:42Z"
}
```

### Limitations

- The salary is only where the employer shows it (about a quarter of offers); a salary written only in the text of the offer is not read into the salary fields.
- `postedAt` is the day the offer was added or refreshed; the card of an offer that ends within days shows its end instead, so `postedAt` is then empty without details. A refreshed offer can be first published weeks earlier (`firstPublishedAt`, with details).
- Working time, seniority and the on-site work mode are on the job page only (with details); the list shows the main contract type and remote or hybrid work.
- Salary filters compare amounts in PLN; salaries in another currency (jobs abroad) don't pass them.

### For AI agents and API users

Use **Compact output** for small rows and **Description format** `markdown` for LLM-ready text. Every row has a stable `id`, so repeated runs can be merged. Call it from the API, from MCP clients or schedule it; the dataset and the `SUMMARY` record are in the run's default storages.

### Troubleshooting

- **"Locations not found on Aplikuj.pl"**: write the town as on the website (`Bielsko-Biała`, `Zielona Góra`) or use a voivodeship (`mazowieckie`). The actor never replaces an unknown town with the whole country.
- **"filtered out: N outside the location"**: the website added nearby towns or offers for the whole voivodeship; that's what **Only this location** removes.
- **"N listing pages could not be read, so the results may be incomplete"**: the website did not answer some pages; run it again later.
- **"Aplikuj.pl is rejecting requests"**: 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. Try later or turn on Apify Proxy.

### 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
- [Pracuj.pl Scraper](https://apify.com/tsutseisoftware/pracuj-scraper): the biggest Polish job board: salary, contract types, work modes, company, 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
- [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 Aplikuj.pl?

It reads only publicly available data, without logging in, at most 60 requests per minute (150 in 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 removes e-mails and phone numbers from the texts and hides employer names of private persons. Phone numbers are returned only when you turn the option on, and only for business employers. The website's terms of use may restrict extracting its data; 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 Aplikuj.pl.

#### Why are there jobs from other towns in my town search?

Aplikuj.pl searches 30 km around a town by default and adds offers for the whole voivodeship. Set **Distance from the town** to +0 km or turn on **Only this location**.

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

The employer name looks like a private person's name (a sole trader), so it is hidden for privacy, together with the profile; the name is also replaced with `[employer]` in the texts.

#### How are salaries converted?

`salaryMin` and `salaryMax` are the amounts the website shows. Hourly and monthly equivalents use standard full-time hours; obviously mislabelled periods are left out of the equivalents and the statistics. Gross, net and net + VAT (B2B) amounts are not directly comparable (`salaryKind`).

#### Do I need a proxy?

No. The default is no proxy and the price includes everything. If you turn on a residential proxy yourself, every request through it is charged as 3 extra pages, because that traffic is paid by the megabyte.

This scraper is also known as an Aplikuj.pl API or Aplikuj.pl job scraper (Polish: "oferty pracy Aplikuj.pl", "scraper ofert pracy", "eksport ofert pracy do Excela").

# Changelog

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

# Actor input Schema

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

Keywords to search for, e.g. "kierowca", "magazynier", "księgowa", "spawacz". Each query is a separate search (combined with the locations). Empty = all jobs. At most 20.

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

Polish towns or voivodeships, one search each, e.g. "Warszawa", "Kraków", "Bielsko-Biała", "mazowieckie" (diacritics are optional: "lodz" works). A town the website doesn't know is reported, never replaced by the whole country. Town searches include jobs within "Distance from the town" (the website's default is 30 km); "Only this location" keeps just the town. At most 30.

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

Only jobs in these categories (branże) of the website. Several values = any of them.

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

Listing URLs from Aplikuj.pl with any filters you set on the website, any page, e.g. https://www.aplikuj.pl/praca/krakow?keyword=kierowca or https://www.aplikuj.pl/praca/warszawa/magazynier, and job URLs (https://www.aplikuj.pl/oferta/3367709/…), the same as in the "url" field of the results. The filters below are added to these URLs too. A job URL always returns the job page data (description, dates, benefits) and is charged as one job; the "Job page read" charge is added only with "Add description and details" on.

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

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

## `maxItemsPerStartUrl` (type: `integer`):

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

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

Safety limit for each search or URL, in pages of results as on the website (50 jobs a page). 0 = no limit.

## `distanceKm` (type: `string`):

Search radius around the towns in "Locations" (and town URLs), as on the website. Empty = the website's default (+30 km). +0 km keeps the town and offers that list it among their places.

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

Keep only jobs in the town (or voivodeship) you searched for: no nearby towns, no offers for a whole voivodeship and no jobs abroad. Jobs skipped by this option cost nothing.

## `onlyInPoland` (type: `boolean`):

Skip jobs abroad (the website lists many, mostly in Germany and the Netherlands).

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

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

Only jobs for these position levels (poziom stanowiska).

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

Only jobs offering one of these work modes.

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

Skip jobs that show no salary.

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

Only offers posted directly by the employer: no employment and temporary work agencies, which post a large part of the offers on the website.

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

Only jobs added or refreshed in the last N days (1, 3, 7 and 14 exactly as on the website; other values are checked on the date of each job). 0 = any time.

## `immediateStart` (type: `boolean`):

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

## `noExperience` (type: `boolean`):

Only jobs marked "bez doświadczenia".

## `onlineRecruitment` (type: `boolean`):

Only jobs with a remote recruitment process ("rekrutacja zdalna").

## `ukrainianWelcome` (type: `boolean`):

Only jobs whose employer invites workers from Ukraine.

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

Only jobs whose salary reaches at least this amount per "Salary period", e.g. 6000 per month or 35 per hour (hourly and monthly amounts are compared at standard full-time hours). Jobs without a salary and salaries in another currency (jobs abroad) are skipped. Checked by the actor.

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

Skip jobs whose salary starts above this amount per "Salary period". Jobs without a salary are kept; salaries in another currency than PLN are skipped.

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

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

## `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. "praktykant", "Niemcy".

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

Skip jobs of companies whose name contains any of these texts, e.g. an agency you don't want.

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

Open each job page to add the full description (e-mails and phone numbers removed), the responsibilities, requirements and offer as lists, the benefits, the first publication and end dates, the category and profession, working time, seniority, work mode and the apply link. Extra charge "Job page read" ($1.25 per 1 000 jobs whose page was read).

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

Format of "description": plain text, Markdown (headings and lists, good for AI agents and Notion) or simple HTML.

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

Shorten the description to about this many characters (e.g. 300 for a snippet). 0 = full text.

## `includePhoneNumbers` (type: `boolean`):

Add the employer's recruitment phone number that the website shows behind its "Pokaż nr telefonu" button ("phoneNumber"), for business employers only, never for an employer that is a private person. It is personal data of the recruiter in some cases: you are responsible for using it lawfully (GDPR). Reads each job page (the "Job page read" charge applies) and adds the charge "Phone number" ($3.00 per 1 000 phone numbers returned). Off by default.

## `maxPhoneNumbers` (type: `integer`):

At most this many phone lookups per run (the rest of the jobs is saved without a number).

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

Return only jobs that are new or whose title, company, salary, place, contract types or work mode changed since the previous run with the same Monitoring key. Unchanged jobs are free; listing pages read in this mode are $0.30 per 1 000 pages (the monitoring-page event; one page of results as on the website).

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

Name of the saved state. Use a different key for each watched search (e.g. "kierowca-krakow"). 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 offer ended) or "noLongerMatches" (the offer is live but no longer in the search), checked on the job page. Checked only when the run reads every search completely (the status message says why not). Removed rows are charged like any other job.

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

Only the core fields (title, company, place, salary, work mode, working time, contract types, seniority, date, 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`):

Reads up to about 2.5x faster, which helps most with "Add description and details", 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. Extra charge "Fast mode" ($0.01 per 1 000 jobs saved while the fast speed was on).

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

No proxy needed (the default). If the website starts rejecting requests, Apify Proxy can be turned on; requests through a residential proxy cost extra (see the README).

## `exportFormats` (type: `array`):

Off by default. Printable HTML report: the results as a clean, branded table with the main columns, made for printing, saving as PDF or sending to someone; for working with the data use Excel or CSV, which have every field. Markdown table: the same columns as text for AI tools, docs or GitHub. The Output tab links the files. Each file has the overview columns of every saved row and nothing is left out, so a run with tens of thousands of rows makes a file of tens of MB that can be slow to open; for big runs use the dataset or its Excel export. Excel (XLSX), CSV and JSON are always in the Output tab and under Export, at no extra cost.

## `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": [
    "magazynier"
  ],
  "locations": [
    "Warszawa"
  ],
  "maxItems": 20,
  "maxItemsPerStartUrl": 0,
  "maxPages": 0,
  "strictLocation": false,
  "onlyInPoland": false,
  "onlyWithSalary": false,
  "directEmployersOnly": false,
  "immediateStart": false,
  "noExperience": false,
  "onlineRecruitment": false,
  "ukrainianWelcome": false,
  "salaryPeriod": "month",
  "includeDetails": false,
  "descriptionFormat": "text",
  "descriptionMaxLength": 0,
  "includePhoneNumbers": false,
  "maxPhoneNumbers": 500,
  "onlyNewOrChanged": false,
  "includeRemovedJobs": false,
  "compactOutput": false,
  "whatsappTemplateLanguage": "en_US",
  "notificationLimit": 10,
  "notifyOnlyChanges": true,
  "fastMode": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "exportFormats": [],
  "sendErrorReports": true
}
```

# Actor output Schema

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

All saved jobs of the run.

## `summary` (type: `string`):

Free market summary of the run: counts, salary quartiles, top companies, work modes, contract types and the website's count for every search.

## `excel` (type: `string`):

All saved rows as an Excel file, with every field.

## `htmlReport` (type: `string`):

The saved rows with the main columns as a clean table to print, save as PDF or send; only when "Extra export formats" includes it. Excel has every field.

## `markdown` (type: `string`):

The saved rows as a Markdown table, handy for AI tools, docs and GitHub; only when "Extra export formats" includes Markdown.

# 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": [
        "magazynier"
    ],
    "locations": [
        "Warszawa"
    ],
    "maxItems": 20,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("tsutseisoftware/aplikuj-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 = {
    "searchQueries": ["magazynier"],
    "locations": ["Warszawa"],
    "maxItems": 20,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("tsutseisoftware/aplikuj-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 '{
  "searchQueries": [
    "magazynier"
  ],
  "locations": [
    "Warszawa"
  ],
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call tsutseisoftware/aplikuj-pl-scraper --silent --output-dataset

```

## MCP server setup

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