{ "openapi": "3.0.1", "info": { "title": "Jobs.cz Scraper: Czech Jobs, Salaries & Companies", "description": "Scrape Jobs.cz jobs with salary, region, district, seniority and the ad's requirements and benefits, using the website's own filters. Track new, removed and re-posted jobs, get a free salary summary and optional ARES company data. Recruiter contacts only if you turn them on. Unofficial.", "version": "0.0", "x-build-id": "ZFe32hmVbFRvRHTrB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tsutseisoftware~jobs-cz-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tsutseisoftware-jobs-cz-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/tsutseisoftware~jobs-cz-scraper/runs": { "post": { "operationId": "runs-sync-tsutseisoftware-jobs-cz-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/tsutseisoftware~jobs-cz-scraper/run-sync": { "post": { "operationId": "run-sync-tsutseisoftware-jobs-cz-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "startUrls": { "title": "Jobs.cz URLs", "type": "array", "description": "Search or listing URLs from Jobs.cz, e.g. https://www.jobs.cz/prace/brno/?q[]=python (set the search and filters on the website and paste the URL; www.jobs.cz and beta.jobs.cz both work), or job URLs, e.g. https://www.jobs.cz/rpd// or https://beta.jobs.cz/nabidka//. Website filters below are added to these URLs too, unless the URL already sets them. Prace.cz URLs are not accepted (use Prace.cz Scraper).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Keywords to search for, e.g. 'python', 'skladník', 'účetní'. Each query is a separate search (combined with Location and the website filters). At most 20.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "One city or region as in the website URL, e.g. 'praha', 'brno', 'ostrava', 'jihomoravsky-kraj', 'stredocesky-kraj', 'zahranici' (abroad). Czech names work too ('Jihomoravský kraj'). Used for Search queries, Categories and website filters, not for Jobs.cz URLs. For several places use Locations." }, "locations": { "title": "Locations", "type": "array", "description": "Several cities or regions, one search each (e.g. 'praha', 'brno', 'ostrava'), at most 20. Same format as Location; both can be used together. Not used for Jobs.cz URLs.", "items": { "type": "string" } }, "radiusKm": { "title": "Radius (km)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Also jobs up to this many km around each Location, like '+ okolí 20 km' on the website. Example: Location 'brno' with Radius 20 = 'Brno-město a okolí' (about 2 200 jobs instead of 1 800). The website offers 10, 20, 30, 40 and 50 km; any whole number up to 100 works. 0 = only the place itself (as before). Needs a Location (city, district or part of Prague); regions and 'zahranici' have no radius and are searched as they are. Costs one extra page request per location. A radius search is never split region by region, so above 9 990 jobs use a smaller radius or more filters. Jobs.cz URLs keep their own radius.", "default": 0 }, "regions": { "title": "Regions", "type": "array", "description": "Only jobs in these regions (kraj). Without a Location and without Jobs.cz URLs, the actor runs one search per region on the website, so you pay and wait only for those jobs. Otherwise it checks the region of each job's place of work and skips jobs it can't place (e.g. \"Česko\" for the whole country).", "items": { "type": "string", "enum": [ "praha", "stredocesky-kraj", "jihocesky-kraj", "plzensky-kraj", "karlovarsky-kraj", "ustecky-kraj", "liberecky-kraj", "kralovehradecky-kraj", "pardubicky-kraj", "kraj-vysocina", "jihomoravsky-kraj", "olomoucky-kraj", "zlinsky-kraj", "moravskoslezsky-kraj" ], "enumTitles": [ "Prague (Hlavní město Praha)", "Central Bohemia (Středočeský kraj)", "South Bohemia (Jihočeský kraj)", "Plzeň (Plzeňský kraj)", "Karlovy Vary (Karlovarský kraj)", "Ústí nad Labem (Ústecký kraj)", "Liberec (Liberecký kraj)", "Hradec Králové (Královéhradecký kraj)", "Pardubice (Pardubický kraj)", "Vysočina (Kraj Vysočina)", "South Moravia (Jihomoravský kraj)", "Olomouc (Olomoucký kraj)", "Zlín (Zlínský kraj)", "Moravia-Silesia (Moravskoslezský kraj)" ] } }, "categories": { "title": "Categories", "type": "array", "description": "Only jobs in these categories (obor), as listed on the website. Without Jobs.cz URLs the actor runs one search per category on the website (combined with Location or Regions and Search queries), so you pay only for those jobs. With Jobs.cz URLs it checks the categories of each job.", "items": { "type": "string", "enum": [ "Administrativa", "Auto - moto", "Bankovnictví a finanční služby", "Cestovní ruch a ubytování", "Doprava, logistika a zásobování", "Ekonomika a podnikové finance", "Elektrotechnika a energetika", "Farmacie", "Gastronomie a pohostinství", "IS/IT: Konzultace, analýzy a projektové řízení", "IS/IT: Správa systémů a HW", "IS/IT: Vývoj aplikací a systémů", "Kultura, umění a tvůrčí práce", "Kvalita a kontrola jakosti", "Marketing", "Média, reklama a PR", "Nákup", "Ostraha a bezpečnost", "Personalistika a HR", "Pojišťovnictví", "Potravinářství", "Prodej a obchod", "Právní služby", "Řemeslné a manuální práce", "Služby", "Stavebnictví a reality", "Strojírenství", "Státní a veřejná správa", "Technika a vývoj", "Telekomunikace", "Věda a výzkum", "Vrcholový management", "Výroba a průmysl", "Vzdělávání a školství", "Zákaznický servis", "Zdravotnictví a sociální péče", "Zemědělství, lesnictví a ekologie" ], "enumTitles": [ "Administrativa (Administration)", "Auto - moto (Automotive)", "Bankovnictví a finanční služby (Banking & financial services)", "Cestovní ruch a ubytování (Tourism & accommodation)", "Doprava, logistika a zásobování (Transport, logistics & supply)", "Ekonomika a podnikové finance (Economics & corporate finance)", "Elektrotechnika a energetika (Electrical engineering & energy)", "Farmacie (Pharmacy)", "Gastronomie a pohostinství (Gastronomy & hospitality)", "IS/IT: Konzultace, analýzy a projektové řízení (IT: consulting, analysis & project management)", "IS/IT: Správa systémů a HW (IT: system administration & hardware)", "IS/IT: Vývoj aplikací a systémů (IT: software development)", "Kultura, umění a tvůrčí práce (Culture, arts & creative work)", "Kvalita a kontrola jakosti (Quality control)", "Marketing", "Média, reklama a PR (Media, advertising & PR)", "Nákup (Purchasing)", "Ostraha a bezpečnost (Security)", "Personalistika a HR (HR)", "Pojišťovnictví (Insurance)", "Potravinářství (Food industry)", "Prodej a obchod (Sales & trade)", "Právní služby (Legal services)", "Řemeslné a manuální práce (Crafts & manual work)", "Služby (Services)", "Stavebnictví a reality (Construction & real estate)", "Strojírenství (Mechanical engineering)", "Státní a veřejná správa (Public administration)", "Technika a vývoj (Engineering & R&D)", "Telekomunikace (Telecommunications)", "Věda a výzkum (Science & research)", "Vrcholový management (Top management)", "Výroba a průmysl (Manufacturing & industry)", "Vzdělávání a školství (Education)", "Zákaznický servis (Customer service)", "Zdravotnictví a sociální péče (Healthcare & social care)", "Zemědělství, lesnictví a ekologie (Agriculture, forestry & ecology)" ] } }, "maxItems": { "title": "Max jobs", "minimum": 0, "type": "integer", "description": "Maximum number of jobs saved. You pay per saved job. 0 = no limit.", "default": 100 }, "maxItemsPerStartUrl": { "title": "Max jobs per search", "minimum": 0, "type": "integer", "description": "Limit for each search query or URL separately, so one large search doesn't use up the whole Max jobs. 0 = no limit.", "default": 0 }, "maxItemsPerCompany": { "title": "Max jobs per company", "minimum": 0, "type": "integer", "description": "At most this many jobs from one employer (by name), so a few big employers or agencies don't fill the results. Jobs without an employer name are not limited. 0 = no limit.", "default": 0 }, "includeDetails": { "title": "Add description and details", "type": "boolean", "description": "Open each job page to add the description (e-mails and phone numbers removed) and its sections (responsibilities, requirements, nice to have, what the employer offers), benefits, required education and languages, contract type, start date, workplace address with GPS and whether the advertiser is an agency. Slower: one extra request per job (2 seconds each). Jobs published on an employer's own career site keep the listing data only.", "default": false }, "descriptionMaxLength": { "title": "Description length limit", "minimum": 0, "type": "integer", "description": "With \"Add description and details\": shorten the description to about this many characters (e.g. 300 for a snippet). 0 = full text.", "default": 0 }, "descriptionFormat": { "title": "Description format", "enum": [ "text", "markdown" ], "type": "string", "description": "With \"Add description and details\": plain text, or Markdown that keeps the ad's headings, bold text and bullet lists (handy for LLMs and notes). E-mails and phone numbers are removed in both.", "default": "text" }, "omitEmptyFields": { "title": "Leave out empty fields", "type": "boolean", "description": "Save each job without its empty fields (null values and empty lists), e.g. without the company data and monitoring fields you didn't ask for. Smaller rows and fewer tokens for AI agents and APIs. Keep it off for CSV or Excel, so that every row has the same columns.", "default": false }, "jobTypes": { "title": "Employment type", "type": "array", "description": "Only these employment types, as in the website's filter. Several values = any of them.", "items": { "type": "string", "enum": [ "fullTime", "partTime", "temporary", "internship" ], "enumTitles": [ "Full-time (plný úvazek)", "Part-time (zkrácený úvazek)", "Temporary / side job (brigáda)", "Internship (stáž)" ] } }, "contractTypes": { "title": "Contract type", "type": "array", "description": "Only these contract types. Several values = any of them.", "items": { "type": "string", "enum": [ "employee", "freelance", "workAgreement" ], "enumTitles": [ "Employment contract (pracovní smlouva)", "Self-employed / ICO (živnost)", "Work agreement DPP/DPČ (dohoda)" ] } }, "education": { "title": "Education", "type": "array", "description": "Only jobs for these education levels, as in the website's filter.", "items": { "type": "string", "enum": [ "elementary", "apprenticeship", "highSchool", "university" ], "enumTitles": [ "Elementary (základní)", "Apprenticeship (vyučení)", "High school with diploma (maturita)", "University (vysokoškolské)" ] } }, "minSalary": { "title": "Salary from (CZK per month)", "minimum": 0, "type": "integer", "description": "Only jobs offering at least this monthly salary, e.g. 40000. The website also matches jobs whose employer hid the salary on the page; such jobs are returned without a salary (combine with \"Only jobs with a salary\" to skip them)." }, "workArrangement": { "title": "Work from home / remote", "type": "array", "description": "Only jobs with this place of work.", "items": { "type": "string", "enum": [ "onsite", "hybrid", "remote" ], "enumTitles": [ "On site (na pracovišti)", "Hybrid (částečně z domova)", "Remote (převážně z domova)" ] } }, "languages": { "title": "Language skills", "type": "array", "description": "Only jobs that ask for one of these languages.", "items": { "type": "string", "enum": [ "cs", "en", "de", "fr", "ru", "pl", "it", "es" ], "enumTitles": [ "Czech", "English", "German", "French", "Russian", "Polish", "Italian", "Spanish" ] } }, "adLanguages": { "title": "Language of the ad", "type": "array", "description": "Only ads written in these languages, e.g. English for jobs in English (the website's \"advert language\" filter).", "items": { "type": "string", "enum": [ "cs", "en", "sk", "de" ], "enumTitles": [ "Czech", "English", "Slovak", "German" ] } }, "suitableFor": { "title": "Suitable for", "type": "array", "description": "Only jobs the employer marked as suitable for these groups.", "items": { "type": "string", "enum": [ "noExperience", "graduates", "seniors", "parentsOnLeave", "disabled", "refugees" ], "enumTitles": [ "No experience needed", "Graduates", "Seniors / pensioners", "Parents on leave", "People with disabilities", "Refugees from Ukraine" ] } }, "employerType": { "title": "Employer type", "enum": [ "any", "directEmployer", "agency" ], "type": "string", "description": "Direct employers only (no recruitment agencies), or agencies only. Sets isAgency in the results.", "default": "any" }, "postedWithinDays": { "title": "Posted in the last N days", "minimum": 0, "type": "integer", "description": "Only jobs posted in the last N days. 1, 3 and 7 days are applied by the website; other values are checked by the actor on the posting date. 0 = any time." }, "postedWithinHours": { "title": "Posted in the last N hours", "minimum": 0, "type": "integer", "description": "Only jobs posted in the last N hours, checked on the exact posting time (e.g. 6 for a run every 6 hours). The website pre-filters the matching day window (24 hours, 3 or 7 days), so older jobs cost nothing. With Posted in the last N days, the shorter window applies. 0 or empty = any time." }, "onlyWithSalary": { "title": "Only jobs with a salary", "type": "boolean", "description": "Skip jobs that don't show a salary on the website.", "default": false }, "districts": { "title": "Districts", "type": "array", "description": "Only jobs in these districts (okres), e.g. 'Brno-venkov', 'Praha-východ', 'Olomouc'. Checked by the actor on the district of each job's place of work (Prague is 'Praha'); combine it with a Location or Regions to save time.", "items": { "type": "string" } }, "titleKeywords": { "title": "Title must contain", "type": "array", "description": "Keep only jobs whose title contains at least one of these words (case and diacritics don't matter).", "items": { "type": "string" } }, "excludeKeywords": { "title": "Title must not contain", "type": "array", "description": "Skip jobs whose title contains any of these words, e.g. 'senior', 'brigáda'.", "items": { "type": "string" } }, "companies": { "title": "Company", "type": "array", "description": "Keep only jobs of companies whose name contains one of these texts, e.g. 'Škoda', 'O2'.", "items": { "type": "string" } }, "excludeCompanies": { "title": "Exclude companies", "type": "array", "description": "Skip jobs of companies whose name contains any of these texts.", "items": { "type": "string" } }, "includeCompanyInfo": { "title": "Add company data from ARES (extra charge)", "type": "boolean", "description": "Add data about the employer from ARES, the public register of economic subjects of the Czech Ministry of Finance: IČO (company ID), legal form, registered office, employee count range, main activity (CZ-NACE) and founding date. Off by default: when off, the actor never contacts ARES. Extra charge \"Company info\" (see the Pricing tab) only for saved jobs whose company data were found and returned; jobs without a match cost nothing extra. Matching is by the exact company name including its legal form, so some jobs stay without company data. Recruitment agencies (when known) and private persons are never looked up or returned. About 1 second per new company name.", "default": false }, "includeRecruiterContacts": { "title": "Include recruiter contacts (personal data)", "type": "boolean", "description": "Off by default. Adds recruiterName, recruiterPhone and recruiterEmail exactly as the job page shows them in its \"Kontaktní údaje\" block (the site almost never shows an e-mail, so recruiterEmail is nearly always empty). Needs \"Add description and details\". Never for private employers or jobs on career sites; nothing is guessed or looked up elsewhere, and e-mails and phones in descriptions stay removed. These are personal data and YOU are the data controller (GDPR): use them only to contact the person about that specific job ad, inform them (Art. 14 GDPR) at the latest when you first contact them, respect objections and delete the data when no longer needed. Commercial e-mails/SMS without prior consent (Act 480/2004 Coll., § 7) and marketing calls without consent (Act 127/2005 Coll., § 96) are illegal in Czechia, also to business addresses and numbers. Don't use the contacts for marketing, don't resell them and don't build contact databases. No extra charge.", "default": false }, "onlyNewOrChanged": { "title": "Monitoring: only new or changed jobs", "type": "boolean", "description": "Return only jobs that are new or whose title, company, salary, place or type of work changed since the previous run with the same Monitoring key. Unchanged jobs are free.", "default": false }, "monitoringKey": { "title": "Monitoring: key", "type": "string", "description": "Name of the saved state. Use a different key for each watched search (e.g. 'python-praha').", "default": "default" }, "includeRemovedJobs": { "title": "Monitoring: include removed jobs", "type": "boolean", "description": "With \"Monitoring: only new or changed jobs\": also return jobs from the previous run with the same Monitoring key that are no longer in the search, as rows with changeType \"removed\", removedAt, firstSeenAt, daysOnline and the last known title, company, place, salary and URL. Checked only when the run reads the whole search (Max jobs, Max jobs per search, Max pages per search, unread pages or rejected requests skip the check, and the status message says why). Removed rows are normal dataset rows and are charged like any other job.", "default": false }, "skipReposts": { "title": "Monitoring: skip reposted jobs", "type": "boolean", "description": "With monitoring: don't save a new job that has the same title, employer and place as a job seen before under another ID (a re-posted ad). Without this option such jobs are saved with isRepost: true and repostOf.", "default": false }, "fastMode": { "title": "Fast mode (small extra charge)", "type": "boolean", "description": "Reads Jobs.cz up to 4x faster: at most 120 requests per minute and 4 at a time instead of 30 per minute and 2 at a time. It stays polite: the moment the website answers \"too many requests\", \"service unavailable\" or slows down, the run switches back to the normal speed for the rest of the run, it waits when the website asks it to wait, and it never changes IP address to get around a limit. Extra charge \"Fast mode\" (see the Pricing tab, $0.01 per 1 000 jobs) only for jobs saved while the fast speed was on. Limits (Max jobs, Max pages) stay the same. Please don't run several fast-mode runs at the same time.", "default": false }, "maxPages": { "title": "Max pages per search", "minimum": 0, "type": "integer", "description": "Safety limit for each search or URL (30 jobs per page). The website itself shows at most 333 pages (9 990 jobs) per search; when you want more from a search the actor built itself (no Location, no URLs), it reads it region by region. 0 = no limit.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not needed: Jobs.cz works without a proxy, including from Apify servers. You can use Apify Proxy or your own proxies if you prefer.", "default": { "useApifyProxy": false } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }