By the end of this tutorial you will have a Python script that pulls job listings from jobs.cz, the Czech job board, into structured rows: job title, employer, location, the salary range when the listing shows one, the posting date text and the tags.
Jobs.cz Scraper (reventadata/jobs-cz-scraper) is the Apify Actor built for this site. You give it a keyword, such as python, and it returns one row per job. This guide calls it from Python with the Apify client. The sample rows below are copied from a real run of 17 November 2026 that searched python and collected 10 rows, not from an invented example.
The Actor is not affiliated with Jobs.cz or Alma Career. It reads the public search pages of www.jobs.cz, without logging in.
Prerequisites
You need three things:
- Python 3, with the Apify client installed.
- A free Apify account.
- Your Apify API token, from your Apify account.
Install the client and export the token:
pip install -U "apify-client~=3.0"
export APIFY_API_TOKEN="your_apify_token_here"
No scraping code is needed on your side. The Actor reads the public search pages for you, and it needs no browser.
What you'll achieve
You will search jobs.cz for python, read the rows in Python and print two lines per job. The first line holds the title, employer, location and salary. The second holds the posting date text and the tags. The first line is the one to scan: the employer, the place and the salary sit together.
Each row has 19 fields, so you can also sort the results by employer or location afterwards. The output is plain text, one job per pair of lines, so it reads well in a terminal and pastes cleanly into a spreadsheet. To search for a different keyword, change one value in the script and nothing else.
Step 1: Open Jobs.cz Scraper
Open the Jobs.cz Scraper page on Apify Store. This tutorial calls the Actor from Python, so the name reventadata/jobs-cz-scraper is all you need from that page.
Step 2: Choose the search
The search is described by four input fields:
-
searchQueries: a list of keywords, one search each. Required. A keyword repeated in the list is searched once. -
maxItems: the most jobs to collect in total, across all keywords. Left unset, it defaults to 100. -
maxPages: the result pages to read per keyword, from 1 to 45. Each page holds 30 jobs. Left unset, it defaults to 45. -
fetchDetails: when on, the Actor also opens each job's own page and adds the description and the position details. It is off by default, and it makes the run slower.
The site serves at most 45 pages, or 1,350 jobs, for one search. For more jobs, use several narrower keywords.
The run behind this guide used this input. The other input keeps its default.
{
"searchQueries": ["python"],
"maxItems": 10,
"maxPages": 1,
"fetchDetails": false
}
Step 3: Run it from Python
This script starts the Actor, waits for it, reads the dataset and prints two lines per job:
import os
from apify_client import ApifyClient
# 1. Initialise the client with your token from the environment
client = ApifyClient(os.environ["APIFY_API_TOKEN"])
# 2. Describe the search: Python jobs, 10 rows from one results page
run_input = {
"searchQueries": ["python"],
"maxItems": 10,
"maxPages": 1,
"fetchDetails": False,
}
# 3. Start the Actor and wait for it to finish
run = client.actor("reventadata/jobs-cz-scraper").call(run_input=run_input)
if run is None or run.status != "SUCCEEDED":
status = run.status if run else "unknown"
raise SystemExit(f"Run did not succeed (status: {status}).")
# 4. Read the rows from the run's default dataset
items = client.dataset(run.default_dataset_id).list_items().items
print(f"Retrieved {len(items)} jobs.\n")
# 5. Print two lines per job
for item in items:
if item.get("salaryMin") is None:
salary = "no salary shown"
else:
salary = f"{item['salaryMin']} to {item['salaryMax']} {item['salaryCurrency']}"
print(f"{item['title']} at {item['company']}, {item['location']} | {salary}")
print(f" posted: {item['postedText']}, tags: {', '.join(item['tags'] or [])}")
The run_input is the same input as above. Change the keyword in searchQueries to search for something else.
Step 4: Read the output
The loop prints two lines per job. This is the complete output of the run, 10 jobs:
Retrieved 10 jobs.
Embedded Software Developer – Python/Linux at Thermo Fisher Scientific, Brno – Černovice | no salary shown
posted: 6. listopadu, tags: Možnost občasné práce z domova
Python Developer – AI aplikace pro mediální dům (Denik.cz) at VLTAVA LABE MEDIA a.s., Praha – Jinonice | no salary shown
posted: Končí zítra, tags: Odpověď do 2 týdnů, Možnost občasné práce z domova
Vývojář/ka softwaru pro výrobu a testování routerů (Python) at Advantech Czech s.r.o., Ústí nad Orlicí – Kerhartice | no salary shown
posted: Aktualizováno dnes, tags: Odpověď do 2 týdnů, Možnost občasné práce z domova
Python Developer - Zkušenost s AI at Agnostix, s.r.o., Praha – Nové Město | 100000 to 160000 CZK
posted: Přidáno včera, tags: Možnost občasné práce z domova
Fullstack vývojář/ka (Python/Django + React/TypeScript) at VertiFlex s.r.o., Ostrava – Poruba | no salary shown
posted: 11. listopadu, tags: Možnost občasné práce z domova
Programátor Seznam Asistenta - Python, ML, LLM at Seznam.cz, a.s., Brno – Starý Lískovec | no salary shown
posted: 2. listopadu, tags: Odpověď do 2 týdnů
Medior Python Developer for Cyber Security (f/m) at T-Mobile Czech Republic a.s., Praha – Chodov | no salary shown
posted: 30. října, tags: Možnost občasné práce z domova
Senior Backend vývojář/ka (Python, C++) - systém Vema at Seyfor, a. s., Brno – Lesná | no salary shown
posted: 14. listopadu, tags: Možnost občasné práce z domova
AI Engineer – Python, generativní AI a agentní systémy at teamIT s.r.o., Praha | no salary shown
posted: 5. listopadu, tags: Možnost občasné práce z domova
Python Developer pro RAG tým AI Asistenta at Seznam.cz, a.s., Ostrava – Vítkovice | no salary shown
posted: 11. listopadu, tags: Odpověď do 2 týdnů, Možnost občasné práce z domova
Salary appears only where the listing shows one. In this run, one of the 10 rows has a salary range, 100 000 – 160 000 Kč, and the script prints it as 100000 to 160000 CZK. The other nine show no salary.
One complete row from the run, verbatim, is the Agnostix row, the one with a salary:
{
"id": "2001498258",
"url": "https://www.jobs.cz/rpd/2001498258/",
"title": "Python Developer - Zkušenost s AI",
"company": "Agnostix, s.r.o.",
"location": "Praha – Nové Město",
"additionalLocations": 0,
"postedText": "Přidáno včera",
"salaryText": "100 000 – 160 000 Kč",
"salaryMin": 100000,
"salaryMax": 160000,
"salaryCurrency": "CZK",
"tags": [
"Možnost občasné práce z domova"
],
"companyLogoUrl": null,
"companyReviewCount": 65,
"description": null,
"detailInfo": null,
"searchQuery": "python",
"searchUrl": "https://www.jobs.cz/prace/?q=python",
"scrapedAt": "2026-11-17T21:56:34+00:00"
}
Understanding your results
Each row has 19 fields. The ones you will use most are these:
-
title,company,location: the job title, the employer name and the place, as the listing shows them.additionalLocationscounts the further places the listing names. -
postedText: the date text as the listing shows it, in Czech. It is not converted to a date. -
salaryMin,salaryMax,salaryCurrency: the salary range as whole numbers, andCZKwhen a range was read. -
tags: the other tags on the listing, in Czech. -
description,detailInfo: the description and the position details, empty unlessfetchDetailsis on. -
searchQuery,searchUrl,scrapedAt: the keyword, the first results page of its search, and the time the row was read.
In this run:
-
descriptionanddetailInfoare empty on all 10 rows. This run hadfetchDetailsset to false. - A salary range appears on one row. The other nine show none.
-
companyLogoUrlis empty on four rows, andcompanyReviewCounton five. - Three rows carry a relative posting text:
Končí zítra(ends tomorrow),Přidáno včera(added yesterday) andAktualizováno dnes(updated today). The other seven show a day and month.
Pro tips
-
Use several narrower keywords. One search covers at most 1,350 jobs. A list such as
["python", "python developer"]gives two searches, and a job found by both is kept once. -
Keep
maxPagessmall while you test. The run above usedmaxPages1, andmaxItems10 ended it at 10 rows. -
Turn on
fetchDetailsonly when you need descriptions. It reads one more page per job, so the run takes longer. - Keep the currency as it is. The Actor returns the salary range in CZK and does not convert it. Convert it yourself if you need another currency.
- Expect repeats to be dropped. A job found by two keywords, or twice in one search, is saved once. The Actor skips a repeat by job id.
-
Read the status before the rows. A run that ends
FAILEDmay have missed matches, so check its status message before you trust a short list.
Troubleshooting
- Zero rows, status SUCCEEDED. The site answered and no job matched. The status message says so, and suggests trying broader keywords.
-
Zero rows, status FAILED. Either the input cannot be used, for example a
maxPagesvalue outside 1 to 45, or the site refused the run, or a page could not be read, so matches may have been missed. The status message says which. - Some rows, then a stop. If the run reaches its time limit, it keeps the rows already saved and logs a warning.
-
Fewer rows than
maxItems. The search had fewer jobs, or a page could not be read. A page that fails ends that keyword's search, and the next keyword still runs. -
Empty
descriptionon some rows withfetchDetailson. Some employers use their own job page layout. Those rows keep their listing data, anddescriptionstays empty.
Next steps
To repeat a search, save it as an Apify task and add a schedule to that task. The rows can be exported as JSON, CSV or Excel.
For current pricing and details, see the Store page.
Which keyword will you search on jobs.cz? Drop a comment below.
About the author: reventadata builds and publishes data extraction Actors on the Apify Store.
Top comments (0)