Jobs.cz Scraper

Scrape Jobs.cz — one of the largest Czech job boards, used by thousands of employers across the Czech Republic. Search by keyword, browse all open positions in a region/city, browse by profession/category, or browse jobs.cz's separate part-time/temp-gig board ("brigády") — with salary (Kč), date-posted, employment-type, education, language, home-office and other filters. HTTP-only via the public jobs.cz search pages. No auth, no proxy required.

What this actor does

• Four modes: search (keyword), byLocation (region/city browse), byCategory (profession browse), brigady (part-time / temp / student gigs — a separate board on jobs.cz with its own listings)
• Rich filters: minimum salary (Kč), posted-within window, employment type (incl. internships/trainee programs), contract type, education level, required languages, home-office arrangement, suitable-for group, employer type (direct/agency/NGO), minimum hourly rate (mode=brigady), search radius in km around a location (every mode, incl. brigady)
• Combinable axes: narrow a keyword search or a category browse to a specific city; narrow a city browse to a specific profession; narrow a brigády browse to a keyword and/or city
• Bonus fields: salary range parsed into numeric min/max, posted date normalized to ISO where derivable, employer Atmoskop rating link, home-office/response-time tags
• Empty fields are omitted

Output per job

• jobId — jobs.cz internal ad ID
• title — job title
• company — employer name
• location — city/district as shown on the listing
• salaryText — raw salary label as displayed (e.g. "70 000 – 85 000 Kč")
• salaryMinCzk, salaryMaxCzk — parsed numeric salary bounds in Czech crowns (equal when only one figure is shown)
• salaryPeriod — monthly or hourly
• postedDateText — raw status label as shown (e.g. "13. srpna", "Přidáno dnes", "Končí za 3 dny")
• postedDate — ISO YYYY-MM-DD posting date, only included when confidently derivable from postedDateText (absolute dates and "today/yesterday/X minutes|hours ago" labels; deadline labels like "Ends in 3 days" don't imply a posting date and are omitted)
• badge — promotional/status badge when present (e.g. "Příležitost dne" = Opportunity of the day, "Nové" = New)
• tags[] — additional listing tags (e.g. home-office note, response-time note)
• companyLogoUrl — employer logo image
• atmoskopRating — employer rating summary from Atmoskop.cz (e.g. "65 hodnocení na Atmoskopu")
• atmoskopUrl — link to the employer's Atmoskop.cz review page
• url — canonical apply/detail URL on jobs.cz
• recordType: "job", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / byLocation / byCategory / brigady
searchQuery	string	python	Free-text keyword (mode=search, required; mode=brigady, optional)
location	select	–	Curated list of 30 major Czech cities/regions
locationSlugCustom	string	–	Free-text jobs.cz city slug override, for cities not in the dropdown. Not supported in mode=brigady
category	select	–	Curated list of 25 common professions/categories. Not supported in mode=brigady
categorySlugCustom	string	–	Free-text jobs.cz profession slug override. Not supported in mode=brigady
salaryMinCzk	int	0	Minimum gross monthly salary in Kč (0–200 000). mode=search/byLocation/byCategory only
hourlyRateMin	select	any	any / 100 / 200 / 300 / 400 / 500 (Kč/h). mode=brigady only
radiusKm	select	(jobs.cz default)	0 / 10 / 20 / 30 / 40 / 50 km around location/locationSlugCustom. Only has an effect when a location is set (any mode, incl. brigady)
datePosted	select	any	any / 24h / 3d / 7d. Works in every mode
employmentTypes	array	–	full, part, internships. mode=search/byLocation/byCategory only
contractTypes	array	–	employment_contract, identification_number, agreement. mode=search/byLocation/byCategory only
education	select	any	any / primary / high / uni. mode=search/byLocation/byCategory only
languageSkills	array	–	Required languages (cs, en, de, fr, ru, pl, it, es). mode=search/byLocation/byCategory only
homeOffice	select	any	any / partial-work-from-home / work-mostly-from-home / flexible-hours. mode=search/byLocation/byCategory only
suitableFor	select	any	any / graduates / retired / maternity / disabled / ukraine_refugees. mode=search/byLocation/byCategory only
employerType	select	any	any / direct / agency / ngo. mode=search/byLocation/byCategory only
maxItems	int	30	Hard cap on emitted records (1–500)

Example: keyword search narrowed to a city

{
  "mode": "search",
  "searchQuery": "python",
  "location": "praha",
  "maxItems": 50
}

Example: browse all jobs in a region

{
  "mode": "byLocation",
  "location": "brno",
  "datePosted": "7d",
  "maxItems": 100
}

Example: browse a profession with a salary floor

{
  "mode": "byCategory",
  "category": "programator",
  "salaryMinCzk": 60000,
  "employmentTypes": ["full"],
  "maxItems": 50
}

Example: browse part-time/temp gigs (brigády) in a city with a minimum hourly rate

{
  "mode": "brigady",
  "location": "praha",
  "hourlyRateMin": "200",
  "datePosted": "7d",
  "maxItems": 50
}

Use cases

• Salary benchmarking — track advertised Kč ranges by profession or region across the Czech job market
• Labor-market research — measure job volume by category/city over time
• Recruitment intelligence — monitor competitor job postings and hiring velocity
• HR tech / job aggregators — feed structured Czech job listings into a meta-search product
• Relocation/expat services — surface English-language-friendly roles by city

FAQ

What is the data source, and how fresh is it? This actor reads the public search-results pages of jobs.cz, a leading Czech job board (part of the LMC group, which also operates Prace.cz). Each run fetches live listings at request time — there's no caching layer. It is an independent, third-party scraper and is not affiliated with or endorsed by jobs.cz or LMC.

Why do some jobs have no salary fields? Many employers don't disclose salary. salaryText/salaryMinCzk/salaryMaxCzk are only included when the listing displays a figure — no fabricated values are ever emitted. This also applies when you set the salaryMinCzk input filter: jobs.cz matches that filter against each ad's internal salary data even when the figure isn't publicly displayed, so a filtered run can still return jobs with no visible salary fields — the filter does not exclude non-disclosing ads.

Why does a mode=search keyword result occasionally include an off-topic job? jobs.cz always shows one promoted "Opportunity of the day" ad as the very first search-result card, regardless of how well it matches your searchQuery — this is dropped automatically from keyword searches. Beyond that, jobs.cz's own free-text relevance ranking can still surface loosely-related results for broad single-word queries; narrowing with location, category, or more specific keywords improves precision.

Why do some jobs have no postedDate? jobs.cz shows some listings with a countdown label ("Ends in 3 days") instead of a posting date, and some with a promotional badge ("Opportunity of the day") instead of either. Those don't imply a reliable posting date, so postedDate is omitted for them — postedDateText still shows the raw label.

Can I combine a keyword search with a category browse? No — jobs.cz's own category-browse pages (mode=byCategory) don't apply a free-text keyword filter, so combining them would silently return unfiltered category results. Use mode=search with location to narrow a keyword search by city, or mode=byCategory with location to narrow a profession browse by city — both of those combinations work.

Why do location/byLocation results for smaller cities include jobs in other cities or "Česká republika" (nationwide)? This mirrors jobs.cz's own behavior for the same city page. For less job-dense cities, jobs.cz's own matching widens beyond the literal city and mixes in nationwide/remote-eligible postings as recommended matches — the location value is sent to jobs.cz exactly as clicking that city in a browser would. Larger cities (Praha, Brno, Ostrava) rarely show this because they have enough genuinely local postings to fill the page on their own.

Can I look up a city or profession that isn't in the dropdown? Yes — use locationSlugCustom or categorySlugCustom with the exact jobs.cz URL slug for that city/profession (lowercase, no diacritics, hyphens for spaces). This only applies to search/byLocation/byCategory — mode=brigady only supports the curated location dropdown (see below).

What is mode=brigady, and why does it only support the curated location list? Jobs.cz runs a separate board at jobs.cz/brigady/ for part-time, temporary, student and seasonal gigs (retail shifts, warehouse work, event staffing, etc.) — distinct from its main full-time job listings, with its own filters (posted-within window, minimum hourly rate) and its own city-matching mechanism that only recognizes a fixed set of cities rather than arbitrary URL slugs, so locationSlugCustom isn't supported there. Every other main-board filter (salaryMinCzk, employmentTypes, contractTypes, education, languageSkills, homeOffice, suitableFor, employerType, category) has no effect on mode=brigady and is ignored.

What does radiusKm do, and why only 6 fixed values? jobs.cz widens or narrows how far from location/locationSlugCustom it looks for matches — 50 km by default, or a per-city default (10-50 km) on the brigády board. jobs.cz's own UI offers exactly these 6 fixed radius steps (0/10/20/30/40/50 km) rather than a free numeric range, so this actor mirrors that. It only has an effect when a location is set.

Is a proxy or login required? No. The actor works with the default Apify datacenter proxy settings and needs no cookies or account credentials.