# InfoPraca Scraper ($0.89/1K): Polish Jobs & Salaries (`tsutseisoftware/infopraca-scraper`) Actor

Scrape InfoPraca.pl jobs: salary in PLN per month and hour, company, town, voivodeship, jobs abroad, working time, category. Search filters of the website, full descriptions, monitoring of new and removed jobs, notifications. Oferty pracy i praca za granicą.

- **URL**: https://apify.com/tsutseisoftware/infopraca-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.69 / 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

## InfoPraca Scraper: Polish Jobs & Salaries

Get job offers from **InfoPraca.pl**, a long-standing Polish job board (about 16 000 offers, a quarter of them jobs abroad), as a clean table. Search by **keywords**, **towns with a distance**, **voivodeships**, **countries abroad** and **categories**, or paste any InfoPraca search or job URL. For each job you get the title, company, town, postal code and **voivodeship** (or the **country of work** for jobs abroad), **salary in PLN with monthly and hourly equivalents and its kind (gross or net)**, working time and shift, a short summary of the offer and the time of the last update. Optionally the actor opens each job page and adds the **full description and requirements** (e-mails and phone numbers removed), the **contract**, vacancies, minimum experience and education, all categories, the publication and end dates, the employer's profile and the **application link**.

Use the website's own filters (**working time, education, posting period, distance from a town**) at no cost, and filter further by **salary from / up to**, **jobs abroad** and words in the title. Filtered-out jobs are not saved and not charged.

> **Po polsku:** Scraper i API ofert pracy z **InfoPraca.pl**: pobiera wynagrodzenie w PLN miesięcznie i godzinowo (brutto lub netto), firmę, miejscowość, kod pocztowy, województwo lub kraj pracy za granicą, wymiar etatu, branżę oraz z opisem rodzaj umowy, liczbę wakatów, doświadczenie, wykształcenie i link do aplikacji. Filtry serwisu (wymiar etatu, wykształcenie, okres publikacji, odległość od miasta) oraz wynagrodzenia i ofert zagranicznych (praca za granicą, np. w Niemczech lub Holandii), monitoring nowych i usuniętych ofert, powiadomienia w Telegramie, Slacku, Discordzie i WhatsAppie oraz podsumowanie rynku. Bez proxy. Eksport do Excela, CSV lub JSON.

### Why use this InfoPraca scraper?

- 🔎 **The website's own search, all of it:** keywords, towns with a distance (0 to 50 km), voivodeships, all jobs abroad or a country (`Niemcy`, `Holandia`), 25 categories, working time, minimum education and the posting period, combined as you like.
- 📚 **Every offer of a big search.** InfoPraca shows at most 555 pages (about 10 000 offers) of one search; a bigger search without a place (e.g. all offers) is read voivodeship by voivodeship and abroad, at no extra cost, so you get all ~16 000.
- 💰 **Salaries you can compare.** `salaryMin`/`salaryMax` as numbers, `salaryKind` (`gross`, `net`) and **monthly and hourly equivalents**; open ranges ("6 500 PLN - ?") and obvious typos ("5 440 - 544 PLN") are handled, not turned into nonsense.
- 🌍 **Jobs abroad, clearly marked.** `isAbroad` and `workCountry` (Niemcy, Holandia…); keep them, leave them out or take only them.
- ✅ **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 log and status show both numbers ("the website reported 197 offers, 197 read").
- 📞 **Phone numbers behind the website's button (optional, paid):** about a third of the job pages have a "show phone number" or WhatsApp button for applying; the option returns those numbers, for company ads only.
- 📬 **Monitoring mode:** a daily feed of new and changed jobs (`changeType`), optionally with **removed jobs** checked on the job page: `removedReason` `expired` or `noLongerMatches`.
- 🔔 **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, working time, contracts, jobs abroad by country 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 "PHU Jan Kowalski") are hidden automatically, together with their logo and profile; in doubt, privacy wins. In our sample of 150 offers, 4 employers were hidden.

### What data can you get?

| Field | Example |
|---|---|
| Title, company, company ID, profile, logo | Przedstawiciel Handlowy - Praca w terenie, HYLA POLAND Sp. z o.o., 1064935 |
| Town, place as shown, postal code, powiat, voivodeship | Poznań, "60-118, Poznań", 60-118, wielkopolskie |
| Abroad | isAbroad, workCountry `Niemcy` |
| Salary | 6 000 – 18 000 PLN per month, gross (hourly 37.50 – 112.50), "6 000PLN - 18 000PLN / Miesięcznie (Brutto)" |
| Working time | workingTime `fullTime` / `partTime` / `any`, shift `afternoon`, "Pełny etat - popołudnie" |
| Dates | updatedAt (last update, as the website orders the list), postedAt and validThrough |
| Labels | isPromoted ("Oferta wyróżniona"), descriptionSnippet |
| With details | description and requirements (text, Markdown or HTML), benefits, contractType ("Na czas nieokreślony", "Własna działalność"), vacancies, experience, education, categories, applyUrl, directApply, phoneApply, whatsappApply |
| With phone numbers | phoneNumbers `+48539397739` (company ads only) |
| Monitoring | changeType, changedFields, firstSeenAt, removedAt, removedReason |

**How complete the data is** (our sample of 150 offers, November 2026): salary on 23 % of offers (the website shows no salary for the rest), voivodeship for 73 % and country of work for the 27 % abroad; with details the description, contract, experience, education and end date for all jobs read; a phone or WhatsApp button on about a third of the job pages. The publication and end dates come with details (in the website's default order also for some offers of the first page).

### How to scrape InfoPraca

1. Enter **Search queries** (e.g. `magazynier`, `kierowca`), **Locations** (`Kraków`, `mazowieckie`, `zagranica`, `Niemcy`), **Categories**, or paste **InfoPraca URLs**.
2. Set **Max jobs** and the filters you need (distance from the town, working time, education, posting period, salary, jobs abroad).
3. Turn on **Add description and details** if you need the full text, the contract and the application link.
4. Run it and download the results as Excel, CSV, JSON or via the API. Schedule it with **Monitoring** on for a daily feed.

### Use cases

#### New warehouse jobs within 25 km of Poznań every morning

```json
{
  "searchQueries": ["magazynier"],
  "locations": ["Poznań"],
  "radiusKm": "25",
  "maxItems": 0,
  "onlyNewOrChanged": true,
  "monitoringKey": "magazynier-poznan"
}
```

#### Jobs in Germany with a salary of at least 10 000 PLN a month

```json
{
  "locations": ["Niemcy"],
  "minSalary": 10000,
  "includeDetails": true,
  "maxItems": 200
}
```

#### Part-time jobs in Masovia posted in the last 7 days, Poland only

```json
{
  "locations": ["mazowieckie"],
  "workingTime": "partTime",
  "postedWithinDays": "7",
  "abroad": "exclude",
  "maxItems": 0
}
```

#### Drivers and couriers with full descriptions for an AI agent

```json
{
  "categories": ["transport-spedycja-praca-dla-kierowcow"],
  "includeDetails": true,
  "descriptionFormat": "markdown",
  "compactOutput": true,
  "maxItems": 100
}
```

#### All offers of the website

```json
{
  "maxItems": 0
}
```

Read voivodeship by voivodeship and abroad (the website shows at most about 10 000 offers of one search), about 900 pages of results.

#### Selected jobs and searches by URL

```json
{
  "startUrls": [
    { "url": "https://www.infopraca.pl/praca/przedstawiciel-handlowy-praca-w-terenie/60-118/18332010" },
    { "url": "https://www.infopraca.pl/praca?q=spawacz&rg=slaskie" }
  ]
}
```

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

#### Phone numbers

Many InfoPraca offers (in our sample about a third) can be answered by phone or WhatsApp through a button on the job page. With **Phone numbers behind the website's button** the actor returns those numbers in `phoneNumbers` (`+48…`), **only for offers of companies, never for a private person**, and only from job pages it reads anyway (the option turns on **Add description and details**). You pay "Phone number" only for a job whose number was returned, at most **Max jobs with phone numbers per run** jobs. Without the option the status tells you how many saved jobs have such a number. The numbers are personal data of the company's recruiters in some cases: you are responsible for using them lawfully (GDPR), e.g. only to answer the offer.

#### 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, town, voivodeship or working time 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.

#### 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 phone numbers).

#### 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, working time, contracts, voivodeships and countries of jobs abroad.

#### Output formats

Download the results as Excel, CSV, JSON or XML from the **Output** tab. Extra export formats: a printable HTML report or a Markdown table, besides Excel, CSV and JSON (input **Extra export formats**, off by default).

### How much does it cost to scrape InfoPraca?

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

| What | FREE | BRONZE | SILVER | GOLD+ |
|---|---|---|---|---|
| 1 000 jobs | **$0.89** | $0.85 | $0.79 | $0.69 |
| Job page read ("Add description and details", per 1 000 jobs) | +$0.25 | +$0.25 | +$0.25 | +$0.25 |
| **1 000 jobs with details** | **$1.14** | $1.10 | $1.04 | $0.94 |
| Phone number (per job with a number returned) | $0.003 | $0.003 | $0.003 | $0.003 |
| 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, 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.02 | under 10 s |
| 1 000 jobs | $0.89 | about 1 minute |
| 1 000 jobs with details | $1.14 | about 17 min (about 7 min in fast mode) |
| Daily monitoring of a town search, ~5 new jobs a day | about $0.01 a day | a few seconds |

### Input example

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

### Output example

```json
{
  "id": "infopraca:18332010",
  "source": "infopraca.pl",
  "url": "https://www.infopraca.pl/praca/przedstawiciel-handlowy-praca-w-terenie/60-118/18332010",
  "offerId": "18332010",
  "title": "Przedstawiciel Handlowy - Praca w terenie",
  "company": "HYLA POLAND Sp. z o.o.",
  "companyId": "1064935",
  "companyUrl": "https://www.infopraca.pl/pracodawca/hyla-poland-sp-z-o-o/1064935",
  "location": null,
  "postalCode": "60-118",
  "region": "wielkopolskie",
  "isAbroad": false,
  "workCountry": null,
  "salaryMin": 6000,
  "salaryMax": 18000,
  "salaryCurrency": "PLN",
  "salaryPeriod": "month",
  "salaryKind": "gross",
  "salaryText": "6 000PLN - 18 000PLN / Miesięcznie (Brutto)",
  "salaryMonthlyMin": 6000,
  "salaryHourlyMin": 37.5,
  "workingTime": "fullTime",
  "workingTimeText": "Pełny etat - popołudnie",
  "shift": "afternoon",
  "contractType": "Własna działalność",
  "category": "Sprzedaż - Przedstawiciele handlowi",
  "experience": "Bez doświadczenia",
  "education": "Bez wykształcenia",
  "vacancies": 3,
  "isPromoted": true,
  "updatedAt": "2026-11-16T18:00:05+01:00",
  "postedAt": "2026-11-06T17:07:14+01:00",
  "validThrough": "2026-11-27T17:07:14+01:00",
  "description": "HYLA jest światowym Liderem w dziedzinie innowacyjnych systemów oczyszczania powietrza i powierzchni…",
  "requirements": "Prawo jazdy kategorii B oraz samochód osobowy.…",
  "directApply": true,
  "phoneApply": false,
  "phoneNumbers": [],
  "detailScraped": true,
  "scrapedAt": "2026-11-17T09:24:42Z"
}
```

### Limitations

- The salary is only where the employer shows it (about a quarter of offers).
- The website shows at most about 10 000 offers of one search. A bigger search without a place is read voivodeship by voivodeship; a bigger search for a town or a voivodeship (rare) is read up to that limit and the status says so.
- The website's filters take one value each, so **Working time** and **Education** take one value; several search queries, locations or categories make one search each.
- A town the website doesn't know gives no jobs; the status lists it under "no jobs".
- `postedAt` and `validThrough` come with details (in the website's default order also for some offers of the first page); `updatedAt` is always there.
- Salary filters compare amounts in PLN; salaries in another currency 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

- **"no jobs: in …"**: the website has no offers for that search, or doesn't know the town; write the town as on the website (`Bielsko-Biała`, `Zielona Góra`) or use a voivodeship (`mazowieckie`).
- **"N listing pages could not be read, so the results may be incomplete"**: the website did not answer some pages; run it again later.
- **"InfoPraca.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.

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

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

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.

### FAQ

#### Is it legal to scrape InfoPraca?

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 behind the website's button are returned only on request and only for companies. 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 InfoPraca.pl.

#### 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 logo and 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 and net 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 InfoPraca API or InfoPraca job scraper (Polish: "oferty pracy InfoPraca", "praca za granicą", "scraper ofert pracy").

# 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 and categories). At most 20.

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

Polish towns, voivodeships or countries, one search each: "Warszawa", "Kraków", "mazowieckie", "zagranica" (all jobs abroad) or a country in Polish ("Niemcy", "Holandia"). Diacritics are optional for voivodeships. A town the website doesn't know gives no jobs (reported in the status). At most 30.

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

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

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

Open each job page to add the full description and requirements (e-mails and phone numbers removed), the contract, vacancies, minimum experience and education, all categories, the publication and end dates, the employer's profile and application link. Extra charge "Job page read" ($0.25 per 1 000 jobs whose page was read).

## `radiusKm` (type: `string`):

For a town in "Locations": also jobs up to this distance, as on the website. Empty = the website's default (25 km).

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

Only jobs in these categories (branże) of the website, one search each (combined with the search queries and locations).

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

Search URLs from InfoPraca.pl with any filters and page, e.g. https://www.infopraca.pl/praca?q=kierowca\&lc=Kraków\&d=25 or https://www.infopraca.pl/praca?ct=logistyka, and job URLs (https://www.infopraca.pl/praca/…/…/18332010), the same as in the "url" field of the results. The filters below are applied to these URLs too. A job URL always returns the job page data (description, dates, contract) and is charged as one job; the "Job page read" charge is added only with "Add description and details" on.

## `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 (18 jobs per page). 0 = no limit.

## `workingTime` (type: `string`):

Only full-time or part-time jobs (the website's filter). Empty = all.

## `education` (type: `string`):

The website's filter by your education: offers whose minimum requirement is this level or lower. Empty = all.

## `postedWithinDays` (type: `string`):

The website's posting-period filter. Empty = any time.

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

Skip jobs that show no salary.

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

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

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

## `abroad` (type: `string`):

The website has many jobs abroad (Germany, the Netherlands…), also in searches without a place.

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

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

Skip jobs of companies whose name contains any of these texts (e.g. an agency).

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

Format of "description" and "requirements": 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`):

Adds the phone and WhatsApp numbers the website shows behind its "show phone number" and WhatsApp buttons, for offers of companies only; never for a private person. The numbers are on the job page, so this option also reads the job pages ("Add description and details" and its charge). Extra charge "Phone number" ($0.003 per job with a number returned). You are responsible for using the numbers lawfully (GDPR).

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

At most this many jobs get their phone numbers in one run; the other jobs are saved without them.

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

Return only jobs that are new or whose title, company, salary, town, voivodeship or working time 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 ad ended) or "noLongerMatches" (the ad 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, working time, 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).

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

Order of the search results (matters with Max jobs).

## `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"
  ],
  "maxItems": 20,
  "includeDetails": false,
  "maxItemsPerStartUrl": 0,
  "maxPages": 0,
  "onlyWithSalary": false,
  "salaryPeriod": "month",
  "abroad": "include",
  "descriptionFormat": "text",
  "descriptionMaxLength": 0,
  "includePhoneNumbers": false,
  "maxPhoneNumbers": 500,
  "onlyNewOrChanged": false,
  "includeRemovedJobs": false,
  "compactOutput": false,
  "whatsappTemplateLanguage": "en_US",
  "notificationLimit": 10,
  "notifyOnlyChanges": true,
  "fastMode": false,
  "sortBy": "date",
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "exportFormats": [],
  "sendErrorReports": true
}
```

# Actor output Schema

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

All saved jobs of the run (one row per offer).

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

Free market summary of the run: counts, salary quartiles, top companies, working time, contracts, voivodeships, jobs abroad 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"
    ],
    "maxItems": 20,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

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

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

```

## MCP server setup

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