{ "openapi": "3.0.1", "info": { "title": "Pracuj.pl Scraper · Poland Jobs, Salaries & Alerts", "description": "Search Pracuj.pl — Poland's #1 job board — by keyword, city & filters. Structured salary (min/max/currency), contract, work mode + AI summary as clean JSON/CSV. Incremental monitoring emits only NEW jobs; Telegram/Slack/Discord alerts included. Pure HTTP — $0.99 per 1,000 jobs.", "version": "0.0", "x-build-id": "hSropVqaIYn1KYp38" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~pracuj-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-pracuj-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/memo23~pracuj-scraper/runs": { "post": { "operationId": "runs-sync-memo23-pracuj-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/memo23~pracuj-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-pracuj-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": { "query": { "title": "Search keywords", "type": "string", "description": "What to search for, e.g. `python developer`, `księgowa`, `kierowca C+E`. Leave empty to browse by location/filters only." }, "location": { "title": "City", "type": "string", "description": "City or town, e.g. `Warszawa`, `Kraków`, `Gdańsk`. Combine with **Radius** to widen the net." }, "radiusKm": { "title": "Radius (km) around the city", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only with **City** set. `0` = the city itself; Pracuj.pl's own default is 30 km." }, "region": { "title": "Region (voivodeship)", "enum": [ "", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17" ], "type": "string", "description": "Filter by Polish region — or `Abroad` for offers outside Poland." }, "positionLevels": { "title": "Position levels", "type": "array", "description": "Seniority filter (multiple allowed). Codes verified against Pracuj.pl's own listings.", "items": { "type": "string", "enum": [ "1", "3", "17", "4", "18", "19", "5", "20", "6", "21" ], "enumTitles": [ "Intern / Trainee", "Assistant", "Junior specialist", "Specialist (Mid)", "Senior specialist", "Expert", "Manager / Coordinator", "Manager", "Director", "President / Board" ] } }, "contractTypes": { "title": "Contract types", "type": "array", "description": "Contract filter (multiple allowed).", "items": { "type": "string", "enum": [ "0", "1", "2", "3", "4", "5", "6", "7" ], "enumTitles": [ "Employment contract (umowa o pracę)", "Specific-task (umowa o dzieło)", "Commission (umowa zlecenie)", "B2B contract", "Replacement (na zastępstwo)", "Agency agreement (umowa agencyjna)", "Temporary (praca tymczasowa)", "Internship (staż / praktyki)" ] } }, "workModes": { "title": "Work modes", "type": "array", "description": "On-site / hybrid / remote / mobile (multiple allowed).", "items": { "type": "string", "enum": [ "full-office", "hybrid", "home-office", "mobile" ], "enumTitles": [ "On-site (stacjonarna)", "Hybrid (hybrydowa)", "Remote (zdalna)", "Mobile (mobilna)" ] } }, "workSchedules": { "title": "Work schedules", "type": "array", "description": "Full-time / part-time / additional (multiple allowed).", "items": { "type": "string", "enum": [ "0", "1", "2" ], "enumTitles": [ "Full-time (pełny etat)", "Part-time (część etatu)", "Additional / temporary (dodatkowa)" ] } }, "postedWithinDays": { "title": "Posted within", "enum": [ "", "1", "3", "7", "14", "30" ], "type": "string", "description": "Only offers published in this window." }, "minSalaryPln": { "title": "Minimum salary (PLN/month)", "minimum": 0, "type": "integer", "description": "Only offers with salary at or above this. Set `1` to mean \"any offer that discloses salary\" — or use the checkbox below." }, "withSalaryOnly": { "title": "Only offers with disclosed salary", "type": "boolean", "description": "Skip offers that hide the salary. Ignored when **Minimum salary** is set.", "default": false }, "directEmployersOnly": { "title": "Direct employers only (skip recruitment agencies)", "type": "boolean", "description": "Excludes offers posted by recruitment agencies, using Pracuj.pl's own classification — applied at the source, costs no extra requests.", "default": false }, "oneClickApplyOnly": { "title": "One-click apply offers only", "type": "boolean", "description": "Only offers you can apply to without leaving Pracuj.pl.", "default": false }, "superOffersOnly": { "title": "SuperOffers only", "type": "boolean", "description": "Only offers flagged as SuperOferta.", "default": false }, "ukrainianFriendly": { "title": "Ukrainian-friendly offers only", "type": "boolean", "description": "Only offers marked as welcoming Ukrainian-speaking candidates.", "default": false }, "startUrls": { "title": "Pracuj.pl search URLs", "type": "array", "description": "Full Pracuj.pl /praca/ search URLs. Each is paginated automatically until `Maximum items` is reached.", "items": { "type": "string" } }, "incrementalMode": { "title": "Incremental mode — emit only new & updated offers", "type": "boolean", "description": "Each row gets a `changeStatus` of `NEW`, `UPDATED` or `REPOST`. Typically cuts recurring-run costs by 80–95%.", "default": false }, "stateKey": { "title": "State key", "type": "string", "description": "Name for this monitor's baseline. Use a different key per saved search (e.g. `python-warszawa`) so schedules don't share state." }, "skipReposts": { "title": "Skip reposts", "type": "boolean", "description": "Drop \"new\" offers that are really the same company+title+workplace as a previously seen offer (expired and re-published).", "default": false }, "telegramToken": { "title": "Telegram bot token", "type": "string", "description": "Your bot's token from @BotFather. Used together with **Telegram chat ID**." }, "telegramChatId": { "title": "Telegram chat ID", "type": "string", "description": "Chat/channel/group ID the bot should post to (e.g. `123456789` or `-100…` for channels)." }, "slackWebhookUrl": { "title": "Slack webhook URL", "type": "string", "description": "Slack incoming-webhook URL (https://hooks.slack.com/services/…)." }, "discordWebhookUrl": { "title": "Discord webhook URL", "type": "string", "description": "Discord channel webhook URL (https://discord.com/api/webhooks/…)." }, "webhookUrl": { "title": "Generic webhook URL", "type": "string", "description": "POSTs a JSON payload (run id, dataset id, counts, top jobs) to this URL at the end of the run." }, "webhookHeaders": { "title": "Webhook headers", "type": "object", "description": "Extra HTTP headers for the generic webhook, e.g. `{\"authorization\": \"Bearer …\"}`." }, "notificationLimit": { "title": "Max jobs per notification", "minimum": 1, "maximum": 25, "type": "integer", "description": "How many job lines to include in a message (links included).", "default": 10 }, "notifyOnlyChanges": { "title": "Notify only when there is something new", "type": "boolean", "description": "Stay silent when a monitoring run finds no new or updated offers.", "default": true }, "flatten": { "title": "Flatten nested fields for CSV-friendly output", "type": "boolean", "description": "When enabled (default), nested objects/arrays (e.g. `locations`, `technologies`, `responsibilities`) are flattened into CSV-friendly columns. Disable to keep the full nested JSON.", "default": true }, "compact": { "title": "Compact output (AI-agent / MCP friendly)", "type": "boolean", "description": "Core fields only — title, company, structured salary, locations, work mode, level, contract, dates, URL. Pipe straight into an LLM context or ATS without stripping extras.", "default": false }, "fetchDetails": { "title": "Fetch full job details (description, responsibilities, skills, technologies, apply link)", "type": "boolean", "description": "If enabled, opens each job's detail page to add the **full description**, **responsibilities**, **required & optional skills**, **technologies**, **job categories**, the **apply URL** and the **contact phone**. Adds one extra request per job and charges an `additional-data` event each time. Leave off for the fast/cheap search-only output.", "default": false }, "enrichEmails": { "title": "Enrich with employer contact emails (experimental, billed per email)", "type": "boolean", "description": "If enabled, tries to find a contact email for each employer by discovering the company's website (Clearbit) and reading its contact/about pages. Adds contactEmail + contactWebsite columns. Best-effort, billed per email found; never charged for misses. (Independent of the free `extractedEmails` column, which regex-scans the listing text at no cost.)", "default": false }, "maxItems": { "title": "Maximum items to scrape", "minimum": 1, "type": "integer", "description": "Hard cap on the number of jobs collected. Use this cap to control billing.", "default": 10000 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "type": "integer", "description": "Maximum number of rows processed in parallel (mainly relevant when detail-fetch or employer-email enrichment is on). 6-12 is the sweet spot.", "default": 8 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "type": "integer", "description": "Number of retries before a failed request is given up.", "default": 5 }, "proxy": { "title": "Proxy configuration (optional override)", "type": "object", "description": "Leave empty — the actor already routes all traffic through its own built-in residential proxy at no extra cost to you. Only set this if you want to use your own proxies." } } }, "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 } } }, "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 } } } } } } } } } }