{ "openapi": "3.0.1", "info": { "title": "StartupJobs.cz Scraper ($1.45/1K): Czech IT Jobs & Salaries", "description": "Scrape StartupJobs.cz job offers: salary in CZK or EUR per month and hour, company, town, region, work mode, seniority, contract type, technologies, languages and benefits. Website filters, company profiles, monitoring of new and removed jobs, IT market overview. Unofficial.", "version": "0.0", "x-build-id": "Ovy1EKDocdGtypljl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tsutseisoftware~startupjobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tsutseisoftware-startupjobs-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/tsutseisoftware~startupjobs-scraper/runs": { "post": { "operationId": "runs-sync-tsutseisoftware-startupjobs-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/tsutseisoftware~startupjobs-scraper/run-sync": { "post": { "operationId": "run-sync-tsutseisoftware-startupjobs-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": "Keywords to search for, e.g. \"python\", \"product manager\", \"react\", \"marketing\". The website searches titles and ad texts. Each keyword is a separate search (combined with the filters below). At most 20. Empty = all jobs that match the filters.", "items": { "type": "string" } }, "categories": { "title": "Categories", "type": "array", "description": "Only jobs in these categories (a main category includes all its subcategories), applied by the website.", "items": { "type": "string", "enum": [ "vyvoj", "back-end-vyvojar", "front-end-vyvojar", "devops-specialista", "no-code-low-code-vyvojar", "integracni-specialista", "mobilni-vyvojar", "software-architekt", "scrum-master", "herni-vyvojar", "databazovy-specialista", "full-stack-vyvojar", "data-scientist", "tester", "qa-engineer", "ai-vyvojar", "ar-vr-vyvojar", "blockchain-and-nft-vyvojar", "programator", "plc-programator", "webdesigner", "technologicke-pozice", "tech-writer", "hardware-and-firmware-engineer", "it-konzultant", "system-admin", "webmaster", "spravce-serveru", "helpdesk", "it-security-specialista", "prompt-engineer", "machine-learning", "technicky-manazer", "it-manager", "it-support", "data-analytik", "it-analytik", "webovy-analytik", "bi-business-analytik", "solution-architect", "data-engineer", "tech-support", "marketing", "asistent-marketingu", "brand-manager", "community-manager", "content-specialista", "copywriter", "e-mail-marketing", "event-manager", "marketingovy-konzultant", "marketingovy-specialista", "ppc-specialista", "pr-specialista", "rtb-specialista", "redaktor", "seo-specialista", "social-media", "online-marketing-specialista", "sefredaktor", "marketing-manager", "product-marketing-manager", "editor", "marketingovy-analytik", "obchod", "account-manager", "zakaznicky-servis", "obchodni-zastupce", "business-developer", "konzultant", "account-executive", "obchodni-manazer", "asistent-obchodu", "key-account-manager", "sap-konzultant", "multimedia", "2d-3d-grafik", "animator", "audio", "fotograf", "video", "art-director", "produkce", "product", "product-manager", "product-owner", "ux-ui-designer", "product-designer", "ux-researcher", "top-management", "chief-marketing-officer-cmo", "chief-executive-officer-ceo", "chief-financial-officer-cfo", "chief-operations-officer-coo", "chief-technology-officer-cto", "chief-product-officer-cpo", "sales-director", "hr-director", "executive-manager", "administrativa", "back-office", "prekladatel", "recepcni", "provozni-manazer", "asistent", "sekretar-ka", "nakupci", "logistik", "office-manager", "manazer-logistiky", "manazer-nakupu", "HR", "recruiter", "hr-generalista", "hr-manager", "hr-specialista", "finance", "ucetni", "controller", "trader", "reporting-specialista", "financni-manazer", "investicni-poradce", "financial-analyst", "ostatni", "lektor", "spoluzakladatel", "terapeut", "kouc", "ostatni-ostatni", "architekt-a-projektant", "projektovy-manazer", "pravnik", "property-manager", "procurement-specialist" ], "enumTitles": [ "Development (all)", "Development: Back-End Developer", "Development: Front-End Developer", "Development: DevOps Specialist", "Development: No-code/Low-code Developer", "Development: Integration Specialist", "Development: Mobile Developer", "Development: Software Architect", "Development: Scrum Master", "Development: Game Developer", "Development: Database Specialist", "Development: Full-Stack Developer", "Development: Data scientist", "Development: Tester", "Development: QA Engineer", "Development: AI developer", "Development: AR/VR Developer", "Development: Blockchain & NFT Developer", "Development: Programátor", "Development: PLC programátor", "Development: Webdesigner", "Tech (all)", "Tech: Tech writer", "Tech: Hardware & Firmware Engineer", "Tech: IT Consultant", "Tech: System admin", "Tech: Webmaster", "Tech: Server Admin", "Tech: Helpdesk", "Tech: IT Security Specialist", "Tech: Prompt Engineer", "Tech: Machine Learning", "Tech: Technical Manager", "Tech: IT Manager", "Tech: IT Support", "Tech: Data Analyst", "Tech: IT Analyst", "Tech: Web Analyst", "Tech: BI/Business Analyst", "Tech: Solution architect", "Tech: Data engineer", "Tech: Tech support", "Marketing (all)", "Marketing: Marketing Assistant", "Marketing: Brand Manager", "Marketing: Community Manager", "Marketing: Content Specialist", "Marketing: Copywriter", "Marketing: E-mail marketing", "Marketing: Event manager", "Marketing: Marketing Consultant", "Marketing: Marketing Specialist", "Marketing: PPC Specialist", "Marketing: PR Specialist", "Marketing: RTB Specialist", "Marketing: Journalist", "Marketing: SEO Specialist", "Marketing: Social Media", "Marketing: Online Marketing Specialist", "Marketing: Editor-in-chief", "Marketing: Marketing Manager", "Marketing: Product Marketing Manager", "Marketing: Editor", "Marketing: Marketing Analyst", "Sales (all)", "Sales: Account Manager", "Sales: Customer Service", "Sales: Sales Representative", "Sales: Business Developer", "Sales: Consultant", "Sales: Account Executive", "Sales: Sales Manager", "Sales: Sales Assistant", "Sales: Key Account Manager", "Sales: SAP konzultant", "Multimedia (all)", "Multimedia: 2D/3D Graphic Designer", "Multimedia: Animátor", "Multimedia: Audio", "Multimedia: Photographer", "Multimedia: Video", "Multimedia: Art Director", "Multimedia: Production", "Product (all)", "Product: Product Manager", "Product: Product Owner", "Product: UX/UI Designer", "Product: Product Designer", "Product: UX researcher", "Top management (all)", "Top management: Chief Marketing Officer (CMO)", "Top management: Chief Executive Officer (CEO)", "Top management: Chief Financial Officer (CFO)", "Top management: Chief Operations Officer (COO)", "Top management: Chief Technology Officer (CTO)", "Top management: Chief Product Officer (CPO)", "Top management: Sales Director", "Top management: HR Director", "Top management: Executive manager", "Administrative (all)", "Administrative: Back Office", "Administrative: Translator", "Administrative: Receptionist", "Administrative: Operations Manager", "Administrative: Assistant", "Administrative: Secretary", "Administrative: Buyer", "Administrative: Logistician", "Administrative: Office Manager", "Administrative: Logistic Manager", "Administrative: Purchasing Manager", "HR (all)", "HR: Recruiter", "HR: HR Generalist", "HR: HR manager", "HR: HR Specialist", "Finance (all)", "Finance: Accountant", "Finance: Controller", "Finance: Trader", "Finance: Reporting Specialist", "Finance: Finance Manager", "Finance: Investment Advisor", "Finance: Financial analyst", "Other (all)", "Other: Instructor", "Other: Co-founder", "Other: Therapist", "Other: Coach", "Other: Others", "Other: Architect and Planner", "Other: Project Manager", "Other: Lawyer", "Other: Property manager", "Other: Procurement specialist" ] } }, "technologies": { "title": "Technologies", "type": "array", "description": "Only jobs that ask for at least one of these technologies, e.g. \"Python\", \"React\", \"Kotlin\", \"AWS\". Written as on the website (the actor looks each one up there; an unknown one is reported). Applied by the website.", "items": { "type": "string" } }, "startUrls": { "title": "StartupJobs.cz URLs", "type": "array", "description": "Search URLs from the website (set the filters on https://www.startupjobs.cz/nabidky and paste the URL, e.g. https://www.startupjobs.cz/nabidky/vyvoj?seniorita=junior), company pages (https://www.startupjobs.cz/startup/medevio) or job URLs (https://www.startupjobs.cz/nabidka/109135/…). The filters below fill in what a URL doesn't set. A URL with a salary, benefit or language filter is skipped (use the inputs instead), so you never get unfiltered jobs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "jobIds": { "title": "Job IDs", "type": "array", "description": "Job IDs (the number in a job URL, e.g. 109135) or job URLs to read one by one. Ended ads are skipped. At most 1000.", "items": { "type": "string" } }, "companies": { "title": "Companies", "type": "array", "description": "Only jobs of these companies: the end of the company page URL (medevio from https://www.startupjobs.cz/startup/medevio) or the whole URL. Applied by the website.", "items": { "type": "string" } }, "maxItems": { "title": "Max jobs", "minimum": 0, "type": "integer", "description": "Maximum number of jobs saved. You pay per saved job. 0 = no limit (the whole website has about 400 jobs).", "default": 100 }, "maxItemsPerSearch": { "title": "Max jobs per search", "minimum": 0, "type": "integer", "description": "Limit for each keyword or URL separately, so one large search doesn't use up the whole Max jobs. 0 = no limit.", "default": 0 }, "includeDetails": { "title": "Add description and details", "type": "boolean", "description": "Add the description (e-mails and phone numbers removed), category, technologies, required languages with level, benefits, posting and update date, the town's GPS and the employer's screening question. The website gives the details of 50 jobs in one request, so this is included in the price of a job.", "default": true }, "descriptionMaxLength": { "title": "Description length limit", "minimum": 0, "type": "integer", "description": "Shorten the description to about this many characters (e.g. 300 for a snippet). 0 = full text.", "default": 0 }, "includeCompanyInfo": { "title": "Add company profile", "type": "boolean", "description": "Add the company's industries, team size, website, LinkedIn page, address and short description from its StartupJobs.cz profile (one request per company). Never the team members or e-mails. Extra charge \"Company info\" (see the Pricing tab) per saved job with a company profile.", "default": false }, "marketOverview": { "title": "IT market overview", "type": "boolean", "description": "Add the website's own counts for each search to the SUMMARY record in the key-value store (free): jobs by category, seniority, contract type, working time, work mode, benefit and language, the share of startups and the salary distribution with quartiles. One extra request per search.", "default": true }, "seniority": { "title": "Seniority", "type": "array", "description": "Only jobs open to these levels. Several values = any of them.", "items": { "type": "string", "enum": [ "junior", "mid", "senior" ], "enumTitles": [ "Junior", "Mid (medior)", "Senior" ] } }, "workArrangement": { "title": "Work mode", "type": "array", "description": "Only jobs offering one of these work modes.", "items": { "type": "string", "enum": [ "remote", "hybrid", "onsite" ], "enumTitles": [ "Remote", "Hybrid", "On site" ] } }, "employmentType": { "title": "Working time", "type": "array", "description": "Only these working times.", "items": { "type": "string", "enum": [ "fullTime", "partTime" ], "enumTitles": [ "Full-time", "Part-time" ] } }, "contractTypes": { "title": "Contract type", "type": "array", "description": "Only these kinds of cooperation. Several values = any of them.", "items": { "type": "string", "enum": [ "employee", "freelance", "internship" ], "enumTitles": [ "Employment contract", "Freelance (contractor, IČO)", "Internship" ] } }, "minSalary": { "title": "Salary from", "minimum": 0, "type": "integer", "description": "Only jobs whose salary reaches at least this amount (the website compares the top of the salary range and converts hourly and EUR salaries itself), in \"Salary currency\" per \"Salary period\", e.g. 80000 CZK per month or 500 CZK per hour. Jobs without a salary are left out (about 6 in 10 jobs on the website show none)." }, "salaryCurrency": { "title": "Salary currency", "enum": [ "CZK", "EUR" ], "type": "string", "description": "The currency of \"Salary from\" and \"Salary up to\".", "default": "CZK" }, "salaryPeriod": { "title": "Salary period", "enum": [ "month", "hour" ], "type": "string", "description": "The period of \"Salary from\" and \"Salary up to\".", "default": "month" }, "onlyStartups": { "title": "Only startups", "type": "boolean", "description": "Only jobs of companies the website marks as startups (a small part of the website, about 3 % of jobs).", "default": false }, "locations": { "title": "Towns", "type": "array", "description": "Only jobs in these towns, e.g. \"Praha\", \"Brno\", \"Ostrava\" (Czech or English name, diacritics optional). Checked by the actor on the towns of each job.", "items": { "type": "string" } }, "regions": { "title": "Regions", "type": "array", "description": "Only jobs in these Czech regions (kraje), from the job's towns.", "items": { "type": "string", "enum": [ "praha", "stredocesky-kraj", "jihocesky-kraj", "plzensky-kraj", "karlovarsky-kraj", "ustecky-kraj", "liberecky-kraj", "kralovehradecky-kraj", "pardubicky-kraj", "kraj-vysocina", "jihomoravsky-kraj", "olomoucky-kraj", "zlinsky-kraj", "moravskoslezsky-kraj" ], "enumTitles": [ "Prague (Praha)", "Central Bohemian (Středočeský)", "South Bohemian (Jihočeský)", "Plzeň (Plzeňský)", "Karlovy Vary (Karlovarský)", "Ústí nad Labem (Ústecký)", "Liberec (Liberecký)", "Hradec Králové (Královéhradecký)", "Pardubice (Pardubický)", "Vysočina", "South Moravian (Jihomoravský)", "Olomouc (Olomoucký)", "Zlín (Zlínský)", "Moravian-Silesian (Moravskoslezský)" ] } }, "includeRemoteJobs": { "title": "Also remote jobs elsewhere", "type": "boolean", "description": "With \"Towns\" or \"Regions\": also keep jobs in other places that can be done remotely.", "default": false }, "onlyWithSalary": { "title": "Only jobs with a salary", "type": "boolean", "description": "Skip jobs that show no salary.", "default": false }, "maxSalary": { "title": "Salary up to", "minimum": 0, "type": "integer", "description": "Skip jobs whose salary starts above this amount (in \"Salary currency\" per \"Salary period\"). Jobs without a salary are kept." }, "postedWithinDays": { "title": "Posted in the last N days", "minimum": 0, "type": "integer", "description": "Only jobs published in the last N days. The date is in the details, which the actor then reads also with \"Add description and details\" off. 0 = any time." }, "titleKeywords": { "title": "Title must contain", "type": "array", "description": "Keep only jobs whose title contains at least one of these words (case and diacritics don't matter).", "items": { "type": "string" } }, "excludeKeywords": { "title": "Title must not contain", "type": "array", "description": "Skip jobs whose title contains any of these words, e.g. \"senior\", \"sales\".", "items": { "type": "string" } }, "excludeCompanies": { "title": "Exclude companies", "type": "array", "description": "Skip jobs of companies whose name contains any of these texts.", "items": { "type": "string" } }, "onlyNewOrChanged": { "title": "Monitoring: only new or changed jobs", "type": "boolean", "description": "Return only jobs that are new or whose title, company, salary, towns, work mode, seniority, working time or contract types changed since the previous run with the same Monitoring key. Unchanged jobs are free.", "default": false }, "monitoringKey": { "title": "Monitoring: key", "type": "string", "description": "Name of the saved state. Use a different key for each watched search (e.g. \"python-brno\"). Empty = \"default\". The value is stored encrypted." }, "includeRemovedJobs": { "title": "Monitoring: include removed jobs", "type": "boolean", "description": "With \"Monitoring: only new or changed jobs\": also return jobs of the previous run that are no longer in the search, as rows with changeType \"removed\" and removedReason \"expired\" (the ad ended or was deleted) or \"noLongerMatches\" (the ad is live but no longer matches the search). Checked only when the run reads every search completely (limits, unread pages or rejected requests skip the check, and the status message says why). Removed rows are charged like any other job.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "No proxy by default. If StartupJobs.cz (Cloudflare) rejects the requests, use Apify Proxy (automatic group; RESIDENTIAL with country Czechia if that is rejected too).", "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 } } } } } } } } } }