# CBOP Poland Scraper - Polish Public Employment Service Jobs (`studio-amba/cbop-poland-scraper`) Actor

Scrape job vacancies from oferty.praca.gov.pl (CBOP), Poland's national public employment service portal aggregating listings from every regional PUP office. Search by occupation keyword. Extract titles, employers, salaries, locations, contract types, and hiring-contact details. No login required.

- **URL**: https://apify.com/studio-amba/cbop-poland-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Jobs
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 result scrapeds

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

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

### What does CBOP Poland Scraper do?

**CBOP Poland Scraper** extracts job vacancies from [oferty.praca.gov.pl](https://oferty.praca.gov.pl/portal), Poland's national public employment service portal (Centralna Baza Ofert Pracy — CBOP). CBOP aggregates listings submitted by every regional Powiatowy Urząd Pracy (PUP) office, the Voluntary Labour Corps (OHP), and regional labour offices (WUP) into one national feed. It collects job titles, employers, locations (city, voivodeship, coordinates), salaries, contract types, full requirements and responsibilities text, and — when disclosed — the hiring contact's name, phone, and email, directly from the site's own JSON search API. No login or cookies required.

Use it on the Apify platform to get structured Polish labour-market data via API, schedule recurring scrapes, and integrate with tools like Zapier, Make, Google Sheets, and Slack.

### How to scrape Poland CBOP job listings

1. Go to the CBOP Poland Scraper on the Apify Store.
2. Click **Try for free** to open the actor in the Apify Console.
3. Enter a Polish-language job keyword (e.g. "kucharz", "kierowca", "magazynier") or leave it empty to browse all current active vacancies nationwide.
4. Set the maximum number of results you want.
5. Click **Start** and wait for the run to finish.
6. Download your data as JSON, CSV, Excel, or HTML from the Output tab.

### Why use CBOP Poland Scraper?

- **Recruitment and hiring** — Monitor vacancies registered with Poland's public employment service to understand hiring trends by voivodeship, sector, and occupation.
- **Salary research** — Benchmark salaries employers report to the labour office, by city, voivodeship, and role.
- **Labor market analysis** — Track which occupations and regions have the most open positions, and which employers are hiring most actively across all 16 voivodeships.
- **Lead generation** — Every vacancy includes the employer's name and address plus, when disclosed, a direct hiring-contact name, phone, and email — a clean data set for B2B/recruitment outreach.
- **National coverage in one call** — CBOP is the single centralized feed behind every regional PUP office's own listings, so one actor covers all of Poland instead of scraping dozens of separate regional sites.
- **Academic and public-policy research** — Gather structured Polish labour-market data straight from the official employment service registry.

### Input

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `searchQuery` | String | No | Polish-language job keyword (e.g. "kucharz", "kierowca", "magazynier"). Matched against the vacancy's job-title field. Leave empty to browse all current active vacancies. |
| `maxResults` | Integer | No | Maximum number of job vacancies to scrape (default: 100, max: 20000). |
| `proxyConfiguration` | Object | No | Proxy settings. oferty.praca.gov.pl's job API has no anti-bot protection and isn't geo-locked, so Apify's automatic/free proxy pool works fine — no residential proxy needed. |

### Output

Each result contains structured data about a single job vacancy. You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

#### Example output

```json
{
    "id": "299c057e66d7815c1239cae087fae28d",
    "title": "kucharz/kucharka",
    "offerType": "OFERTA_PRACY",
    "company": "Makary Catering",
    "companyAddress": "Toruń, kujawsko-pomorskie",
    "city": "Toruń",
    "voivodeship": "kujawsko-pomorskie",
    "fullLocation": "Toruń, kujawsko-pomorskie",
    "latitude": 53.0189494,
    "longitude": 18.6349207,
    "contractType": "Umowa zlecenie / Umowa o świadczenie usług",
    "employmentDimension": "nie dotyczy",
    "employmentCategory": null,
    "salaryText": "od 7 950 do 9 000 PLN wynagrodzenie 6000- 7000 zł netto",
    "salaryFrom": 7950,
    "salaryTo": 9000,
    "currency": "PLN",
    "requirements": "wykształcenie - gastronomiczne zasadnicze zawodowe\nzawód - Kucharz*\nkonieczne min. 4-letnie doświadczenie",
    "responsibilities": "przygotowywanie posiłków oraz przygotowywanie wyrobów garmażeryjnych - kuchnia polska",
    "postedDate": "2026-08-10T00:00:00.000Z",
    "validFrom": "2026-08-10T00:00:00.000Z",
    "validTo": "2026-11-07T00:00:00.000Z",
    "startDate": "2026-08-10T00:00:00.000Z",
    "applicationMethodCode": "P",
    "contactName": "Marian Zelazkiewicz",
    "contactPhone": "508325491",
    "contactEmail": null,
    "office": "Powiatowy Urząd Pracy dla Miasta Torunia",
    "addedBy": "PUP",
    "forDisabled": false,
    "positionsForDisabled": 0,
    "registeredUnemployedOnly": false,
    "url": "https://oferty.praca.gov.pl/portal/lista-ofert/szczegoly-oferty/299c057e66d7815c1239cae087fae28d",
    "scrapedAt": "2026-08-10T09:11:50.375Z"
}
```

### Data fields

| Field | Type | Description |
|-------|------|-------------|
| `id` | String | CBOP internal offer identifier |
| `title` | String | Job title / position name as registered by the employer |
| `offerType` | String | Type of proposal, e.g. OFERTA\_PRACY (job offer) or STAZ\_UP (internship) |
| `company` | String | Employer name |
| `companyAddress` | String | Employer's registered city and voivodeship |
| `city` | String | City where the job is located |
| `voivodeship` | String | Polish administrative region (województwo) where the job is located |
| `fullLocation` | String | Raw location string as shown on the site |
| `latitude` / `longitude` | Number | Workplace coordinates, when disclosed |
| `contractType` | String | Type of employment contract offered |
| `employmentDimension` | String | Full-time-equivalent dimension of the role as registered |
| `employmentCategory` | String | Employment category label, e.g. "praca stała" (permanent) |
| `salaryText` | String | Raw salary field as published, which may include free-text benefits alongside the figure |
| `salaryFrom` / `salaryTo` | Number | Salary figures parsed from `salaryText` when it starts with an unambiguous PLN amount |
| `currency` | String | Always "PLN" |
| `requirements` | String | Candidate requirements (education, skills, experience) as free text |
| `responsibilities` | String | Job responsibilities / scope of duties as free text |
| `postedDate` | String | ISO 8601 date the vacancy was registered with CBOP |
| `validFrom` / `validTo` | String | ISO 8601 dates the listing is active |
| `startDate` | String | ISO 8601 expected job start date, when disclosed |
| `applicationMethodCode` | String | Raw site code for how to apply, as published (not translated) |
| `contactName` / `contactPhone` / `contactEmail` | String | Hiring contact details, when disclosed |
| `office` | String | Regional labour office (PUP/WUP) handling this vacancy |
| `addedBy` | String | Entity that submitted the offer: PUP, OHP, or WUP |
| `forDisabled` | Boolean | Whether the vacancy is flagged as suitable for candidates with disabilities |
| `positionsForDisabled` | Integer | Number of open positions reserved for candidates with disabilities |
| `registeredUnemployedOnly` | Boolean | Whether the vacancy is restricted to candidates registered as unemployed |
| `url` | String | Direct URL to the vacancy detail page on oferty.praca.gov.pl |
| `scrapedAt` | String | ISO 8601 timestamp of when the data was collected |

### Cost estimate

This actor calls oferty.praca.gov.pl's own JSON search API directly rather than rendering pages in a browser, and every field — including salary, requirements, and contact details — comes back in a single request per page of results, with no per-job detail fetch needed. That makes it very cheap to run: roughly **0.1–0.2 compute units per 1,000 results**, well under $0.10 per 1,000 job vacancies at standard Apify pricing. As with any Apify actor, the run's usage cost only settles once the run reports SUCCEEDED — reading a mid-run/in-progress dataset understates the eventual cost.

### Tips

- Use specific job keywords to get more relevant results and reduce run time.
- Leave `searchQuery` empty to pull the newest vacancies across all of Poland.
- CBOP aggregates every regional PUP office plus OHP and WUP submissions, so one run already covers the whole country — no need to scrape voivodeship by voivodeship.
- Schedule recurring runs to track new vacancies daily or weekly.

### Limitations

- Salary is published as free text by each employer, not a structured number — `salaryFrom`/`salaryTo` are parsed only when the text starts with an unambiguous "od X \[do Y] PLN" pattern; anything more free-form is left null in those two fields (the raw text is always kept in `salaryText`).
- Contact email/phone are only populated when the employer discloses them — a large share of postings only give a phone number, and some give neither.
- Workplace coordinates (`latitude`/`longitude`) are only present for a subset of listings.
- Data is scraped from the public oferty.praca.gov.pl website and may change without notice.

### Integrations

Connect CBOP Poland Scraper with your existing tools and workflows:

- **Google Sheets** — Export vacancies directly to a spreadsheet for easy filtering and sharing.
- **Slack** — Get notified when new vacancies matching your criteria appear.
- **Zapier / Make** — Build workflows that react to new job postings in real time.
- **Custom API** — Access all results programmatically via the Apify API in JSON format.

### FAQ and support

**Is it legal to scrape oferty.praca.gov.pl?** Scraping publicly available data is generally permitted under EU law. This actor only accesses public job vacancies that require no login, via the same API the public search page uses.

**How often is the data updated?** The actor scrapes live data from oferty.praca.gov.pl each time it runs. Schedule it daily or weekly to track changes.

**I found a bug or have a feature request.** Open an issue in the Issues tab on the actor page. You can also request a custom scraping solution.

### Need this data on a schedule, or a custom version?

We run this scraper as a managed service for businesses: scheduled runs,
deduplication, delta detection, and delivery to your inbox, Google Sheets,
or API — maintenance included. We can also build a custom version with your
exact fields and filters, or combine multiple sources into one feed.

See [studioamba.dev/services](https://studioamba.dev/services/) or email
<hello@studioamba.dev> for a free data sample.
We maintain 300+ European web scrapers and answer within one business day.

# Actor input Schema

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

Occupation/job keyword in Polish (e.g. 'kucharz', 'kierowca', 'magazynier'). Matched against the vacancy's job-title field. Leave empty to browse all current active vacancies nationwide.

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

Maximum number of job vacancies to scrape.

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

Proxy settings. oferty.praca.gov.pl's job API has no anti-bot protection and is not geo-locked, so Apify's automatic/free proxy pool works fine — no residential proxy needed. See docs/site-recon/oferty-praca-gov-pl.md.

## Actor input object example

```json
{
  "searchQuery": "kucharz",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQuery": "kucharz",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/cbop-poland-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQuery": "kucharz",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/cbop-poland-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQuery": "kucharz",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call studio-amba/cbop-poland-scraper --silent --output-dataset

```

## MCP server setup

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