{ "openapi": "3.0.1", "info": { "title": "Career Site Jobs Search", "description": "Searches a daily index of more than 1,490,000 open jobs read from the career sites of more than 40,000 companies on 14 applicant tracking systems, such as Workday, Greenhouse and Lever. Filter by title, country, skills, salary or visa sponsorship; each match is re-read on its board by default.", "version": "0.1", "x-build-id": "2YJAhRegRJjgcsoNp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deriverge~career-site-jobs-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deriverge-career-site-jobs-search", "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/deriverge~career-site-jobs-search/runs": { "post": { "operationId": "runs-sync-deriverge-career-site-jobs-search", "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/deriverge~career-site-jobs-search/run-sync": { "post": { "operationId": "run-sync-deriverge-career-site-jobs-search", "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": { "keywords": { "title": "Keywords in the job title", "type": "array", "description": "Jobs whose title contains any of these, for example \"data engineer\", \"account executive\", \"product designer\" or \"nurse\". Leave empty for all jobs.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop jobs whose title or company contains any of these, for example \"sales\" or \"recruiter\".", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Jobs in any of these countries: English names or two-letter codes, for example United States, Germany, UK or DE. Read from the job location, so \"Austin, TX\" counts as United States.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Jobs whose location text contains any of these, for example London, Berlin, New York or Bay Area.", "items": { "type": "string" } }, "companies": { "title": "Companies", "type": "array", "description": "Only jobs from companies whose name or career site slug contains any of these, for example \"stripe\" or \"anthropic\".", "items": { "type": "string" } }, "departments": { "title": "Departments", "type": "array", "description": "Only jobs whose department contains any of these, for example Engineering, Sales or Marketing.", "items": { "type": "string" } }, "ats": { "title": "ATS platforms", "type": "array", "description": "Only jobs from these applicant tracking systems. Leave empty for all.", "items": { "type": "string", "enum": [ "greenhouse", "ashby", "workable", "smartrecruiters", "bamboohr", "recruitee", "personio", "teamtailor", "lever", "workday", "rippling", "breezy", "oracle", "icims" ], "enumTitles": [ "Greenhouse", "Ashby", "Workable", "SmartRecruiters", "BambooHR", "Recruitee", "Personio", "Teamtailor", "Lever", "Workday", "Rippling", "Breezy HR", "Oracle Recruiting Cloud", "iCIMS" ] } }, "seniority": { "title": "Seniority", "type": "array", "description": "Read from the job title in English, German, French, Spanish and more: \"Senior\", \"Sr.\", \"Staff\", \"Head of\", \"Werkstudent\", \"Stagiaire\". Titles without a level count as mid.", "items": { "type": "string", "enum": [ "intern", "entry", "mid", "senior", "lead", "director", "executive" ], "enumTitles": [ "Intern, working student, apprentice", "Entry level, junior, graduate", "Mid level (no level in the title)", "Senior", "Lead, staff, principal, supervisor", "Director, head of", "Executive, VP, C-level" ] } }, "categories": { "title": "Job category", "type": "array", "description": "Read from the job title (and the department when the title says nothing), for example software, healthcare, sales or logistics. Jobs whose title fits no category are left out when this filter is on.", "items": { "type": "string", "enum": [ "software", "data", "it-security", "engineering", "product", "design", "sales", "marketing", "customer-support", "operations", "finance", "hr", "legal", "healthcare", "education", "science", "trades-manufacturing", "logistics", "hospitality", "retail", "administrative" ], "enumTitles": [ "Software engineering", "Data, analytics and AI", "IT and security", "Engineering (non-software)", "Product management", "Design and UX", "Sales and business development", "Marketing and communications", "Customer success and support", "Operations and project management", "Finance and accounting", "HR and recruiting", "Legal and compliance", "Healthcare and medical", "Education and training", "Science and research", "Skilled trades and manufacturing", "Logistics and transportation", "Hospitality and food service", "Retail", "Administrative and office" ] } }, "workArrangement": { "title": "Work arrangement", "type": "array", "description": "From the ATS workplace field, the location and clear sentences in the description (\"This is a hybrid role\"). Jobs with a place and no remote or hybrid mention count as on-site.", "items": { "type": "string", "enum": [ "remote", "hybrid", "onsite" ], "enumTitles": [ "Remote", "Hybrid", "On-site" ] } }, "employmentTypes": { "title": "Employment type", "type": "array", "description": "Only jobs whose ATS field or title states one of these types. Jobs that state no type are left out when this filter is on.", "items": { "type": "string", "enum": [ "full-time", "part-time", "contract", "temporary", "internship", "apprenticeship", "volunteer" ], "enumTitles": [ "Full-time", "Part-time", "Contract or freelance", "Temporary, fixed-term or seasonal", "Internship", "Apprenticeship", "Volunteer" ] } }, "postedWithinDays": { "title": "Posted in the last days", "minimum": 1, "type": "integer", "description": "Only jobs posted in the last N days; jobs without a posting date count from the day the index first saw them." }, "hasSalary": { "title": "Only jobs with a salary", "type": "boolean", "description": "Only jobs that state pay: from the ATS salary field or a pay range in the description, returned as numbers in salaryMin, salaryMax, salaryCurrency and salaryPeriod.", "default": false }, "minYearlySalary": { "title": "Minimum yearly salary", "minimum": 1, "type": "integer", "description": "Only jobs whose pay, converted to a year (hourly × 2,080, monthly × 12), reaches this amount in the currency below, for example 120000." }, "salaryCurrency": { "title": "Salary currency", "type": "string", "description": "Currency of the minimum yearly salary: USD, EUR, GBP, CAD, AUD and so on. Jobs paid in other currencies are left out when the minimum is set.", "default": "USD" }, "visaSponsorship": { "title": "Only jobs that offer visa sponsorship", "type": "boolean", "description": "Only jobs whose description says the company sponsors visas or work permits. Jobs that say they do not sponsor are left out.", "default": false }, "remoteOnly": { "title": "Remote only", "type": "boolean", "description": "Same as choosing Remote in Work arrangement; kept for saved tasks.", "default": false }, "descriptionKeywords": { "title": "Keywords in the description", "type": "array", "description": "Only jobs whose title or full description contains any of these, for example \"python\", \"kubernetes\" or \"SAP\". Read live from each career site, so it takes longer than title keywords.", "items": { "type": "string" } }, "excludeDescriptionKeywords": { "title": "Exclude keywords in the description", "type": "array", "description": "Drop jobs whose title or description contains any of these, for example \"security clearance\" or \"commission only\".", "items": { "type": "string" } }, "skills": { "title": "Skills", "type": "array", "description": "Only jobs that ask for all of these skills, for example Python, AWS or Salesforce. Known tools, languages and certifications match their other spellings (golang, k8s, postgres); anything else is matched as a whole word in the title or description.", "items": { "type": "string" } }, "maxYearsOfExperience": { "title": "Maximum years of experience", "minimum": 0, "type": "integer", "description": "Leave out jobs whose description asks for more years of experience than this, for example 2 for junior roles. Jobs that do not state years are kept." }, "languages": { "title": "Job ad language", "type": "array", "description": "Only jobs written in these languages, as two-letter codes or names, for example en or English to find English-language jobs in Germany. Detected from the description.", "items": { "type": "string" } }, "includeDescription": { "title": "Include full description", "type": "boolean", "description": "Reads each company’s job board live for the full description, apply link and salary, and leaves out jobs closed since the index was built. The price is the same.", "default": true }, "newOnly": { "title": "Return only jobs new since the last run", "type": "boolean", "description": "Keeps a snapshot per watch name (or per saved task) and returns only jobs that were not there before. Schedule it daily for a job alert or a lead feed.", "default": false }, "watchName": { "title": "Watch name", "type": "string", "description": "Name of the snapshot used by the new-only mode, for example \"data-engineers-berlin\". Runs from a saved task get one automatically." }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "type": "integer", "description": "Hard cap on returned jobs, newest first; empty means 1,000. 1,000 jobs with descriptions take about a minute; without descriptions a few seconds." } } }, "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 } } } } } } } } } }