{ "openapi": "3.0.1", "info": { "title": "πŸ’Ό Career Site Job Listing API", "description": "πŸ’Ό Career Site Job Listing API scrapes and aggregates job openings from leading career sitesβ€”titles, locations, salaries & descriptionsβ€”fast and reliable. πŸš€ Perfect for recruiters, aggregators, and job boards. πŸ“ˆ Boost your listings with clean, structured data.", "version": "0.1", "x-build-id": "N552nFZoDvFXBO8AQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~career-site-job-listing-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-career-site-job-listing-api", "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/api-empire~career-site-job-listing-api/runs": { "post": { "operationId": "runs-sync-api-empire-career-site-job-listing-api", "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/api-empire~career-site-job-listing-api/run-sync": { "post": { "operationId": "run-sync-api-empire-career-site-job-listing-api", "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": { "timeRange": { "title": "⏱️ Time Range", "enum": [ "1h", "24h", "7d", "6m" ], "type": "string", "description": "Select the time range for job listings. You can choose between hourly (1h), daily (24h), weekly (7d), or backfill of all active jobs (6m, great to get started). We strongly recommend running the Actor at the same time every hour/day/week to ensure you get all jobs without duplicates.", "default": "7d" }, "limit": { "title": "πŸ”’ Maximum Jobs per Run", "minimum": 10, "maximum": 50000, "type": "integer", "description": "Maximum number of jobs to return per run. The minimum is 10 and the maximum is 5,000. Please set the memory to 1GB for runs above 2,000 jobs.", "default": 10 }, "includeCompanyDetails": { "title": "🏒 Include Company Data Fields", "type": "boolean", "description": "Include basic company data fields (LinkedIn, Crunchbase, logo). These columns are always present in the output; enable to keep them visible. Note: this Actor sources directly from the career site, so company-enrichment columns may be empty.", "default": true }, "titleSearch": { "title": "πŸ”Ž Title Search", "type": "array", "description": "Array of job titles to search for. Use ':*' for prefix matching (e.g. 'Soft:*' will match 'Software', 'Softball', etc.). OR within the list.", "items": { "type": "string" } }, "titleExclusionSearch": { "title": "🚫 Title Exclusion Search", "type": "array", "description": "Array of job titles to exclude. Use ':*' for prefix matching (e.g. 'Soft:*' will match 'Software', 'Softball', etc.).", "items": { "type": "string" } }, "locationSearch": { "title": "πŸ“ Location Search", "type": "array", "description": "Array of locations to search for. Use exact 'City, State/Region, Country' format with full English names (e.g. 'Toronto', 'California', 'United States'). Use ':*' for prefix matching (e.g. 'New:*'). Do not use abbreviations (NY, US, UK).", "items": { "type": "string" } }, "locationExclusionSearch": { "title": "🚷 Location Exclusion Search", "type": "array", "description": "Array of locations to exclude. Use full English names. Use ':*' for prefix matching.", "items": { "type": "string" } }, "descriptionSearch": { "title": "πŸ“ƒ Description Search (includes title)", "type": "array", "description": "Array of terms to search in job title & description. Be very specific and combine with titleSearch. Use ':*' for prefix matching (e.g. 'Python:*').", "items": { "type": "string" } }, "descriptionExclusionSearch": { "title": "❌ Description Exclusion Search (includes title)", "type": "array", "description": "Array of terms to exclude from job title & description. Use ':*' for prefix matching.", "items": { "type": "string" } }, "organizationSearch": { "title": "🏒 Organization Search", "type": "array", "description": "Array of organization names to search for. Use ':*' for prefix matching (e.g. 'Google:*').", "items": { "type": "string" } }, "organizationExclusionSearch": { "title": "🏚️ Organization Exclusion Search", "type": "array", "description": "Array of organization names to exclude. Use ':*' for prefix matching.", "items": { "type": "string" } }, "domainFilter": { "title": "🌍 Domain Filter", "type": "array", "description": "Array of company domains to search for. Requires an exact match.", "items": { "type": "string" } }, "domainExclusionFilter": { "title": "🌐 Domain Exclusion Filter", "type": "array", "description": "Array of company domains to exclude. Requires an exact match.", "items": { "type": "string" } }, "descriptionType": { "title": "πŸ“ Description Type", "enum": [ "text", "html" ], "type": "string", "description": "Format of the job description.", "default": "text" }, "ats": { "title": "πŸ—‚οΈ ATS", "type": "array", "description": "Filter jobs by one or more ATS. This Actor sources from 'adp'.", "items": { "type": "string", "enum": [ "adp", "applicantpro", "ashby", "bamboohr", "breezy", "careerplug", "comeet", "csod", "dayforce", "dover", "eightfold", "firststage", "freshteam", "gem", "gohire", "greenhouse", "hibob", "hirebridge", "hirehive", "hireology", "hiringthing", "icims", "isolved", "jazzhr", "jobvite", "join.com", "kula", "lever.co", "manatal", "oraclecloud", "pageup", "paradox", "paycom", "paycor", "paylocity", "personio", "phenompeople", "pinpoint", "polymer", "recruitee", "recooty", "rippling", "rival", "smartrecruiters", "successfactors", "taleo", "teamtailor", "trakstar", "trinet", "ultipro", "werecruit", "workable", "workday", "zoho" ] } }, "atsExclusionFilter": { "title": "🚫 ATS Exclusion Filter", "type": "array", "description": "Exclude jobs from one or more ATS.", "items": { "type": "string", "enum": [ "adp", "applicantpro", "ashby", "bamboohr", "breezy", "careerplug", "comeet", "csod", "dayforce", "dover", "eightfold", "firststage", "freshteam", "gem", "gohire", "greenhouse", "hibob", "hirebridge", "hirehive", "hireology", "hiringthing", "icims", "isolved", "jazzhr", "jobvite", "join.com", "kula", "lever.co", "manatal", "oraclecloud", "pageup", "paradox", "paycom", "paycor", "paylocity", "personio", "phenompeople", "pinpoint", "polymer", "recruitee", "recooty", "rippling", "rival", "smartrecruiters", "successfactors", "taleo", "teamtailor", "trakstar", "trinet", "ultipro", "werecruit", "workable", "workday", "zoho" ] } }, "aiEmploymentTypeFilter": { "title": "πŸ’Ό AI Employment Type", "type": "array", "description": "Filter by AI-derived employment type. Requires AI enrichment β€” ignored (with a warning) by this Actor.", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } }, "aiWorkArrangementFilter": { "title": "🏠 AI Work Arrangement", "type": "array", "description": "Filter by AI-derived work arrangement. Requires AI enrichment β€” ignored (with a warning) by this Actor. Use 'Remote Only (legacy)' below for source-based remote filtering.", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } }, "hasSalary": { "title": "πŸ’° Has Salary", "type": "boolean", "description": "Filter for jobs with salary information only. Set to false to include all jobs." }, "aiExperienceLevelFilter": { "title": "πŸ“Š AI Experience Level", "type": "array", "description": "Filter by AI-derived years of experience. Requires AI enrichment β€” ignored (with a warning) by this Actor.", "items": { "type": "string", "enum": [ "0-2", "2-5", "5-10", "10+" ] } }, "aiVisaSponsorshipFilter": { "title": "πŸ›‚ AI Visa Sponsorship", "type": "boolean", "description": "Filter for jobs offering visa sponsorship only. Requires AI enrichment β€” ignored (with a warning) by this Actor." }, "aiTaxonomiesFilter": { "title": "🏷️ AI Taxonomies Filter", "type": "array", "description": "Filter by AI-derived job category. Requires AI enrichment β€” ignored (with a warning) by this Actor.", "items": { "type": "string", "enum": [ "Technology", "Healthcare", "Management & Leadership", "Finance & Accounting", "Human Resources", "Sales", "Marketing", "Customer Service & Support", "Education", "Legal", "Engineering", "Science & Research", "Trades", "Construction", "Manufacturing", "Logistics", "Creative & Media", "Hospitality", "Environmental & Sustainability", "Retail", "Data & Analytics", "Software", "Energy", "Agriculture", "Social Services", "Administrative", "Government & Public Sector", "Art & Design", "Food & Beverage", "Transportation", "Consulting", "Sports & Recreation", "Security & Safety" ] } }, "aiTaxonomiesPrimaryFilter": { "title": "🏷️ AI Taxonomies Primary Filter", "type": "array", "description": "Filter by AI-derived primary job category. Requires AI enrichment β€” ignored (with a warning) by this Actor.", "items": { "type": "string", "enum": [ "Technology", "Healthcare", "Management & Leadership", "Finance & Accounting", "Human Resources", "Sales", "Marketing", "Customer Service & Support", "Education", "Legal", "Engineering", "Science & Research", "Trades", "Construction", "Manufacturing", "Logistics", "Creative & Media", "Hospitality", "Environmental & Sustainability", "Retail", "Data & Analytics", "Software", "Energy", "Agriculture", "Social Services", "Administrative", "Government & Public Sector", "Art & Design", "Food & Beverage", "Transportation", "Consulting", "Sports & Recreation", "Security & Safety" ] } }, "aiTaxonomiesExclusionFilter": { "title": "🚫🏷️ AI Taxonomies Exclusion Filter (warning: very broad)", "type": "array", "description": "Exclude AI-derived job categories. Requires AI enrichment β€” ignored (with a warning) by this Actor.", "items": { "type": "string", "enum": [ "Technology", "Healthcare", "Management & Leadership", "Finance & Accounting", "Human Resources", "Sales", "Marketing", "Customer Service & Support", "Education", "Legal", "Engineering", "Science & Research", "Trades", "Construction", "Manufacturing", "Logistics", "Creative & Media", "Hospitality", "Environmental & Sustainability", "Retail", "Data & Analytics", "Software", "Energy", "Agriculture", "Social Services", "Administrative", "Government & Public Sector", "Art & Design", "Food & Beverage", "Transportation", "Consulting", "Sports & Recreation", "Security & Safety" ] } }, "populateAiRemoteLocation": { "title": "πŸ“‘ Populate AI Remote Location", "type": "boolean", "description": "If enabled, populates ai_remote_location with locations_derived when ai_remote_location is empty.", "default": true }, "populateAiRemoteLocationDerived": { "title": "πŸ“‘ Populate AI Remote Location Derived", "type": "boolean", "description": "If enabled, populates ai_remote_location_derived with locations_derived when empty.", "default": true }, "removeAgency": { "title": "πŸ•΅οΈ Remove Agency Jobs", "type": "boolean", "description": "Filter out recruitment agencies. Requires LinkedIn enrichment β€” ignored (with a warning) by this Actor." }, "liIndustryFilter": { "title": "🏭 LinkedIn Industries", "type": "array", "description": "Filter by LinkedIn organization industry. Requires LinkedIn enrichment β€” ignored (with a warning) by this Actor.", "items": { "type": "string" } }, "liOrganizationEmployeesLte": { "title": "πŸ‘₯ LinkedIn Max Company Size", "type": "integer", "description": "Maximum number of employees in the company. Requires LinkedIn enrichment β€” ignored by this Actor." }, "liOrganizationEmployeesGte": { "title": "πŸ‘₯ LinkedIn Min Company Size", "type": "integer", "description": "Minimum number of employees in the company. Requires LinkedIn enrichment β€” ignored by this Actor." }, "datePostedAfter": { "title": "πŸ“† Date Posted After", "type": "string", "description": "ISO date β€” only return jobs posted on/after this date. Overrides Time Range when set. We don't recommend using this if you retrieve jobs on a regular interval with the Time Range parameter." }, "includeLinkedIn": { "title": "πŸ”— Include LinkedIn Company Data (deprecated, use Include Company Data)", "type": "boolean", "description": "Deprecated alias of Include Company Data Fields with the same functionality.", "default": true }, "remoteOnly": { "title": "🏠 Remote Only (legacy)", "type": "boolean", "description": "When set to true, only returns jobs detected as remote (based on title/location)." }, "aiHasSalary": { "title": "πŸ’° AI Has Salary (deprecated, use Has Salary)", "type": "boolean", "description": "Deprecated alias of Has Salary with the same functionality. Filter for jobs with salary information only." }, "enableGeocoding": { "title": "πŸ—ΊοΈ Geocode Locations", "type": "boolean", "description": "Resolve each job location to city / region / country / lat / lng via free OpenStreetMap geocoding. Turn off for a faster, fully offline run (lat/lng stay empty).", "default": true }, "scrapeAllCompanies": { "title": "πŸ›°οΈ Auto-discover ALL ADP Companies", "type": "boolean", "description": "Advanced: ignore the URLs above and auto-discover live ADP career sites via Common Crawl, then crawl them. This can be a long run.", "default": false }, "proxyConfiguration": { "title": "🌐 Proxy Configuration", "type": "object", "description": "Defaults to NO proxy (direct). If the source blocks direct requests, the Actor automatically falls back to a datacenter proxy, then to a residential proxy (sticky) β€” all logged in real time.", "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 } } }, "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 } } } } } } } } } }