{
  "openapi": "3.0.1",
  "info": {
    "title": "Polish Jobs Aggregator: Pracuj.pl, OLX, JustJoin & 7 more",
    "description": "Ten Polish job boards in one run: Pracuj.pl, OLX Praca, Praca.gov.pl, Praca.pl, RocketJobs, Aplikuj, InfoPraca, JustJoin.it, NoFluffJobs, theprotocol. Duplicates merged, salary, monitoring, market summary. Oferty pracy w jednym miejscu.",
    "version": "0.0",
    "x-build-id": "qA2OrlgthD7vdJtcd"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tsutseisoftware~polish-jobs-aggregator/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tsutseisoftware-polish-jobs-aggregator",
        "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~polish-jobs-aggregator/runs": {
      "post": {
        "operationId": "runs-sync-tsutseisoftware-polish-jobs-aggregator",
        "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~polish-jobs-aggregator/run-sync": {
      "post": {
        "operationId": "run-sync-tsutseisoftware-polish-jobs-aggregator",
        "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": {
          "sources": {
            "title": "Job portals",
            "type": "array",
            "description": "Portals to read. By default the 7 general job boards; pick JustJoin.it, NoFluffJobs and theprotocol.it for IT jobs. A job found on several portals is one row and pays the price of its cheapest portal once. Pracuj.pl uses a Polish residential proxy (included in the price).",
            "items": {
              "type": "string",
              "enum": [
                "pracuj",
                "olx-praca",
                "praca-gov-pl",
                "praca-pl",
                "rocketjobs",
                "aplikuj",
                "infopraca",
                "justjoin",
                "nofluffjobs",
                "theprotocol"
              ],
              "enumTitles": [
                "Pracuj.pl ($0.94 / 1 000)",
                "OLX Praca ($1.19 / 1 000)",
                "Praca.gov.pl (labour offices) ($2.65 / 1 000)",
                "Praca.pl ($1.08 / 1 000)",
                "RocketJobs.pl ($0.80 / 1 000)",
                "Aplikuj.pl ($0.36 / 1 000)",
                "InfoPraca.pl ($0.89 / 1 000)",
                "JustJoin.it (IT) ($0.56 / 1 000)",
                "NoFluffJobs (IT) ($0.59 / 1 000)",
                "theprotocol.it (IT) ($0.84 / 1 000)"
              ]
            },
            "default": [
              "pracuj",
              "olx-praca",
              "praca-gov-pl",
              "praca-pl",
              "rocketjobs",
              "aplikuj",
              "infopraca"
            ]
          },
          "searchQueries": {
            "title": "Search terms",
            "type": "array",
            "description": "Job titles or keywords in Polish, e.g. \"magazynier\", \"kierowca\", \"księgowa\", \"python\". Each term is a separate search on every portal. Empty = the newest jobs.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Towns",
            "type": "array",
            "description": "Polish towns, e.g. \"Warszawa\", \"Kraków\", \"Wrocław\" (diacritics optional). Each town is a separate search on every portal.",
            "items": {
              "type": "string"
            }
          },
          "voivodeships": {
            "title": "Voivodeships (województwa)",
            "type": "array",
            "description": "Whole voivodeships. With towns as well, the portals read both (Pracuj.pl and the IT boards then read the towns only).",
            "items": {
              "type": "string",
              "enum": [
                "dolnoslaskie",
                "kujawsko-pomorskie",
                "lubelskie",
                "lubuskie",
                "lodzkie",
                "malopolskie",
                "mazowieckie",
                "opolskie",
                "podkarpackie",
                "podlaskie",
                "pomorskie",
                "slaskie",
                "swietokrzyskie",
                "warminsko-mazurskie",
                "wielkopolskie",
                "zachodniopomorskie"
              ],
              "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"
              ]
            }
          },
          "radiusKm": {
            "title": "Distance from the town (km)",
            "minimum": 0,
            "maximum": 200,
            "type": "integer",
            "description": "With \"Towns\": also jobs up to this distance, on the portals that search by distance (Pracuj.pl, OLX, Praca.gov.pl, Aplikuj.pl, InfoPraca, JustJoin.it, RocketJobs.pl; the nearest distance a portal offers is used). Empty = each portal's default."
          },
          "maxItems": {
            "title": "Max jobs",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of jobs saved (after merging duplicates). 0 = no limit.",
            "default": 200
          },
          "maxItemsPerSource": {
            "title": "Max jobs per portal",
            "minimum": 0,
            "type": "integer",
            "description": "How many jobs each portal reads at most. 0 = its share of \"Max jobs\" (Max jobs ÷ number of portals + 20 %).",
            "default": 0
          },
          "maxPagesPerSearch": {
            "title": "Max pages per search",
            "minimum": 0,
            "maximum": 500,
            "type": "integer",
            "description": "How many result pages each portal reads per search term and town. Empty or 0 = about twice what the portal needs for its share of \"Max jobs\" (at most 50). Raise it for narrow filters: pages a portal reads beyond its saved jobs pay a small fee of $0.15 per 1 000 (Pracuj.pl $1.00)."
          },
          "workArrangement": {
            "title": "Work mode",
            "type": "array",
            "description": "Only jobs with one of these work modes. InfoPraca has no such filter and is not read with it.",
            "items": {
              "type": "string",
              "enum": [
                "onsite",
                "hybrid",
                "remote"
              ],
              "enumTitles": [
                "On site (stacjonarna)",
                "Hybrid (hybrydowa)",
                "Remote (zdalna, praca zdalna)"
              ]
            }
          },
          "minSalary": {
            "title": "Minimum monthly salary (PLN)",
            "minimum": 0,
            "type": "integer",
            "description": "Only jobs whose monthly salary reaches at least this amount in PLN (the top of the range; hourly rates are converted at standard full-time hours). Jobs without a salary are left out."
          },
          "onlyWithSalary": {
            "title": "Only with salary",
            "type": "boolean",
            "description": "Only jobs that show a salary (widełki).",
            "default": false
          },
          "contractTypes": {
            "title": "Contract types",
            "type": "array",
            "description": "Only jobs offering one of these contracts (UoP, B2B, zlecenie…). A portal without any of them, or without a contract filter (InfoPraca), is not read.",
            "items": {
              "type": "string",
              "enum": [
                "employment",
                "b2b",
                "mandate",
                "specificTask",
                "internship",
                "temporaryWork",
                "agency",
                "replacement"
              ],
              "enumTitles": [
                "Employment contract (umowa o pracę, UoP)",
                "B2B",
                "Mandate contract (umowa zlecenie)",
                "Specific-task contract (umowa o dzieło)",
                "Internship (staż, praktyki)",
                "Temporary work (praca tymczasowa)",
                "Agency contract (umowa agencyjna)",
                "Replacement (na zastępstwo)"
              ]
            }
          },
          "seniority": {
            "title": "Position level",
            "type": "array",
            "description": "Only jobs for these levels. OLX, Praca.gov.pl and InfoPraca have no level filter and are not read with it.",
            "items": {
              "type": "string",
              "enum": [
                "intern",
                "junior",
                "mid",
                "senior",
                "expert",
                "manager"
              ],
              "enumTitles": [
                "Intern / trainee",
                "Junior",
                "Mid / regular",
                "Senior",
                "Expert",
                "Manager / lead / director"
              ]
            }
          },
          "postedWithinDays": {
            "title": "Posted within days",
            "minimum": 0,
            "maximum": 365,
            "type": "integer",
            "description": "Only jobs published or refreshed in the last N days. Empty = any age."
          },
          "excludeKeywords": {
            "title": "Exclude words in the title",
            "type": "array",
            "description": "Leave out jobs with one of these words in the title.",
            "items": {
              "type": "string"
            }
          },
          "companies": {
            "title": "Only these companies",
            "type": "array",
            "description": "Only jobs of companies whose name contains one of these.",
            "items": {
              "type": "string"
            }
          },
          "excludeCompanies": {
            "title": "Exclude companies",
            "type": "array",
            "description": "Leave out jobs of companies whose name contains one of these (e.g. agencies).",
            "items": {
              "type": "string"
            }
          },
          "includeTerms": {
            "title": "Keep only jobs mentioning",
            "type": "array",
            "description": "Keep a job only if its title, company, category, technologies or description mention one of these (diacritics optional), e.g. \"laborant\", \"chemi\". The relevance filter a portal's own search cannot do. The description is there with \"Add description and details\" (OLX and Praca.gov.pl always).",
            "items": {
              "type": "string"
            }
          },
          "includeTermsMode": {
            "title": "Keep only jobs mentioning: mode",
            "enum": [
              "any",
              "all"
            ],
            "type": "string",
            "description": "\"At least one term\" for a list of synonyms, \"All terms\" when every one must be there.",
            "default": "any"
          },
          "excludeTerms": {
            "title": "Leave out jobs mentioning",
            "type": "array",
            "description": "Leave out a job whose title, company, category or description mentions one of these, e.g. \"staż\", \"praktyki\", \"agencja pracy\".",
            "items": {
              "type": "string"
            }
          },
          "excludeShiftWork": {
            "title": "No shift work",
            "type": "boolean",
            "description": "Leave out jobs marked as shift or night work by the portal or saying so in their text (\"praca zmianowa\", \"dwie zmiany\", \"zmiana nocna\"; \"jedna zmiana\" is kept). shiftWork in the output says what was found; null means nothing was said, not day work.",
            "default": false
          },
          "strictLocation": {
            "title": "Only the towns themselves",
            "type": "boolean",
            "description": "Keep only jobs in the towns you gave, not the nearby places the portals add (e.g. Pruszków for Warszawa).",
            "default": false
          },
          "includeDetails": {
            "title": "Add description and details",
            "type": "boolean",
            "description": "Open each job page for the description, requirements, benefits and other details (slower). A job page pays what the portal's own scraper charges for it: Pracuj.pl $0.39, Praca.gov.pl (labour offices) $0.20, Praca.pl $0.35, RocketJobs.pl $0.15, Aplikuj.pl $1.25, InfoPraca.pl $0.25, JustJoin.it $0.15, NoFluffJobs $0.05, theprotocol.it $0.10 per 1 000 jobs; OLX ads always have their text. A job on several portals pays its page once, at the cheapest portal whose page was read.",
            "default": false
          },
          "mergeDuplicates": {
            "title": "Merge duplicates across portals",
            "type": "boolean",
            "description": "One row per job when the same job is on several portals, with all its portals and links in \"portals\" and \"sources\". Off = one row per ad.",
            "default": true
          },
          "descriptionFormat": {
            "title": "Description format",
            "enum": [
              "text",
              "markdown",
              "html"
            ],
            "type": "string",
            "description": "Format of \"description\", the same for every portal: plain text, Markdown (headings and lists, good for AI agents and Notion) or simple HTML (<h3>, <ul>, <p>).",
            "default": "text"
          },
          "compactOutput": {
            "title": "Compact output",
            "type": "boolean",
            "description": "Only the core fields (id, portals, URL, title, company, town, voivodeship, salary, contract types, work mode, level, dates), plus the description and the monitoring fields when those are on. Smaller rows for AI agents, MCP clients and spreadsheets.",
            "default": false
          },
          "onlyNewOrChanged": {
            "title": "Monitoring: only new or changed jobs",
            "type": "boolean",
            "description": "Return only jobs that are new or whose title, company, salary, town or portals changed since the previous run with the same Monitoring key. Unchanged jobs are not saved and pay only a small check fee ($0.02 per 1 000, see the README).",
            "default": false
          },
          "includeRemovedJobs": {
            "title": "Monitoring: include removed jobs",
            "type": "boolean",
            "description": "Also save the jobs of the previous run that are gone from every portal that had them (changeType \"removed\"), each once. Reported only for portals whose search was read to the end, so set \"Max jobs\" high enough (or 0) for the whole search. A removed job pays like a saved one.",
            "default": false
          },
          "monitoringKey": {
            "title": "Monitoring: key",
            "type": "string",
            "description": "Name of the remembered state; use a different key for each search you monitor."
          },
          "telegramBotToken": {
            "title": "Notifications: Telegram bot token",
            "type": "string",
            "description": "Token of your Telegram bot (from @BotFather). Used with \"Telegram chat ID\"."
          },
          "telegramChatId": {
            "title": "Notifications: Telegram chat ID",
            "type": "string",
            "description": "Chat, group or channel ID the bot writes to (e.g. -1001234567890)."
          },
          "slackWebhookUrl": {
            "title": "Notifications: Slack webhook URL",
            "type": "string",
            "description": "Incoming webhook of your Slack channel (https://hooks.slack.com/services/...)."
          },
          "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."
          },
          "webhookUrl": {
            "title": "Notifications: webhook URL",
            "type": "string",
            "description": "Any HTTPS URL: 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
          },
          "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}