{
  "openapi": "3.0.1",
  "info": {
    "title": "Jobs.cz Scraper ($0.49/1K): Salaries & Recruiter Contacts",
    "description": "Scrape Jobs.cz jobs with salary, region, seniority, requirements and benefits, using the site's own filters. Market salary benchmark for each job, hiring signals, new, removed and re-posted jobs, free salary summary, optional ARES company data. Recruiter contacts only if turned on. Unofficial.",
    "version": "0.0",
    "x-build-id": "Ha800iirlu9h1jpa0"
  },
  "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": {
          "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."
          },
          "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), or job URLs, e.g. https://www.jobs.cz/rpd/<id>/. 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"
                }
              }
            }
          },
          "maxItems": {
            "title": "Max jobs",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of jobs saved. You pay per saved job. 0 = no limit.",
            "default": 100
          },
          "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: about 2 seconds per job. Jobs published on an employer's own career site keep the listing data, unless \"Add text from employer career sites\" is on.",
            "default": false
          },
          "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. A radius search is not read beyond the website's limit, so above 9 990 jobs use a smaller radius or more filters. Jobs.cz URLs keep their own radius.",
            "default": 0
          },
          "distanceFrom": {
            "title": "Distance from",
            "type": "string",
            "description": "Add distanceKm to every job: the straight-line distance in km from this place, e.g. your home or office. Write a Czech address ('Údolní 53, Brno'), a town ('Kuřim') or 'latitude, longitude' ('49.198, 16.592'). With \"Add description and details\" the distance goes to the workplace itself, otherwise to the centre of its town (distanceBasis says which). An address is looked up once per run in the public Czech address register (ČÚZK); a town or coordinates need no lookup. Free."
          },
          "maxDistanceKm": {
            "title": "Max. distance (km)",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Keep only jobs at most this many km from \"Distance from\" (0 = no limit). Jobs whose place of work is unknown (e.g. 'Česko', abroad) are left out. Tip: combine with Location and Radius (km), so that the website returns the jobs around and this filter keeps the close ones. Jobs filtered out are not saved or charged.",
            "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)"
              ]
            }
          },
          "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
          },
          "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",
              "html",
              "markdown"
            ],
            "type": "string",
            "description": "With \"Add description and details\": the description as plain text (default), clean HTML or Markdown that keep the ad's headings, paragraphs, bullet lists and bold text (Markdown is handy for LLMs and notes). E-mails, phone numbers and contact names next to them are removed in every format, including mailto: and tel: links. With \"Description length limit\", HTML and Markdown are cut at whole paragraphs.",
            "default": "text"
          },
          "includeCareerPageDetails": {
            "title": "Add text from employer career sites (small extra charge)",
            "type": "boolean",
            "description": "With \"Add description and details\": also add the description and details of jobs that an employer publishes on its own career site (hasCareerPage: true). On Jobs.cz that is about a third of all jobs, and without this option they have the listing data only. Adds the description (in the chosen format, contacts removed), benefits, required education and languages, contract type, street, GPS and the requirements read from the text; descriptionSource says \"careerSite\". Same polite speed as the rest of the run. A career site that can't be read never stops the run: those jobs keep the listing data and cost nothing extra. Recruiter contacts are never read from career sites. Extra charge \"Career-site details\" (see the Pricing tab) only for saved jobs whose text was added this way; free until the charge appears in the Pricing tab.",
            "default": false
          },
          "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). 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
          },
          "includeHiddenSalary": {
            "title": "Add salary hidden by the employer (small extra charge)",
            "type": "boolean",
            "description": "Off by default. Many employers on Jobs.cz enter a salary but choose not to display it (\"Plat neuveden\"). Without this option such jobs have empty salary fields and salaryHidden: true. With it, the salary fields (salaryMin, salaryMax, period, monthly and hourly conversion, salaryText) are filled for them too and salaryHidden stays true, so you can tell a displayed salary from a hidden one. Treat a hidden salary as the employer's internal range, not as a public offer. Extra charge \"Hidden salary\" (see the Pricing tab) only for saved jobs whose salary was filled this way; free until the charge appears in the Pricing tab.",
            "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"
            }
          },
          "descriptionKeywords": {
            "title": "Title or description must contain",
            "type": "array",
            "description": "Keep only jobs whose title or description contains at least one of these words (case and diacritics don't matter), e.g. 'vysokozdvižný', 'SAP', 'němčina'. Needs \"Add description and details\" (the run stops with an error without it). The whole description is searched, whatever its format and length limit. Jobs without a description (career-site jobs without \"Add text from employer career sites\", pages that could not be read) are checked by their title only. Jobs filtered out are not saved or charged, but their pages are read.",
            "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"
            }
          },
          "drivingLicences": {
            "title": "Driving licence (any of)",
            "type": "array",
            "description": "Only jobs whose description names at least one of these driving licence groups (\"ŘP sk. C\", \"řidičské oprávnění C+E\"), required or as an advantage. Read from the description, so it needs \"Add description and details\"; jobs whose page could not be read are kept. Skipped jobs are free.",
            "items": {
              "type": "string",
              "enum": [
                "AM",
                "A1",
                "A2",
                "A",
                "B1",
                "B",
                "B+E",
                "C1",
                "C1+E",
                "C",
                "C+E",
                "D1",
                "D1+E",
                "D",
                "D+E",
                "T"
              ],
              "enumTitles": [
                "AM",
                "A1",
                "A2",
                "A",
                "B1",
                "B",
                "B+E",
                "C1",
                "C1+E",
                "C",
                "C+E",
                "D1",
                "D1+E",
                "D",
                "D+E",
                "T"
              ]
            }
          },
          "excludeNightShifts": {
            "title": "Exclude night shifts",
            "type": "boolean",
            "description": "Skip jobs whose description mentions night shifts, three-shift or non-stop operation (třísměnný, nepřetržitý provoz). Jobs that say nothing about shifts are kept. Needs \"Add description and details\". Skipped jobs are free.",
            "default": false
          },
          "minExperienceYearsMax": {
            "title": "Max. required experience (years)",
            "minimum": 0,
            "type": "integer",
            "description": "Only jobs that ask for at most this many years of experience (0 = only jobs for people without experience, \"bez praxe\"). Jobs that state no number of years are kept. Needs \"Add description and details\". Skipped jobs are free."
          },
          "includeSalaryBenchmark": {
            "title": "Salary benchmark (extra charge)",
            "type": "boolean",
            "description": "Add what employers offer for the same profession: the market median and quartiles of the monthly wage (CZK) in the job's region or in the whole country, the job's salary against the median in percent (salaryVsMarketPercent) and, for jobs without a salary, an ESTIMATED range (P25 to P75). Source: open data of the Czech Labour Office (MPSV / Úřad práce ČR), no extra run time. Each job is matched to a CZ-ISCO profession group; jobs that can't be matched reliably get null (about 1 in 5) and cost nothing extra. The Labour Office vacancies pay less than an average Jobs.cz ad, so read the numbers as a comparison, not as a salary offer (see the README). Extra charge \"Salary benchmark\" only for saved jobs with a benchmark: free until 27 November 2026, from 28 November 2026 $0.30 per 1 000 jobs.",
            "default": false
          },
          "includeHiringSignals": {
            "title": "Hiring signals (extra charge)",
            "type": "boolean",
            "description": "Add companyOpenPositions (open positions of the same employer the run saw), daysOnline (days since posting), hardToFill (online for over a month or re-posted repeatedly) and, with \"Monitoring: only new or changed jobs\", repostCount and isRepost from your earlier runs with the same Monitoring key. Without monitoring only this run and the posting dates are used. No extra run time. Extra charge \"Hiring signals\" only for saved jobs with the signals: free until 27 November 2026, from 28 November 2026 $0.20 per 1 000 jobs.",
            "default": false
          },
          "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. Company data are added only for an unambiguous match of the employer name, so some jobs stay without them. Recruitment agencies (when known) and private persons are never looked up or returned. A run with many new employers takes longer.",
            "default": false
          },
          "includeEmployerRating": {
            "title": "Add employer rating from Atmoskop (extra charge)",
            "type": "boolean",
            "description": "Add how employees rate the employer on Atmoskop.cz, the Czech employer review site: number of reviews, satisfaction with the employer, colleagues, managers and pay, work-life balance (0-100 %), what employees recommend the employer for, and the profile link. Off by default: when off, the actor never contacts Atmoskop. Only the aggregate numbers of the employer, never review texts. The employer's profile is found automatically; brand names that can't be matched with certainty get no rating; agencies and private persons are never looked up. Extra charge \"Employer rating\" (see the Pricing tab) only for saved jobs that got a rating. A run with many new employers takes longer.",
            "default": false
          },
          "minEmployerReviews": {
            "title": "Employer rating: minimum reviews",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "With \"Add employer rating from Atmoskop\": add the rating only when it is based on at least this many reviews (a rating from 1-2 reviews says little). Jobs of employers with fewer reviews are saved without a rating and cost nothing extra.",
            "default": 1
          },
          "includeRecruiterContacts": {
            "title": "Include recruiter contacts (personal data)",
            "type": "boolean",
            "description": "Off by default. Adds recruiterName, recruiterPhone and recruiterEmail exactly as the ad's contact details show them (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'). Empty = \"default\". The value is stored encrypted."
          },
          "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 is the same position 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
          },
          "slackWebhookUrl": {
            "title": "Notifications: Slack webhook URL",
            "type": "string",
            "description": "Incoming webhook of your Slack channel (https://hooks.slack.com/services/...). Stored encrypted."
          },
          "discordWebhookUrl": {
            "title": "Notifications: Discord webhook URL",
            "type": "string",
            "description": "Webhook of your Discord channel (https://discord.com/api/webhooks/...). In Discord: channel settings → Integrations → Webhooks → Copy Webhook URL. Stored encrypted."
          },
          "telegramBotToken": {
            "title": "Notifications: Telegram bot token",
            "type": "string",
            "description": "Token of your Telegram bot (from @BotFather). Used with \"Telegram chat ID\". Stored encrypted."
          },
          "telegramChatId": {
            "title": "Notifications: Telegram chat ID",
            "type": "string",
            "description": "Chat, group or channel ID the bot writes to (e.g. -1001234567890)."
          },
          "webhookUrl": {
            "title": "Notifications: webhook URL",
            "type": "string",
            "description": "Any HTTPS URL (Zapier, Make, n8n, your server): gets a POST with JSON {title, summary, totalSaved, runUrl, datasetUrl, items}."
          },
          "whatsappAccessToken": {
            "title": "Notifications: WhatsApp access token",
            "type": "string",
            "description": "Access token of the WhatsApp Cloud API of your Meta business account, used with \"WhatsApp phone number ID\" and \"WhatsApp recipient number\" (step by step in the README, section \"WhatsApp notifications: setup\"). For scheduled runs use a permanent token of a system user: Business settings → System users → Generate token, with the permissions whatsapp_business_messaging and whatsapp_business_management; the token of WhatsApp → API Setup expires within hours. Stored encrypted."
          },
          "whatsappPhoneNumberId": {
            "title": "Notifications: WhatsApp phone number ID",
            "type": "string",
            "description": "ID of your WhatsApp business number that sends the message (not the number itself), e.g. 106540352242922. In your Meta app: WhatsApp → API Setup → Phone number ID."
          },
          "whatsappTo": {
            "title": "Notifications: WhatsApp recipient number",
            "type": "string",
            "description": "Phone number that gets the message, in international format with the country code (e.g. +420601234567); up to 5 numbers separated by commas or new lines, each gets its own message and the notification is charged once per run. A test number of Meta sends only to numbers you added and confirmed under API Setup → To. Stored encrypted."
          },
          "whatsappTemplateName": {
            "title": "Notifications: WhatsApp template name",
            "type": "string",
            "description": "Name of your approved message template (WhatsApp Manager → Message templates, e.g. apify_results), recommended: WhatsApp delivers a template message at any time. Its body gets the run summary with the first results in {{1}} and the dataset link in {{2}} (a template with only {{1}} gets both in {{1}}). Empty: a plain text message, which WhatsApp delivers only when the recipient wrote to your business number in the last 24 hours, so a scheduled run usually needs a template. Meta charges your business account for template messages (step by step in the README, section \"WhatsApp notifications: setup\")."
          },
          "whatsappTemplateLanguage": {
            "title": "Notifications: WhatsApp template language",
            "type": "string",
            "description": "Language code of the template exactly as WhatsApp Manager → Message templates shows it next to the template, e.g. en_US, en_GB, cs, sk, pl or de. Used only with \"WhatsApp template name\".",
            "default": "en_US"
          },
          "notificationLimit": {
            "title": "Notifications: max jobs per message",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many jobs are listed in one notification (the rest as \"…and N more\").",
            "default": 10
          },
          "notifyOnlyChanges": {
            "title": "Notifications: only when something was saved",
            "type": "boolean",
            "description": "Send nothing when the run saved no job (e.g. a monitoring run without new jobs).",
            "default": true
          },
          "fastMode": {
            "title": "Fast mode (small extra charge)",
            "type": "boolean",
            "description": "Reads Jobs.cz up to about 4x faster and drops back to the normal speed for the rest of the run at the first sign of load. 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 9 990 jobs per search; when you want more from a search the actor built itself (no Location, no URLs), it is still read in full. 0 = no limit.",
            "default": 50
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Not needed: Jobs.cz works without a proxy. You can use Apify Proxy or your own proxies if you prefer.",
            "default": {
              "useApifyProxy": false
            }
          },
          "sendErrorReports": {
            "title": "Send error reports",
            "type": "boolean",
            "description": "When a run fails, send the developer a short error report: the error and your input with secrets left out (tokens, webhooks and e-mails are hidden). Your results are never sent. Reports are deleted after at most 120 hours. Turn off to send nothing.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}