OLX.pl Jobs Scraper

Extract job listings from OLX.pl — Poland's largest classifieds platform — including salary, contract type, workplace mode, and full job descriptions. No account required.

---

Features

• Nationwide or per-region search across all 16 Polish voivodeships
• Keyword filtering to target specific roles, industries, or skills
• Salary data — minimum, maximum, currency (PLN), period (monthly/hourly), and gross/net flag
• Contract & work type — employment contract, civil-law contract, self-employment, full-time, part-time
• Workplace mode — remote, hybrid, or on-site
• Full job descriptions in HTML, plain text, and Markdown
• Date filtering via daysOld to power daily-feed pipelines
• Cross-run deduplication with a 90-day cache to skip previously seen listings
• Start URLs support for targeted category or search pages

---

Input

Parameter	Type	Default	Description
query	string	""	Keyword(s) to search for, e.g. programista, kierowca, sprzedawca
region	select	all	Polish voivodeship to filter by, or all for nationwide
maxItems	integer	200	Maximum results to return (1–1,000)
daysOld	integer	—	Only return jobs posted within this many days
skipReposts	boolean	false	Skip listings already seen in previous runs
startUrls	array	[]	Specific OLX.pl job search URLs to scrape

Available regions

dolnoslaskie · kujawsko-pomorskie · lubelskie · lubuskie · lodzkie · malopolskie · mazowieckie · opolskie · podkarpackie · podlaskie · pomorskie · slaskie · swietokrzyskie · warminsko-mazurskie · wielkopolskie · zachodniopomorskie

---

Output

Each result is saved to the default dataset. Results are sorted newest-first.

Always present

Field	Type	Description
id	string	Unique OLX offer identifier
url	string	Direct link to the job listing
title	string	Job title as posted
descriptionHtml	string|null	Full description in raw HTML
descriptionText	string|null	Full description as plain text
descriptionMarkdown	string|null	Full description in Markdown
publishDate	string	Date posted — YYYY-MM-DD, Warsaw timezone
publishDateISO	string	ISO 8601 timestamp of original posting
lastRefreshDate	string	Date of last refresh — YYYY-MM-DD
lastRefreshDateISO	string	ISO 8601 timestamp of last refresh
salaryMin	number|null	Minimum salary amount (gross unless salaryGross is false)
salaryMax	number|null	Maximum salary amount
salaryCurrency	string|null	Currency code, typically PLN
salaryPeriod	string|null	Pay period: MONTH, HOUR, DAY, WEEK, YEAR
salaryGross	boolean|null	true = gross; false = net
contractType	string|null	Contract type label (may be comma-separated for multiple)
workType	string|null	Pełny etat (full-time) or Część etatu (part-time)
workplaceType	string|null	Workplace mode label, e.g. Praca zdalna
availability	string|null	Availability label, e.g. Elastyczny czas pracy
city	string|null	City name
region	string|null	Polish voivodeship name
companyName	string|null	Employer company name (business accounts only)
isBusiness	boolean	true if posted by a business account
summary	string|null	First 300 characters of plain-text description
source	string	Always olx.pl
scrapedAt	string	ISO 8601 timestamp of when this item was scraped
contentHash	string	16-character MD5 fingerprint for change detection
isRepost	boolean	true if this listing was seen in a previous run
originalPublishDate	string|null	ISO timestamp from the first time this listing was seen
originalUrl	string|null	URL from the first time this listing was seen

Example output

{
  "id": "1068495670",
  "url": "https://www.olx.pl/oferta/praca/wewnetrzny-automation-specialist-CID4-ID1ajix8.html",
  "title": "Automation Specialist / Wdrożeniowiec No-code",
  "descriptionHtml": "<p><strong>O firmie</strong></p><p>Sieć klinik stomatologicznych...</p>",
  "descriptionText": "O firmie Sieć klinik stomatologicznych. Realizujemy autorską strategię...",
  "descriptionMarkdown": "## O firmie\n\nSieć klinik stomatologicznych...",
  "publishDate": "2026-04-21",
  "publishDateISO": "2026-04-21T16:00:41+02:00",
  "lastRefreshDate": "2026-04-24",
  "lastRefreshDateISO": "2026-04-24T16:02:24+02:00",
  "salaryMin": 7000,
  "salaryMax": 9000,
  "salaryCurrency": "PLN",
  "salaryPeriod": "MONTH",
  "salaryGross": true,
  "contractType": "Umowa o pracę, Samozatrudnienie",
  "workType": "Pełny etat",
  "workplaceType": "Praca hybrydowa, W siedzibie firmy",
  "availability": "Elastyczny czas pracy",
  "city": "Kalisz",
  "region": "Wielkopolskie",
  "companyName": null,
  "isBusiness": true,
  "summary": "O firmie Sieć klinik stomatologicznych. Realizujemy autorską strategię cyfryzacji...",
  "source": "olx.pl",
  "scrapedAt": "2026-04-24T17:30:00.000Z",
  "contentHash": "a1b2c3d4e5f60001",
  "isRepost": false,
  "originalPublishDate": null,
  "originalUrl": null
}

---

Usage examples

1 — Search for IT jobs in Mazowieckie

{
  "query": "programista",
  "region": "mazowieckie",
  "maxItems": 500
}

2 — Daily new jobs nationwide (last 24 hours)

{
  "query": "",
  "region": "all",
  "maxItems": 1000,
  "daysOld": 1,
  "skipReposts": true
}

3 — Scrape a specific search URL

{
  "startUrls": [
    { "url": "https://www.olx.pl/praca/q-kierowca/" }
  ],
  "maxItems": 200
}

4 — Driver jobs in Śląskie, deduplicated daily feed

{
  "query": "kierowca",
  "region": "slaskie",
  "maxItems": 300,
  "daysOld": 7,
  "skipReposts": true
}

---

Performance & pricing

• Typical speed: 50 listings per request, ~1–2 requests per second
• No proxy required — uses OLX.pl's public API, explicitly allowed in robots.txt
• Pricing: $1.49 per 1,000 results

---

Notes

• The OLX.pl API exposes a maximum of 1,000 results per search query. For broader coverage, combine multiple queries (different keywords or regions).
• Salary data is only present when the employer chooses to display it (approximately 30–40% of listings).
• Results are sorted newest-first by default.