{ "openapi": "3.0.1", "info": { "title": "Jobs.cz Scraper", "description": "[💰 $0.90 / 1K] Extract job listings from Jobs.cz, the largest job board in the Czech Republic. Search by keyword and location, filter by employment type, work arrangement, and date posted, or paste Jobs.cz URLs to get titles, companies, salaries, descriptions, and apply links.", "version": "1.0", "x-build-id": "pybbcNtmkMbNBb8iH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~jobs-cz-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-jobs-cz-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/solidcode~jobs-cz-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-jobs-cz-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/solidcode~jobs-cz-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-jobs-cz-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", "maxItems": 50, "type": "array", "description": "Job titles, skills, or keywords to search for, such as 'vývojář', 'programátor', or 'účetní'. Each keyword runs a separate search and results are merged and de-duplicated. Leave empty if you only want to use the direct search URLs below.", "items": { "type": "string" } }, "locations": { "title": "Locations", "maxItems": 50, "type": "array", "description": "One or more city or region names, such as 'Praha', 'Brno', or 'Ostrava'. Each keyword is searched in each location. Leave empty to search the whole Czech Republic.", "items": { "type": "string" } }, "startUrls": { "title": "Direct Jobs.cz Search URLs", "maxItems": 50, "type": "array", "description": "Paste full Jobs.cz search-result URLs (for example https://www.jobs.cz/prace/programator/). The filters baked into each URL are scraped exactly as-is. Useful when you have already dialed in a search on the Jobs.cz website. Up to 50 URLs per run.", "items": { "type": "string" } }, "jobUrls": { "title": "Job Page URLs", "maxItems": 200, "type": "array", "description": "Direct Jobs.cz job-posting URLs. Use this to re-fetch full details for specific listings you already have, or to check whether a posting is still online. Up to 200 URLs per run.", "items": { "type": "string" } }, "maxResults": { "title": "Max Results per Search", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of jobs to collect per search keyword (per location). Use 50 for a quick scan or a higher number for deep research. The last page is always kept in full, so the final count can slightly overshoot this number.", "default": 100 }, "employmentType": { "title": "Employment Type", "enum": [ "", "full-time", "part-time", "agreement", "internship" ], "type": "string", "description": "Filter by contract type. Leave on 'Any' for all types.", "default": "" }, "workArrangement": { "title": "Work Arrangement", "enum": [ "", "remote", "hybrid", "onsite" ], "type": "string", "description": "Filter by where the work is done. Leave on 'Any' to include all arrangements.", "default": "" }, "publicationDate": { "title": "Posted Within", "enum": [ "", "1", "3", "7", "30" ], "type": "string", "description": "Only show jobs published within this time period.", "default": "" }, "suitableForGraduates": { "title": "Suitable for Graduates Only", "type": "boolean", "description": "Only show jobs flagged as suitable for graduates / school leavers (vhodné pro absolventy).", "default": false }, "language": { "title": "Language", "enum": [ "cs", "en" ], "type": "string", "description": "Interface and result language. Jobs.cz is available in Czech and English.", "default": "cs" }, "includeJobDetails": { "title": "Fetch Full Job Details", "type": "boolean", "description": "Fetch the full description, requirements, and company profile from each job's detail page. Leave on for the richest data. Turn off for faster, lighter scans — the description and company-profile fields will then be empty.", "default": true }, "onlyUniqueJobs": { "title": "Only Unique Jobs", "type": "boolean", "description": "When on, each job is returned once even if Jobs.cz lists it across several pages or searches. Deduplicates by the listing's job ID. Turn off to keep every copy.", "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 } } }, "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 } } } } } } } } } }