{
  "openapi": "3.0.1",
  "info": {
    "title": "Praca.gov.pl Scraper ($1.19/1K): Polish Labour Office Jobs",
    "description": "Scrape praca.gov.pl (CBOP), the job offers of all Polish labour offices: salary per month and hour, employer, town, voivodeship, contract, duties and requirements. Website filters, optional details, monitoring of new and removed offers, notifications. Unofficial. Oferty pracy urzędów pracy.",
    "version": "0.0",
    "x-build-id": "yh0KdgAwZznCQNwAn"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tsutseisoftware~praca-gov-pl-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tsutseisoftware-praca-gov-pl-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~praca-gov-pl-scraper/runs": {
      "post": {
        "operationId": "runs-sync-tsutseisoftware-praca-gov-pl-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~praca-gov-pl-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-tsutseisoftware-praca-gov-pl-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": {
          "searchTerms": {
            "title": "Search keywords",
            "type": "array",
            "description": "Words of the job title, in Polish, e.g. \"kierowca\", \"magazynier\", \"księgowa\", \"opiekunka\". The website searches the position of the offers; several lines = offers that match any of them. Empty = all offers that match the rest.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Towns",
            "type": "array",
            "description": "Towns by name, e.g. Warszawa, Kraków, Zielona Góra (for a name that several places share, add the voivodeship or county after a comma: \"Dąbrowa, opolskie\"). A voivodeship name works too. Offers for the whole of Poland are included, as on the website. A town the website does not know is reported in the status message.",
            "items": {
              "type": "string"
            }
          },
          "radiusKm": {
            "title": "Distance from the town",
            "minimum": 0,
            "maximum": 75,
            "type": "integer",
            "description": "Also offers within this many kilometres of each town. The website knows 5, 10, 20, 30, 50, 75 km; another value is rounded up to the next one. 0 = the town only.",
            "default": 0
          },
          "voivodeships": {
            "title": "Voivodeships",
            "type": "array",
            "description": "Only offers in these voivodeships.",
            "items": {
              "type": "string",
              "enum": [
                "02",
                "04",
                "06",
                "08",
                "10",
                "12",
                "14",
                "16",
                "18",
                "20",
                "22",
                "24",
                "26",
                "28",
                "30",
                "32"
              ],
              "enumTitles": [
                "dolnośląskie",
                "kujawsko-pomorskie",
                "lubelskie",
                "lubuskie",
                "łódzkie",
                "małopolskie",
                "mazowieckie",
                "opolskie",
                "podkarpackie",
                "podlaskie",
                "pomorskie",
                "śląskie",
                "świętokrzyskie",
                "warmińsko-mazurskie",
                "wielkopolskie",
                "zachodniopomorskie"
              ]
            }
          },
          "startUrls": {
            "title": "Offer URLs",
            "type": "array",
            "description": "URLs of offers on oferty.praca.gov.pl (https://oferty.praca.gov.pl/portal/lista-ofert/szczegoly-oferty/…) or their IDs, e.g. to refresh offers you already have. Each is read from its page. For a search use the inputs above.",
            "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 offers saved. You pay per saved offer. 0 = no limit (the database has about 16 500 offers).",
            "default": 100
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "newest",
              "oldest",
              "expiringSoon"
            ],
            "type": "string",
            "description": "Order of the website's search. With a limit you get the first offers in this order.",
            "default": "newest"
          },
          "includeDetails": {
            "title": "Add details (add-on)",
            "type": "boolean",
            "description": "Adds the offer number, number of vacancies, occupation and its code, employer tax ID (NIP), sector, type and website, full address of the workplace with postal code, county and municipality, hours per week, working hours, shifts, work mode, salary system, bonuses and benefits, immediate start, temporary work, accommodation and meals, the required education, languages, licences and occupations (as lists), nice-to-have skills, required documents and the labour office's address and phone.",
            "default": false
          },
          "offerTypes": {
            "title": "Offer types",
            "type": "array",
            "description": "Only offers of these kinds (most are job offers; the others are internships, apprenticeships and volunteering).",
            "items": {
              "type": "string",
              "enum": [
                "job",
                "internshipLabourOffice",
                "internship",
                "apprenticeship",
                "studentApprenticeship",
                "adultVocationalTraining",
                "volunteering"
              ],
              "enumTitles": [
                "Job offer (oferta pracy)",
                "Internship from the labour office (staż z urzędu pracy)",
                "Internship (staż)",
                "Apprenticeship (praktyka)",
                "Student apprenticeship (praktyka studencka)",
                "Vocational training of adults (przygotowanie zawodowe dorosłych)",
                "Volunteering (wolontariat)"
              ]
            }
          },
          "contractTypes": {
            "title": "Contract types",
            "type": "array",
            "description": "Only offers with one of these contracts.",
            "items": {
              "type": "string",
              "enum": [
                "employment",
                "mandate",
                "specificTask",
                "other"
              ],
              "enumTitles": [
                "Employment contract (umowa o pracę)",
                "Mandate contract (umowa zlecenie)",
                "Contract for specific work (umowa o dzieło)",
                "Other (appointment, managerial contract, agency…)"
              ]
            }
          },
          "workModes": {
            "title": "Work mode",
            "type": "array",
            "description": "Only offers with one of these work modes (on site, hybrid, remote).",
            "items": {
              "type": "string",
              "enum": [
                "hybrid",
                "onSite",
                "remote"
              ],
              "enumTitles": [
                "Hybrid",
                "On site",
                "Remote"
              ]
            }
          },
          "workingTime": {
            "title": "Working time up to",
            "enum": [
              "quarter",
              "half",
              "threeQuarters",
              "full"
            ],
            "type": "string",
            "description": "Only offers with at most this share of full-time work (the website's \"wymiar etatu\")."
          },
          "minSalary": {
            "title": "Salary from (PLN)",
            "minimum": 0,
            "type": "integer",
            "description": "Only offers whose gross salary reaches this amount (the website compares the amounts as written, so hourly rates are compared as they are)."
          },
          "maxSalary": {
            "title": "Salary up to (PLN)",
            "minimum": 0,
            "type": "integer",
            "description": "Only offers whose gross salary starts at this amount or less."
          },
          "postedWithinDays": {
            "title": "Posted in the last N days",
            "minimum": 0,
            "type": "integer",
            "description": "Only offers added to the database in the last N days."
          },
          "country": {
            "title": "Country",
            "enum": [
              "any",
              "poland",
              "abroad"
            ],
            "type": "string",
            "description": "The website's choice between Polish offers and offers abroad (EURES).",
            "default": "any"
          },
          "immediateStart": {
            "title": "Immediate start only",
            "type": "boolean",
            "description": "Only offers marked \"zatrudnienie od zaraz\".",
            "default": false
          },
          "temporaryWork": {
            "title": "Temporary work only",
            "type": "boolean",
            "description": "Only offers of temporary work (praca tymczasowa).",
            "default": false
          },
          "forDisabled": {
            "title": "For people with disabilities only",
            "type": "boolean",
            "description": "Only offers open to people with disabilities.",
            "default": false
          },
          "accommodation": {
            "title": "Accommodation provided only",
            "type": "boolean",
            "description": "Only offers where the employer provides accommodation.",
            "default": false
          },
          "meals": {
            "title": "Meals provided only",
            "type": "boolean",
            "description": "Only offers where the employer provides meals.",
            "default": false
          },
          "excludeKeywords": {
            "title": "Title must not contain",
            "type": "array",
            "description": "Skip offers whose title has any of these words (without diacritics and case).",
            "items": {
              "type": "string"
            }
          },
          "excludeCompanies": {
            "title": "Exclude companies",
            "type": "array",
            "description": "Skip offers of employers whose name has any of these words.",
            "items": {
              "type": "string"
            }
          },
          "excludeRegisteredOnly": {
            "title": "Exclude offers for registered jobseekers only",
            "type": "boolean",
            "description": "Skip offers that the labour office gives only to people registered with it (onlyRegisteredJobseekers).",
            "default": false
          },
          "excludeWholePoland": {
            "title": "Exclude offers for the whole of Poland",
            "type": "boolean",
            "description": "The website adds offers for the whole of Poland (\"Cała Polska\", about 1 % of all offers) to every town and voivodeship search, where they can be a fifth of the results. Turn on to keep only offers in the places you chose.",
            "default": false
          },
          "excludeHiddenEmployer": {
            "title": "Exclude offers without the employer's name",
            "type": "boolean",
            "description": "Skip offers where the labour office keeps the employer to itself (\"kontakt przez PUP\", about 7 %).",
            "default": false
          },
          "onlyNewOrChanged": {
            "title": "Monitoring: only new or changed jobs",
            "type": "boolean",
            "description": "Save only offers that are new or changed since the previous run with the same Monitoring key (changed = title, employer, salary, place, contract, working time, end date, duties or requirements). Unchanged offers are free; each search request 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 offers that were in the previous run and are gone, as rows with changeType \"removed\" and removedReason \"expired\" (its end date passed) or \"ended\" (the website no longer shows it, e.g. the job was filled); an offer that comes back is \"reappeared\". An expired offer needs no request; the others are checked on their page (at most 300 per run, the rest in the next run), and an offer the website still shows is not reported. Checked only when the run reads the whole search (limits, \"Posted in the last N days\", offer URLs, unread pages or rejected requests skip the check, and the status message says why). Removed rows 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}. 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 offers 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 offer (e.g. a monitoring run without new offers).",
            "default": true
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "No proxy by default: the website answers Apify's IP addresses. If it starts rejecting requests, try Apify Proxy (automatic). A RESIDENTIAL proxy is not needed; if you choose it, every request through it is charged as 3 extra pages (see Pricing), because that traffic is paid by the megabyte.",
            "default": {
              "useApifyProxy": false
            }
          },
          "exportFormats": {
            "title": "Extra export formats",
            "type": "array",
            "description": "Off by default. Printable HTML report: the results as a clean, branded table with the main columns, made for printing, saving as PDF or sending to someone; for working with the data use Excel or CSV, which have every field. Markdown table: the same columns as text for AI tools, docs or GitHub. The Output tab links the files. Each file has the overview columns of every saved row and nothing is left out, so a run with tens of thousands of rows makes a file of tens of MB that can be slow to open; for big runs use the dataset or its Excel export. Excel (XLSX), CSV and JSON are always in the Output tab and under Export, at no extra cost.",
            "items": {
              "type": "string",
              "enum": [
                "html",
                "markdown"
              ],
              "enumTitles": [
                "Printable HTML report",
                "Markdown table"
              ]
            },
            "default": []
          },
          "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}