{
  "openapi": "3.0.1",
  "info": {
    "title": "Prace.cz Scraper ($0.49/1K): Salaries & Recruiter Contacts",
    "description": "Scrape Prace.cz jobs with salary, company, region and remote work. Market salary benchmark for each job, hiring signals (open positions, days online, re-posts), new and removed jobs, salary summary and optional ARES company data. Unofficial.",
    "version": "0.0",
    "x-build-id": "YliqYItYesdEGDptj"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tsutseisoftware~prace-cz-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tsutseisoftware-prace-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~prace-cz-scraper/runs": {
      "post": {
        "operationId": "runs-sync-tsutseisoftware-prace-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~prace-cz-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-tsutseisoftware-prace-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 and website filters, not for Prace.cz URLs. For several places use Locations."
          },
          "startUrls": {
            "title": "Prace.cz URLs",
            "type": "array",
            "description": "Search or listing URLs from Prace.cz, e.g. https://www.prace.cz/nabidky/brno/?keywords[]=skladník (set the search and filters on the website and paste the URL), or job URLs, e.g. https://www.prace.cz/nabidka/<id>/. Website filters below are added to these URLs too, unless the URL already sets them.",
            "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), benefits, required education and languages, contract type, street 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 only, unless you also turn on \"Add text from employer career sites\".",
            "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 Prace.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 'a okolí' on the website. Example: Location 'brno' with Radius 20 = 'Brno-město a okolí' (about 2 100 jobs instead of 1 600). Any whole number up to 100; 0 = only the place itself (as before). Needs a Location (city or district); regions have no radius and are searched as they are. Prace.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 Prace.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)"
              ]
            }
          },
          "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
          },
          "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 read the jobs that are published on the employer's own career site (about a third to a half of all jobs, hasCareerPage: true), which otherwise have no description. 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 read from a career site; free until the charge appears in the Pricing tab.",
            "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, or turn on \"Add salary hidden by the employer\" to get their amounts)."
          },
          "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"
              ]
            }
          },
          "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."
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Only jobs in at least one of these categories (obor), as listed on the website. Checked by the actor on each job, so combine it with a search or location to save time.",
            "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)"
              ]
            }
          },
          "onlyWithSalary": {
            "title": "Only jobs with a salary",
            "type": "boolean",
            "description": "Skip jobs that don't show a salary on the website. With \"Add salary hidden by the employer\", jobs whose hidden salary was added are kept too.",
            "default": false
          },
          "includeHiddenSalary": {
            "title": "Add salary hidden by the employer (small extra charge)",
            "type": "boolean",
            "description": "Off by default. Some employers enter a salary but choose not to display it on the page (\"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) 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
          },
          "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 Prace.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
          },
          "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 Prace.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 (40 jobs per page). The website itself shows at most 10 000 jobs per search. 0 = no limit.",
            "default": 50
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Not needed: Prace.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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}