{ "openapi": "3.0.1", "info": { "title": "Pracuj Scraper [๐Ÿ’ฐ$2] โ€” Poland's #1 Job Board", "description": "๐Ÿ’ฐ $2 per 1,000 jobs. Pracuj Scraper extracts pracuj.pl listings โ€” structured salary min/max/currency ยท direct-employer vs agency flag ยท 30+ fields per listing. Incremental mode tracks new and changed jobs across scheduled runs.", "version": "0.1", "x-build-id": "oufvHhr9AEezfKYby" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/blackfalcondata~pracuj-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-blackfalcondata-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/blackfalcondata~pracuj-scraper/runs": { "post": { "operationId": "runs-sync-blackfalcondata-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/blackfalcondata~pracuj-scraper/run-sync": { "post": { "operationId": "run-sync-blackfalcondata-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 Term(s)", "type": "string", "description": "Job search keywords (e.g. 'software engineer', 'python developer')." }, "location": { "title": "๐Ÿ“ Location", "type": "string", "description": "City or region (e.g. 'Warszawa', 'Krakรณw', 'Wrocล‚aw')." }, "contractType": { "title": "๐Ÿ“ Contract Type", "enum": [ "", "0", "1", "2", "3", "4", "5", "6", "7" ], "type": "string", "description": "Filter by the type of contract offered. This is about the contract itself, not about who posted the offer โ€” for that use \"Posted By\" below.", "default": "" }, "postedBy": { "title": "๐Ÿข Posted By", "enum": [ "", "Company", "Agency" ], "type": "string", "description": "Show only offers posted directly by the hiring company, or only offers posted by recruitment agencies, using the portal's own classification. An agency here is a registered employment agency advertising for a client; consultancies that employ the candidate themselves count as direct employers, so this separates intermediaries rather than resolving the end client.", "default": "" }, "workMode": { "title": "๐Ÿ  Work Mode", "enum": [ "", "full-office", "hybrid", "home-office", "mobile" ], "type": "string", "description": "Filter by work mode.", "default": "" }, "positionLevel": { "title": "Position Level", "enum": [ "", "1", "17", "4", "18", "19", "5", "20", "6", "21" ], "type": "string", "description": "Filter by seniority level.", "default": "" }, "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.", "default": "" }, "withSalary": { "title": "With Salary Only", "type": "boolean", "description": "Only return offers that show salary.", "default": false }, "period": { "title": "Posted Within", "enum": [ "", "1", "3", "7", "14", "30" ], "type": "string", "description": "Only return offers posted within this period.", "default": "" }, "maxResults": { "title": "๐Ÿ’ฏ Max Results", "minimum": 0, "type": "integer", "description": "Maximum total results, across every search term and pasted URL in the run. 0 = unlimited. In Incremental Mode the scan itself is bounded to about 600 listings to keep runs predictable, and expiry detection is skipped whenever the full set could not be scanned.", "default": 25 }, "includeDetails": { "title": "๐Ÿ“‹ Include Full Details", "type": "boolean", "description": "Fetch full job details (description, technologies, apply URL). Slower but richer data.", "default": true }, "descriptionMaxLength": { "title": "โœ‚๏ธ Description Max Length", "minimum": 0, "type": "integer", "description": "Truncate description to N characters. 0 = no truncation.", "default": 0 }, "compact": { "title": "๐Ÿ“ฆ Compact Output", "type": "boolean", "description": "Return core fields only (for AI-agent/MCP workflows).", "default": false }, "incrementalMode": { "title": "โ™ป๏ธ Incremental Mode", "type": "boolean", "description": "Only return new or changed listings since the last run. Change detection compares the fields that appear in search results โ€” title, company, location, salary, dates, apply URL and the search-result summary. A change confined to the full job description or the structured salary breakdown is therefore not detected on its own, because reaching it would mean re-fetching the detail page of every listing in the scan rather than only the ones being returned.", "default": false }, "stateKey": { "title": "๐Ÿ”‘ State Key", "type": "string", "description": "Unique identifier for this tracked universe. Different stateKeys maintain independent state." }, "skipReposts": { "title": "๐Ÿšซ Skip Reposts", "type": "boolean", "description": "Exclude listings detected as reposts of previously seen jobs.", "default": false }, "telegramToken": { "title": "๐Ÿค– Telegram Bot Token", "type": "string", "description": "Telegram bot token from @BotFather. Required for Telegram notifications." }, "telegramChatId": { "title": "๐Ÿ’ฌ Telegram Chat ID", "type": "string", "description": "Telegram chat or channel ID where alerts are sent (e.g. \"-100123456789\" for a private group, or \"@yourchannel\")." }, "discordWebhookUrl": { "title": "๐ŸŽฎ Discord Webhook URL", "type": "string", "description": "Discord incoming webhook URL. Get one from Server Settings โ†’ Integrations โ†’ Webhooks." }, "slackWebhookUrl": { "title": "๐Ÿ’ผ Slack Webhook URL", "type": "string", "description": "Slack incoming webhook URL. Create at api.slack.com/messaging/webhooks." }, "whatsappPhoneNumberId": { "title": "๐Ÿ“ฑ WhatsApp Phone Number ID", "type": "string", "description": "WhatsApp Business phone number ID from Meta Business Manager (NOT the phone number itself โ€” the numeric ID shown next to your business number). Free service-conversation messages within 24 hours of last user-initiated contact." }, "whatsappAccessToken": { "title": "๐Ÿ” WhatsApp Access Token", "type": "string", "description": "Meta Cloud API access token with `whatsapp_business_messaging` scope. Get a permanent token from a system user in Meta Business Manager." }, "whatsappTo": { "title": "๐Ÿ“จ WhatsApp Recipient", "type": "string", "description": "Recipient phone in E.164 format (e.g. +48123456789). Recipient must have messaged your business number within the last 24 hours โ€” outside that window, free-form text is rejected by Meta." }, "webhookUrl": { "title": "๐Ÿช Generic Webhook URL", "type": "string", "description": "Generic webhook URL that receives a JSON POST with the full job payload + run metadata. Universal escape hatch for n8n / Make / Zapier / your own backend." }, "webhookHeaders": { "title": "๐Ÿ”‘ Webhook Headers", "type": "object", "description": "Optional headers (e.g. {\"Authorization\": \"Bearer xyz\"}) sent with the webhook POST." }, "notificationLimit": { "title": "๐Ÿ“Š Max Jobs Per Notification", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of jobs included in each notification message (1โ€“20). Excess jobs are still in the dataset; notifications get a summary line.", "default": 5 }, "notifyOnlyChanges": { "title": "๐Ÿ”„ Notify Only New/Updated", "type": "boolean", "description": "When Incremental Mode is on, only send notifications for NEW / UPDATED / REAPPEARED jobs. Has no effect outside incremental mode.", "default": false }, "descriptionFormat": { "title": "Description format", "enum": [ "all", "text", "html", "markdown" ], "type": "string", "description": "Pick a single description representation. `all` keeps every variant; `text` / `html` / `markdown` drop the others.", "default": "all" }, "excludeEmptyFields": { "title": "Exclude empty fields from output", "type": "boolean", "description": "Drop null, empty-string, and empty-array fields from each record before push. Smaller payloads for AI agents and dashboards.", "default": false }, "appConnector": { "title": "Send results to Notion (or another connected app)", "type": "string", "description": "Optional. Pick a connected app under Settings โ†’ API & Integrations to receive your results. Notion is supported today (a run-summary page); other MCP connectors are best-effort as Apify expands its catalog." }, "mcpIssueTeam": { "title": "Issue tracker team", "type": "string", "description": "Only when the connected app is an issue tracker: the team (name or ID) the summary issue is created under, if that app requires one." }, "startUrls": { "title": "๐Ÿ”— Paste / Direct URLs", "type": "array", "description": "Paste pracuj.pl URLs to scrape directly, instead of (or alongside) a keyword search. Both kinds work: a single offer page (โ€ฆ/praca/โ€ฆ,oferta,1004930710) is fetched on its own, and a search/listing page (โ€ฆ/praca/java;kw/warszawa;wp) is paginated like a normal search. Filters carried in a pasted URL win; the filters set above still apply to whatever that URL leaves unspecified, and a search term set above is searched as well. A URL whose filters cannot be read is skipped rather than widened into an unfiltered search. Max Results applies to the total, so raise it when pasting many URLs.", "items": { "type": "string" } }, "emitUnchanged": { "title": "๐Ÿ”„ Emit Unchanged Listings", "type": "boolean", "description": "When incremental mode is on, also emit listings whose content has not changed since the last run.", "default": false }, "emitExpired": { "title": "โšฐ๏ธ Emit Expired Listings", "type": "boolean", "description": "When incremental mode is on, also emit listings that were seen in an earlier run but are no longer posted. Because the offer is gone from the source, these rows are minimal markers โ€” jobId, changeType \"EXPIRED\", expiredAt, and the first/last-seen timestamps โ€” meant for closing your own copy of a listing. They are dataset items like any other, so they count towards Max Results and are charged the same way.", "default": false } } }, "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 } } } } } } } } } }