{ "openapi": "3.0.1", "info": { "title": "Jobs.cz Scraper", "description": "Scrape Jobs.cz job listings by keyword, city or region, salary, and job type. Get title, company, salary range, location, category, benefits, full description, and contact. Export as JSON, CSV, or Excel.", "version": "1.0", "x-build-id": "g4uGcVeRhdqil3hrY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parsebird~jobs-cz-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parsebird-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/parsebird~jobs-cz-scraper/runs": { "post": { "operationId": "runs-sync-parsebird-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/parsebird~jobs-cz-scraper/run-sync": { "post": { "operationId": "run-sync-parsebird-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": { "keyword": { "title": "Keyword", "type": "string", "description": "Enter a job title, skill, or search term, in Czech or English (for example programátor, účetní, projektový manažer, or python). Leave empty to browse all jobs.", "default": "vývojář" }, "location": { "title": "Location", "type": "string", "description": "Enter a Czech city or region, for example Praha, Brno, Ostrava, Plzeň, or Jihomoravský kraj. Leave empty to search the whole country." }, "radiusKm": { "title": "Search radius", "enum": [ "0", "10", "20", "30", "40", "50" ], "type": "string", "description": "Include jobs within this distance of the location. Only used when a location is set. Leave empty to use the Jobs.cz default (50 km around cities)." }, "collectDetails": { "title": "Include job details", "type": "boolean", "description": "Open each job ad to add the full description, benefits, address, education, languages, contract type, and recruiter contact. Turn off for a faster run with listing data only.", "default": true }, "results_wanted": { "title": "Max jobs", "minimum": 1, "type": "integer", "description": "Maximum number of job listings to save.", "default": 20 }, "max_pages": { "title": "Max result pages", "minimum": 1, "maximum": 45, "type": "integer", "description": "Maximum number of Jobs.cz result pages to process per search (30 jobs per page). Jobs.cz shows up to 45 pages (1,350 jobs) for one search.", "default": 20 }, "postedWithin": { "title": "Posted within", "enum": [ "24h", "3d", "7d" ], "type": "string", "description": "Keep only jobs published within this period." }, "minSalary": { "title": "Minimum salary (CZK)", "minimum": 0, "maximum": 200000, "type": "integer", "description": "Keep only jobs with a gross salary (hrubá mzda) of at least this amount in CZK. Jobs.cz notes that some listings without salary information drop out of the results when this filter is set." }, "employmentTypes": { "title": "Employment type", "type": "array", "description": "Keep only these employment types. Several values are combined with OR.", "items": { "type": "string", "enum": [ "full", "part", "internships" ], "enumTitles": [ "Full-time (plný úvazek)", "Part-time (zkrácený úvazek)", "Internships and trainee programs (stáže)" ] } }, "contractTypes": { "title": "Contract type", "type": "array", "description": "Keep only these contract types. Several values are combined with OR.", "items": { "type": "string", "enum": [ "employment_contract", "identification_number", "agreement" ], "enumTitles": [ "Employment contract (HPP/VPP)", "Self-employed / trade licence (IČO)", "Agreement (DPP/DPČ)" ] } }, "workArrangement": { "title": "Work arrangement", "enum": [ "partial-work-from-home", "work-mostly-from-home", "flexible-hours" ], "type": "string", "description": "Keep only jobs offering remote work or flexible hours." }, "education": { "title": "Education", "enum": [ "primary", "high", "uni" ], "type": "string", "description": "Keep only jobs requiring this education level." }, "languages": { "title": "Language", "type": "array", "description": "Keep only jobs that ask for these languages.", "items": { "type": "string", "enum": [ "cs", "en", "de", "fr", "ru", "pl", "it", "es" ], "enumTitles": [ "Czech only", "English", "German", "French", "Russian", "Polish", "Italian", "Spanish" ] } }, "employerType": { "title": "Employer type", "enum": [ "direct", "agency", "ngo" ], "type": "string", "description": "Keep only jobs from this type of advertiser." }, "suitableFor": { "title": "Suitable for", "enum": [ "graduates", "retired", "maternity", "disabled", "ukraine_refugees" ], "type": "string", "description": "Keep only jobs marked as suitable for this group." }, "startUrls": { "title": "Jobs.cz URLs", "type": "array", "description": "Paste Jobs.cz search result URLs (for example https://www.jobs.cz/prace/brno/?q[]=účetní) or single job URLs (https://www.jobs.cz/rpd/2001492208/). When set, the keyword, location, and filter fields are ignored.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not needed in most cases. The Actor switches to Apify Proxy automatically if Jobs.cz blocks direct requests.", "default": { "useApifyProxy": 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 }, "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 } } } } } } } } } }