{
  "openapi": "3.0.1",
  "info": {
    "title": "OLX Praca Scraper ($0.99/1K): Polish Job Ads & Salaries",
    "description": "Scrape job ads from OLX Praca (olx.pl): salary per month and hour, contract, working time, company, town, voivodeship, category and description. Website filters, automatic split of searches over 1,000 ads, monitoring of new and removed ads, notifications, market summary. Unofficial. Oferty pracy.",
    "version": "0.0",
    "x-build-id": "gmleWQvVIUjjuSPtR"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tsutseisoftware~olx-praca-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tsutseisoftware-olx-praca-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~olx-praca-scraper/runs": {
      "post": {
        "operationId": "runs-sync-tsutseisoftware-olx-praca-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~olx-praca-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-tsutseisoftware-olx-praca-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 keywords",
            "type": "array",
            "description": "Words to search for, as typed into the search box of the jobs section, e.g. \"magazynier\", \"kierowca C+E\", \"opiekunka\". The website searches the title and the text of the ads. Each line is a separate search, combined with the categories, places and website filters below. Empty = all job ads that match the rest.",
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Categories of the jobs section (140: 42 main ones, their subcategories and the website's 5 selections such as \"Praca dodatkowa\"). Each chosen category is a separate search. Empty = the whole jobs section. Applied by the website.",
            "items": {
              "type": "string",
              "enum": [
                "administracja-biurowa",
                "administracja-biurowa/administracja-prace-biurowe",
                "administracja-biurowa/sekretariat-recepcja",
                "badania-rozwoj",
                "bankowosc",
                "bhp-ochrona-srodowiska",
                "budowa-remonty",
                "budowa-remonty/architekt",
                "budowa-remonty/ciesla",
                "budowa-remonty/dekarz",
                "budowa-remonty/glazurnik",
                "budowa-remonty/hydraulik",
                "budowa-remonty/kierownik-budowy-inzynier-brygadzista",
                "budowa-remonty/malarz",
                "budowa-remonty/murarz",
                "budowa-remonty/operator-maszyn-budowlanych",
                "budowa-remonty/pracownik-ogolnobudowlany",
                "budowa-remonty/robotnik-drogowy",
                "budowa-remonty/spawacz-slusarz",
                "budowa-remonty/stolarz",
                "dostawca-kurier-miejski",
                "e-commerce-handel-internetowy",
                "edukacja",
                "edukacja/szkolnictwo",
                "edukacja/kursy-zajecia-dodatkowe",
                "edukacja/nauczanie-jezykow-obcych",
                "energetyka",
                "energetyka/konwencjonalna",
                "energetyka/odnawialna",
                "energetyka/pozostale-w-energetyka",
                "finanse-ksiegowosc",
                "finanse-ksiegowosc/ksiegowosc",
                "finanse-ksiegowosc/finanse",
                "finanse-ksiegowosc/pozostale-w-finanse-i-ksiegowosc",
                "franczyza-wlasna-firma",
                "fryzjerstwo-kosmetyka",
                "fryzjerstwo-kosmetyka/fryzjer-barber",
                "fryzjerstwo-kosmetyka/kosmetolog-kosmetyczka",
                "fryzjerstwo-kosmetyka/pozostale-we-fryzjerstwo-kosmetyka",
                "gastronomia",
                "gastronomia/cukiernik-piekarz",
                "gastronomia/kelner-barman-barista",
                "gastronomia/kucharz",
                "gastronomia/pomoc-kuchenna-zmywak",
                "gastronomia/pracownik-restauracji-fast-food",
                "gastronomia/manager-restauracji",
                "gastronomia/pozostale",
                "hr",
                "hr/kadry-i-place",
                "hr/rekrutacja",
                "hr/pozostale-w-hr",
                "hostessa-roznoszenie-ulotek",
                "hostessa-roznoszenie-ulotek/hostessa-host",
                "hostessa-roznoszenie-ulotek/roznoszenie-ulotek",
                "hotelarstwo",
                "hotelarstwo/obsluga-hotelowa",
                "hotelarstwo/zarzadzanie-hotelem",
                "inzynieria",
                "informatyka",
                "informatyka/programista",
                "informatyka/tester",
                "informatyka/analityk",
                "informatyka/wsparcie-techniczne",
                "informatyka/administrator-systemow",
                "informatyka/administrator-baz-danych",
                "informatyka/administrator-sieci",
                "informatyka/zarzadzanie-projektami",
                "kierowca",
                "logistyka-zakupy-spedycja",
                "logistyka-zakupy-spedycja/logistyka",
                "logistyka-zakupy-spedycja/zakupy",
                "logistyka-zakupy-spedycja/spedycja",
                "marketing-pr",
                "marketing-pr/marketing",
                "marketing-pr/social-media",
                "marketing-pr/copywriting",
                "marketing-pr/media-i-pr",
                "marketing-pr/grafika",
                "marketing-pr/badania-praca-w-domu",
                "mechanika-lakiernictwo",
                "mechanika-lakiernictwo/mechanik-elektromechanik-wulkanizator",
                "mechanika-lakiernictwo/lakiernik-blacharz",
                "montaz-serwis",
                "nieruchomosci",
                "nieruchomosci/agent-nieruchomosci",
                "nieruchomosci/utrzymanie-zarzadzanie-nieruchomosciami",
                "obsluga-klienta-call-center",
                "obsluga-klienta-call-center/specjalista-ds-obslugi-klienta",
                "obsluga-klienta-call-center/call-center-konsultant-telefoniczny",
                "ochrona",
                "opieka",
                "opieka/opieka-nad-dziecmi",
                "opieka/opieka-nad-seniorami-chorymi",
                "organizacja-obsluga-impres",
                "praca-za-granica",
                "prace-magazynowe",
                "pracownik-sklepu",
                "pracownik-sklepu/kasjer-pracownik-sklepu",
                "pracownik-sklepu/zarzadzanie-sklepem",
                "prawo",
                "prawo/prawnik-radca-prawny-notariusz",
                "prawo/specjalisci-aplikanci",
                "prawo/windykacja",
                "produkcja",
                "produkcja/obsluga-produkcji",
                "produkcja/zarzadzanie-produkcja",
                "produkcja/praca-inzynieryjna-techniczna",
                "produkcja/utrzymanie-ruchu",
                "produkcja/kontrola-jakosci",
                "rolnictwo-i-ogrodnictwo",
                "sluzby-mundurowe",
                "sprzatanie",
                "sprzedaz",
                "sprzedaz/doradca-klienta-sprzedawca",
                "sprzedaz/przedstawiciel-handlowy",
                "sprzedaz/key-account-manager",
                "sprzedaz/zarzadzanie-sprzedaza",
                "ubezpieczenia",
                "wykladanie-ekspozycja-towaru",
                "zdrowie",
                "zdrowie/dietetyka",
                "zdrowie/farmacja",
                "zdrowie/lekarz",
                "zdrowie/optyka-okulistyka-optometria",
                "zdrowie/pielegniarka-pielegniarz",
                "zdrowie/pracownicy-ochrony-zdrowia",
                "zdrowie/psychologia-psychoterapia",
                "zdrowie/rehabilitacja-i-masaz",
                "zdrowie/rejestracja-obsluga-pacjentow",
                "zdrowie/stomatologia",
                "zdrowie/trener-personalny-instruktor-fitness",
                "zdrowie/weterynaria",
                "zdrowie/pozostale-w-zdrowie",
                "inne-oferty-pracy",
                "praktyki-staze",
                "kadra-kierownicza",
                "praca-sezonowa",
                "zapraszamy-seniorow",
                "praca-dodatkowa",
                "praca-od-zaraz"
              ],
              "enumTitles": [
                "Administracja biurowa",
                "Administracja biurowa › Administracja, prace biurowe",
                "Administracja biurowa › Sekretariat, recepcja",
                "Badania i rozwój",
                "Bankowość",
                "BHP i ochrona środowiska",
                "Budowa / remonty",
                "Budowa / remonty › Architekt",
                "Budowa / remonty › Cieśla",
                "Budowa / remonty › Dekarz",
                "Budowa / remonty › Glazurnik",
                "Budowa / remonty › Hydraulik",
                "Budowa / remonty › Kierownik budowy / Inżynier / Brygadzista",
                "Budowa / remonty › Malarz",
                "Budowa / remonty › Murarz",
                "Budowa / remonty › Operator maszyn budowlanych",
                "Budowa / remonty › Pracownik ogólnobudowlany",
                "Budowa / remonty › Robotnik drogowy",
                "Budowa / remonty › Spawacz / Ślusarz",
                "Budowa / remonty › Stolarz",
                "Dostawca, kurier miejski",
                "E-commerce (handel internetowy)",
                "Edukacja",
                "Edukacja › Szkolnictwo",
                "Edukacja › Kursy, zajęcia dodatkowe",
                "Edukacja › Nauczanie języków obcych",
                "Energetyka",
                "Energetyka › Konwencjonalna",
                "Energetyka › Odnawialna",
                "Energetyka › Pozostałe w Energetyka",
                "Finanse / księgowość",
                "Finanse / księgowość › Księgowość",
                "Finanse / księgowość › Finanse",
                "Finanse / księgowość › Pozostałe w Finanse i księgowość",
                "Franczyza / Własna firma",
                "Fryzjerstwo, kosmetyka",
                "Fryzjerstwo, kosmetyka › Fryzjer, barber",
                "Fryzjerstwo, kosmetyka › Kosmetolog, kosmetyczka",
                "Fryzjerstwo, kosmetyka › Pozostałe we Fryzjerstwo, kosmetyka",
                "Gastronomia",
                "Gastronomia › Cukiernik, piekarz",
                "Gastronomia › Kelner, barman, barista",
                "Gastronomia › Kucharz",
                "Gastronomia › Pomoc kuchenna / zmywak",
                "Gastronomia › Pracownik restauracji fast-food",
                "Gastronomia › Manager restauracji",
                "Gastronomia › Pozostałe",
                "HR",
                "HR › Kadry i płace",
                "HR › Rekrutacja",
                "HR › Pozostałe w HR",
                "Hostessa, roznoszenie ulotek",
                "Hostessa, roznoszenie ulotek › Hostessa, host",
                "Hostessa, roznoszenie ulotek › Roznoszenie ulotek",
                "Hotelarstwo",
                "Hotelarstwo › Obsługa hotelowa",
                "Hotelarstwo › Zarządzanie hotelem",
                "Inżynieria",
                "IT / telekomunikacja",
                "IT / telekomunikacja › Programista",
                "IT / telekomunikacja › Tester",
                "IT / telekomunikacja › Analityk",
                "IT / telekomunikacja › Wsparcie techniczne",
                "IT / telekomunikacja › Administrator systemów",
                "IT / telekomunikacja › Administrator baz danych",
                "IT / telekomunikacja › Administrator sieci",
                "IT / telekomunikacja › Zarządzanie projektami",
                "Kierowca",
                "Logistyka, zakupy, spedycja",
                "Logistyka, zakupy, spedycja › Logistyka",
                "Logistyka, zakupy, spedycja › Zakupy",
                "Logistyka, zakupy, spedycja › Spedycja",
                "Marketing i PR",
                "Marketing i PR › Marketing",
                "Marketing i PR › Social media",
                "Marketing i PR › Copywriting",
                "Marketing i PR › Media i PR",
                "Marketing i PR › Grafika",
                "Marketing i PR › Badania, praca w domu",
                "Mechanika i lakiernictwo",
                "Mechanika i lakiernictwo › Mechanik, elektromechanik, wulkanizator",
                "Mechanika i lakiernictwo › Lakiernik, blacharz",
                "Montaż i serwis",
                "Nieruchomości",
                "Nieruchomości › Agent nieruchomości",
                "Nieruchomości › Utrzymanie / Zarządzanie nieruchomościami",
                "Obsługa klienta i call center",
                "Obsługa klienta i call center › Specjalista ds. obsługi klienta",
                "Obsługa klienta i call center › Call center, konsultant telefoniczny",
                "Ochrona",
                "Opieka",
                "Opieka › Opieka nad dziećmi",
                "Opieka › Opieka nad seniorami i chorymi",
                "Organizacja i obsługa imprez",
                "Praca za granicą",
                "Prace magazynowe",
                "Pracownik sklepu",
                "Pracownik sklepu › Kasjer, pracownik sklepu",
                "Pracownik sklepu › Zarządzanie sklepem",
                "Prawo",
                "Prawo › Prawnik / Radca prawny / Notariusz",
                "Prawo › Specjaliści / Aplikanci",
                "Prawo › Windykacja",
                "Produkcja",
                "Produkcja › Obsługa produkcji",
                "Produkcja › Zarządzanie produkcją",
                "Produkcja › Praca inżynieryjna, techniczna",
                "Produkcja › Utrzymanie ruchu",
                "Produkcja › Kontrola jakości",
                "Rolnictwo i ogrodnictwo",
                "Służby mundurowe",
                "Sprzątanie",
                "Sprzedaż",
                "Sprzedaż › Doradca klienta, sprzedawca",
                "Sprzedaż › Przedstawiciel handlowy",
                "Sprzedaż › Key Account Manager",
                "Sprzedaż › Zarządzanie sprzedażą",
                "Ubezpieczenia",
                "Wykładanie i ekspozycja towaru",
                "Zdrowie",
                "Zdrowie › Dietetyka",
                "Zdrowie › Farmacja",
                "Zdrowie › Lekarz",
                "Zdrowie › Optyka / Okulistyka / Optometria",
                "Zdrowie › Pielęgniarka / Pielęgniarz",
                "Zdrowie › Pracownicy ochrony zdrowia",
                "Zdrowie › Psychologia / Psychoterapia",
                "Zdrowie › Rehabilitacja i masaż",
                "Zdrowie › Rejestracja i obsługa pacjentów",
                "Zdrowie › Stomatologia",
                "Zdrowie › Trener personalny, instruktor fitness",
                "Zdrowie › Weterynaria",
                "Zdrowie › Pozostałe w Zdrowie",
                "Pozostałe oferty pracy",
                "Praktyki / staże (the website's selection across categories)",
                "Kadra kierownicza (the website's selection across categories)",
                "Praca sezonowa (the website's selection across categories)",
                "Zapraszamy seniorów (the website's selection across categories)",
                "Praca dodatkowa (the website's selection across categories)",
                "Praca od zaraz"
              ]
            }
          },
          "regions": {
            "title": "Voivodeships",
            "type": "array",
            "description": "Only ads in these voivodeships (each is a separate search). Applied by the website.",
            "items": {
              "type": "string",
              "enum": [
                "wielkopolskie",
                "mazowieckie",
                "dolnoslaskie",
                "malopolskie",
                "pomorskie",
                "slaskie",
                "lodzkie",
                "lubelskie",
                "lubuskie",
                "zachodniopomorskie",
                "opolskie",
                "swietokrzyskie",
                "warminsko-mazurskie",
                "kujawsko-pomorskie",
                "podkarpackie",
                "podlaskie"
              ],
              "enumTitles": [
                "Wielkopolskie",
                "Mazowieckie",
                "Dolnośląskie",
                "Małopolskie",
                "Pomorskie",
                "Śląskie",
                "Łódzkie",
                "Lubelskie",
                "Lubuskie",
                "Zachodniopomorskie",
                "Opolskie",
                "Świętokrzyskie",
                "Warmińsko-mazurskie",
                "Kujawsko-pomorskie",
                "Podkarpackie",
                "Podlaskie"
              ]
            }
          },
          "locations": {
            "title": "Towns or voivodeships",
            "type": "array",
            "description": "Towns by name, e.g. Warszawa, Kraków, Zielona Góra (the website's own place search finds them; for a name that several places share, add the voivodeship: \"Dąbrowa, opolskie\"), or voivodeships by name. Each line is a separate search. A town that the website does not know is reported in the status message.",
            "items": {
              "type": "string"
            }
          },
          "distanceKm": {
            "title": "Distance from the town",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Also ads within this many kilometres of each town (e.g. 5, 10, 15, 30, 50, 75 and 100). 0 = the town only.",
            "default": 0
          },
          "startUrls": {
            "title": "OLX URLs",
            "type": "array",
            "description": "Search and category URLs of the jobs section, with any filters set on the website (e.g. https://www.olx.pl/praca/kierowca/warszawa/ or https://www.olx.pl/praca/q-magazynier/), and URLs of job ads (https://www.olx.pl/oferta/praca/…-ID….html). A search URL keeps its own filters and place (the website filters below are not added to it; the actor's filters are). URLs of other sections of OLX are skipped.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "advertiserIds": {
            "title": "Advertiser IDs",
            "type": "array",
            "description": "All job ads of these business advertisers: the advertiserId of a row of this actor (e.g. 1277182495). Each is a separate search, combined with the keywords, categories and places.",
            "items": {
              "type": "string"
            }
          },
          "includeJobData": {
            "title": "Add job data (add-on)",
            "type": "boolean",
            "description": "Adds the parsed job fields to every row: salary per month and per hour and as one line, working time, contract types, workplace (remote, hybrid, on site), experience, availability, shift work, driving licences, special requirements, the check boxes (CV, management, online recruitment, seniors, Ukraine, Polish), category name and path, country for jobs abroad, the employer's application page and the other parameters under their labels. Off = these fields are empty.",
            "default": false
          },
          "maxItems": {
            "title": "Max jobs",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of job ads saved. You pay per saved ad. 0 = no limit (the jobs section has about 75 000 ads).",
            "default": 100
          },
          "maxItemsPerSearch": {
            "title": "Max jobs per search",
            "minimum": 0,
            "type": "integer",
            "description": "Limit for each keyword, category, place or URL separately, so one large search doesn't use up the whole Max jobs. 0 = no limit.",
            "default": 0
          },
          "maxPagesPerSearch": {
            "title": "Max pages per search",
            "minimum": 0,
            "type": "integer",
            "description": "Read at most this many pages (50 ads each) of every search. 0 = no limit.",
            "default": 0
          },
          "deepSearch": {
            "title": "Deep search: more than 1 000 ads per search (add-on)",
            "type": "boolean",
            "description": "The website shows at most 1 000 ads of one search, and by default the actor reads those. With this add-on a bigger search is read in parts that together cover it, so a whole category or the whole jobs section fits in one run. It needs \"Max jobs\" above 1 000 or 0. Its small extra cost is paid as \"Extra page\" (see Pricing).",
            "default": false
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "newest",
              "relevance",
              "salaryDesc",
              "salaryAsc"
            ],
            "type": "string",
            "description": "Order of the website's search. With a limit you get the first ads in this order. With \"Deep search\" the ads are ordered within each part.",
            "default": "newest"
          },
          "workingTime": {
            "title": "Working time",
            "type": "array",
            "description": "Only ads with one of these working times.",
            "items": {
              "type": "string",
              "enum": [
                "fullTime",
                "partTime",
                "temporary",
                "seasonal",
                "b2b"
              ],
              "enumTitles": [
                "Full time (pełny etat)",
                "Part time (niepełny etat)",
                "Additional work (praca dodatkowa)",
                "Seasonal (praca sezonowa)",
                "B2B cooperation (współpraca B2B)"
              ]
            }
          },
          "contractTypes": {
            "title": "Contract types",
            "type": "array",
            "description": "Only ads that offer one of these contracts.",
            "items": {
              "type": "string",
              "enum": [
                "employment",
                "mandate",
                "specificTask",
                "b2b",
                "internship",
                "other"
              ],
              "enumTitles": [
                "Employment contract (umowa o pracę)",
                "Mandate contract (umowa zlecenie)",
                "Contract for specific work (umowa o dzieło)",
                "Self-employment / B2B (samozatrudnienie)",
                "Internship (praktyka / staż)",
                "Other"
              ]
            }
          },
          "workArrangement": {
            "title": "Workplace",
            "type": "array",
            "description": "Only ads with one of these workplaces (many ads do not say).",
            "items": {
              "type": "string",
              "enum": [
                "onsite",
                "remote",
                "hybrid",
                "mobile"
              ],
              "enumTitles": [
                "On site (w siedzibie firmy)",
                "Remote (praca zdalna)",
                "Hybrid (praca hybrydowa)",
                "Frequent business trips (częste podróże służbowe)"
              ]
            }
          },
          "experience": {
            "title": "Experience",
            "enum": [
              "any",
              "notRequired",
              "required"
            ],
            "type": "string",
            "description": "Only ads that do or do not require experience.",
            "default": "any"
          },
          "availability": {
            "title": "Availability",
            "type": "array",
            "description": "Only ads marked with one of these.",
            "items": {
              "type": "string",
              "enum": [
                "shifts",
                "weekends",
                "flexible"
              ],
              "enumTitles": [
                "Shift work (praca zmianowa)",
                "Weekend work (praca w weekendy)",
                "Flexible hours (elastyczny czas pracy)"
              ]
            }
          },
          "specialRequirements": {
            "title": "Special requirements",
            "type": "array",
            "description": "Only ads marked with one of these.",
            "items": {
              "type": "string",
              "enum": [
                "sanitaryCard",
                "disabilityCertificate",
                "studentStatus"
              ],
              "enumTitles": [
                "Sanitary card (książeczka sanepidowska)",
                "Disability certificate (orzeczenie o niepełnosprawności)",
                "Student status (status studenta)"
              ]
            }
          },
          "advertiserType": {
            "title": "Advertiser",
            "enum": [
              "any",
              "business",
              "private"
            ],
            "type": "string",
            "description": "Only ads of companies or only ads of private persons (about a quarter of the ads; their names are never returned).",
            "default": "any"
          },
          "cvRequired": {
            "title": "CV",
            "enum": [
              "any",
              "mandatory",
              "optional"
            ],
            "type": "string",
            "description": "Only ads that do or do not require a CV.",
            "default": "any"
          },
          "managerial": {
            "title": "Management positions only",
            "type": "boolean",
            "description": "Only ads marked \"Kadra kierownicza\".",
            "default": false
          },
          "onlineRecruitment": {
            "title": "Online recruitment only",
            "type": "boolean",
            "description": "Only ads marked \"Rekrutacja online\".",
            "default": false
          },
          "seniorFriendly": {
            "title": "Seniors welcome only",
            "type": "boolean",
            "description": "Only ads marked \"Zapraszamy seniorów\".",
            "default": false
          },
          "openToUkrainians": {
            "title": "Open to workers from Ukraine only",
            "type": "boolean",
            "description": "Only ads marked as welcoming workers from Ukraine.",
            "default": false
          },
          "polishNotRequired": {
            "title": "Polish not required only",
            "type": "boolean",
            "description": "Only ads marked \"Jęz. polski niewymagany\".",
            "default": false
          },
          "extraFilters": {
            "title": "Extra website filters",
            "type": "object",
            "description": "Any other filter of the website, passed as it is, e.g. {\"filter_enum_driving_license\": [\"catce\"], \"filter_enum_transport_range\": [\"international_transport\"]} in the category Kierowca, or {\"filter_enum_country_job\": [\"d\"]} in Praca za granicą. The names are the ones in the website's search URLs (search[filter_enum_…]). A filter the category does not have is refused by the website and reported."
          },
          "onlyWithSalary": {
            "title": "Only jobs with a salary",
            "type": "boolean",
            "description": "Skip ads without a salary (about half of the ads).",
            "default": false
          },
          "minSalary": {
            "title": "Salary from (PLN per month)",
            "minimum": 0,
            "type": "integer",
            "description": "Only ads whose salary reaches at least this much per month (hourly rates are converted at standard full-time hours). Ads without a salary are left out. The filter works with or without \"Add job data\"."
          },
          "maxSalary": {
            "title": "Salary up to (PLN per month)",
            "minimum": 0,
            "type": "integer",
            "description": "Only ads whose salary starts at this much per month or less. Ads without a salary stay."
          },
          "postedWithinDays": {
            "title": "Posted in the last N days",
            "minimum": 0,
            "type": "integer",
            "description": "Only ads first posted in the last N days. With \"Sort by\" = newest the run stops reading at older ads."
          },
          "refreshedWithinDays": {
            "title": "Refreshed in the last N days",
            "minimum": 0,
            "type": "integer",
            "description": "Only ads posted or refreshed (bumped) in the last N days."
          },
          "maxAgeMinutes": {
            "title": "Refreshed in the last N minutes",
            "minimum": 0,
            "type": "integer",
            "description": "Only ads posted or refreshed in the last N minutes, for frequent scheduled runs."
          },
          "postedFrom": {
            "title": "Posted from",
            "type": "string",
            "description": "Only ads first posted on this day or later (YYYY-MM-DD)."
          },
          "postedTo": {
            "title": "Posted to",
            "type": "string",
            "description": "Only ads first posted on this day or earlier (YYYY-MM-DD)."
          },
          "titleKeywords": {
            "title": "Title must contain",
            "type": "array",
            "description": "Only ads whose title has these words (without diacritics and case).",
            "items": {
              "type": "string"
            }
          },
          "descriptionKeywords": {
            "title": "Text must contain",
            "type": "array",
            "description": "Only ads whose title or description has these words, e.g. \"zakwaterowanie\", \"umowa o pracę\".",
            "items": {
              "type": "string"
            }
          },
          "keywordsMode": {
            "title": "Keywords must match",
            "enum": [
              "any",
              "all"
            ],
            "type": "string",
            "description": "For \"Title must contain\" and \"Text must contain\".",
            "default": "any"
          },
          "excludeKeywords": {
            "title": "Title must not contain",
            "type": "array",
            "description": "Skip ads whose title has any of these words.",
            "items": {
              "type": "string"
            }
          },
          "excludeDescriptionKeywords": {
            "title": "Text must not contain",
            "type": "array",
            "description": "Skip ads whose title or description has any of these words.",
            "items": {
              "type": "string"
            }
          },
          "excludeCompanies": {
            "title": "Exclude companies",
            "type": "array",
            "description": "Skip ads of companies whose name has any of these words (e.g. agencies).",
            "items": {
              "type": "string"
            }
          },
          "excludeShiftWork": {
            "title": "Exclude shift work",
            "type": "boolean",
            "description": "Skip ads marked as shift work or whose text says so (see the shiftWork field).",
            "default": false
          },
          "customFilters": {
            "title": "Custom filters",
            "type": "array",
            "description": "Rules on any output field, all must hold: [{\"field\": \"salaryMonthlyMin\", \"op\": \"gte\", \"value\": 6000}, {\"field\": \"polishContractTypes\", \"op\": \"includes\", \"value\": \"employment\"}]. Operators: includes, notIncludes, equals, notEquals, gt, gte, lt, lte."
          },
          "skipJobsFromDataset": {
            "title": "Skip jobs of an earlier run",
            "type": "string",
            "description": "Run ID or dataset ID of an earlier run of this actor: ads it saved are left out (and not charged), e.g. to continue a run that stopped at a limit."
          },
          "includeContacts": {
            "title": "Contacts (personal data, extra charge)",
            "type": "boolean",
            "description": "Add contactNames, contactEmails, contactPhones and contactUrls to ads of business advertisers.",
            "default": false
          },
          "includePhoneNumbers": {
            "title": "Phone numbers behind \"show phone\" (business ads only, extra charge)",
            "type": "boolean",
            "description": "Tries to read the phone number the website shows after a click, for ads of companies (business accounts) only; never for private persons. The lookups go through the Apify residential proxy (Poland) at the normal speed, and the website serves only some of them: you pay \"Phone number\" only for an ad whose number was returned (see Pricing and \"Phone numbers\" in the README). You are responsible for using the numbers lawfully.",
            "default": false
          },
          "maxPhoneNumbers": {
            "title": "Max phone lookups per run",
            "minimum": 0,
            "maximum": 2000,
            "type": "integer",
            "description": "At most this many business ads are looked up in one run (hard maximum 2 000); the other ads are saved without a number.",
            "default": 500
          },
          "descriptionFormat": {
            "title": "Description format",
            "enum": [
              "text",
              "markdown",
              "html"
            ],
            "type": "string",
            "description": "Format of the description. E-mails and phone numbers are removed from it in every format.",
            "default": "text"
          },
          "descriptionMaxLength": {
            "title": "Description length limit",
            "minimum": 0,
            "type": "integer",
            "description": "Cut descriptions to about this many characters. 0 = whole descriptions.",
            "default": 0
          },
          "compact": {
            "title": "Compact output",
            "type": "boolean",
            "description": "Keep only the core fields of every row: id, title, company, town, voivodeship, salary, working time, contract, category, dates, link (and the monitoring fields). Smaller rows for AI agents, MCP clients and dashboards; the price per ad is the same.",
            "default": false
          },
          "excludeEmptyFields": {
            "title": "Leave out empty fields",
            "type": "boolean",
            "description": "Drop fields that are null or empty from every row (the columns then differ between rows).",
            "default": false
          },
          "fields": {
            "title": "Output fields",
            "type": "array",
            "description": "Keep only these fields in every row (plus id, source, url, title, scrapedAt), e.g. company, location, salaryMonthlyMin, salaryMonthlyMax, postedAt. Empty = all fields.",
            "items": {
              "type": "string"
            }
          },
          "onlyNewOrChanged": {
            "title": "Monitoring: only new or changed jobs",
            "type": "boolean",
            "description": "Save only ads that are new or changed since the previous run with the same Monitoring key (changed = title, company, salary, town, working time, contract, workplace or the text of the ad). Unchanged ads are free; each search page read is charged as \"Monitoring page\" instead (see Pricing). The first run returns everything.",
            "default": false
          },
          "monitoringKey": {
            "title": "Monitoring: key",
            "type": "string",
            "description": "Name of the saved state. Use a different key for each watched search (e.g. \"kierowca-mazowieckie\"). Empty = \"default\". The value is stored encrypted."
          },
          "includeRemovedJobs": {
            "title": "Monitoring: include removed jobs",
            "type": "boolean",
            "description": "Also return ads that were in the previous run and are gone, as rows with changeType \"removed\" and removedReason \"expired\" (the ad ended) or \"noLongerMatches\" (the ad is live but no longer in the search), with daysOnline; an ad that comes back is \"reappeared\". At most 300 gone ads are checked per run. Checked only when the run reads every search completely (limits, date filters, unread pages or rejected requests skip the check, and the status message says why). Removed rows are charged like any other job.",
            "default": false
          },
          "includeUnchanged": {
            "title": "Monitoring: include unchanged jobs",
            "type": "boolean",
            "description": "Also return the ads that did not change, as rows with changeType \"unchanged\". They are saved rows, so each is charged like any other job; without this option unchanged ads are free.",
            "default": false
          },
          "onlyNew": {
            "title": "Monitoring: only new jobs",
            "type": "boolean",
            "description": "Return only ads the earlier runs have not seen; changed ads are remembered but not returned.",
            "default": false
          },
          "skipReposts": {
            "title": "Monitoring: skip reposted jobs",
            "type": "boolean",
            "description": "Do not return a new ad that is the same ad seen in an earlier run under another ID (the advertiser published it again). Skipped ads are not charged. Off = such ads are returned with isRepost true, repostOf and repostFirstSeenAt.",
            "default": false
          },
          "skipFirstRun": {
            "title": "Monitoring: silent first run",
            "type": "boolean",
            "description": "The first run with a Monitoring key only remembers what is on the website and returns nothing (no rows are charged, only the pages read); the following runs return what is new since then.",
            "default": false
          },
          "monitoringEarlyStop": {
            "title": "Monitoring: stop at known ads",
            "type": "boolean",
            "description": "With \"Sort by\" = newest: stop reading a search at the first page whose ads are all known and unchanged, so a frequent run reads only the newest ads instead of the whole search. Changes of older ads are then not seen, and it cannot be combined with \"include removed jobs\".",
            "default": false
          },
          "ignoreChangesIn": {
            "title": "Monitoring: ignore changes in",
            "type": "array",
            "description": "Fields whose change does not make an ad \"updated\". Changing this list makes every ad \"updated\" once.",
            "items": {
              "type": "string",
              "enum": [
                "title",
                "company",
                "salaryMin",
                "salaryMax",
                "salaryCurrency",
                "salaryPeriod",
                "location",
                "employmentType",
                "polishContractTypes",
                "workArrangement",
                "contentHash"
              ],
              "enumTitles": [
                "Title",
                "Company",
                "Salary from",
                "Salary to",
                "Currency",
                "Salary period",
                "Town",
                "Working time",
                "Contract types",
                "Workplace",
                "Text of the ad (contentHash)"
              ]
            }
          },
          "resetMonitoring": {
            "title": "Monitoring: start again",
            "type": "boolean",
            "description": "Forget what the earlier runs with this Monitoring key saw: this run returns everything as new.",
            "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}. Use it for e-mail or Teams through such a service."
          },
          "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 ads 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 ad (e.g. a monitoring run without new ads).",
            "default": true
          },
          "categoryIds": {
            "title": "Category IDs",
            "type": "array",
            "description": "Categories by the website's numbers (e.g. 1447 = Produkcja, 2445 = Kierowca) or paths (\"produkcja/obsluga-produkcji\"), added to \"Categories\".",
            "items": {
              "type": "string"
            }
          },
          "cityIds": {
            "title": "City IDs",
            "type": "array",
            "description": "Towns by the website's numbers (the cityId of a row of this actor, e.g. 17871 = Warszawa), added to \"Towns or voivodeships\".",
            "items": {
              "type": "string"
            }
          },
          "districtId": {
            "title": "District ID",
            "minimum": 0,
            "type": "integer",
            "description": "A district of the one town you search, by the website's number (search[district_id] in its URLs)."
          },
          "fastMode": {
            "title": "Fast mode",
            "type": "boolean",
            "description": "Fast mode reads up to about 4× faster (6 000 ads a minute instead of 1 500) 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. Small extra charge \"Fast mode\" per saved ad.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "No proxy needed. If the website starts rejecting the requests, use Apify Proxy with the RESIDENTIAL group and country Poland: every page read through a residential proxy is then charged as 3 extra pages (see Pricing).",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}