{ "openapi": "3.0.1", "info": { "title": "Pracuj.pl Job Scraper - Poland Jobs", "description": "Scrape job listings from Pracuj.pl, Poland's #1 job board. Extract jobs with salary ranges (PLN), company profiles, requirements, benefits, and application URLs. Supports multiple queries, employment types, and remote filtering.", "version": "1.2", "x-build-id": "r2GdARlYdaJCxlFLl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/santamaria-automations~pracuj-pl-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-santamaria-automations-pracuj-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/santamaria-automations~pracuj-pl-scraper/runs": { "post": { "operationId": "runs-sync-santamaria-automations-pracuj-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/santamaria-automations~pracuj-pl-scraper/run-sync": { "post": { "operationId": "run-sync-santamaria-automations-pracuj-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": { "searchQueries": { "title": "Search Keywords", "type": "array", "description": "One or more search keywords (e.g. 'Java Developer', 'Product Manager'). Each keyword runs as a separate search. Results are deduplicated across queries.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (optional)", "type": "array", "description": "Direct Pracuj.pl search URLs to crawl instead of building from keywords. Mutually exclusive with searchQueries.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "location": { "title": "Location", "type": "string", "description": "City or voivodeship name (e.g. 'Warszawa', 'Kraków', 'Wrocław', 'Mazowieckie'). Leave empty to search all of Poland." }, "includeJobDetails": { "title": "Include Full Job Details", "type": "boolean", "description": "When enabled, visits each job detail page to extract full description, requirements, responsibilities, benefits, and apply URL. When disabled, only listing-page data is returned (faster, cheaper).", "default": true }, "includeCompanyDetails": { "title": "Include Company Details", "type": "boolean", "description": "Also fetch each unique employer's Pracuj.pl profile page for the About text, other open roles, website, and any published contact fields. Deduplicated per employer within a run. Implies includeJobDetails.", "default": false }, "searchQuery": { "title": "Search Keyword (single, legacy)", "type": "string", "description": "Single search keyword (backward compatible). Use 'searchQueries' for multiple keywords." }, "category": { "title": "Category", "type": "string", "description": "Optional industry category filter (free text, e.g. 'IT', 'Finanse', 'Sprzedaż')." }, "employmentType": { "title": "Employment Type", "enum": [ "", "employment", "mandate-contract", "b2b", "contract-work", "agency-agreement", "internship", "temporary-staffing" ], "type": "string", "description": "Filter by contract / employment type", "default": "" }, "remote": { "title": "Remote only", "type": "boolean", "description": "When enabled, returns only jobs that allow remote work.", "default": false }, "maxResultsPerQuery": { "title": "Max Results per Query", "minimum": 1, "type": "integer", "description": "Maximum results per search keyword. Each query gets up to this many results (deduplicated).", "default": 100 }, "maxResults": { "title": "Max Total Results", "minimum": 0, "type": "integer", "description": "Total cap across all queries. Set to 0 for unlimited (each query limited by maxResultsPerQuery).", "default": 0 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Pracuj.pl returns HTTP 403 to datacenter IPs, so Apify proxy is enabled by default. Turn off only if you're routing through your own proxy pool via the standard Apify proxy config object.", "default": { "useApifyProxy": true } }, "sortBy": { "title": "Sort order", "enum": [ "newest", "relevance" ], "type": "string", "description": "How to order results. Pracuj.pl's SERP does not expose a stable server-side sort parameter, so 'newest' is applied client-side after collection using each offer's posted_at timestamp — recommended for scheduled scrapes so the freshest jobs land first. 'relevance' streams items in the site's native SERP order (matches what a browser user sees).", "default": "newest" } } }, "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 } } } } } } } } } }