{ "openapi": "3.0.1", "info": { "title": "Career Site Job Listing Feed", "description": "The perfect Job Posting Feed for high-quality real jobs! Direct postings from over 175k company career sites across 54 ATS platforms like: Workday, Greenhouse, and Ashby. Enriched with AI and LinkedIn company data! Includes Lever, Rippling, SuccessFactors, iCIMS. Powered by Fantastic.jobs", "version": "0.1", "x-build-id": "K9WY6p5YTijHadaOK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fantastic-jobs~career-site-job-listing-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fantastic-jobs-career-site-job-listing-feed", "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/fantastic-jobs~career-site-job-listing-feed/runs": { "post": { "operationId": "runs-sync-fantastic-jobs-career-site-job-listing-feed", "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/fantastic-jobs~career-site-job-listing-feed/run-sync": { "post": { "operationId": "run-sync-fantastic-jobs-career-site-job-listing-feed", "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": { "limit": { "title": "Maximum Jobs per feed", "minimum": 200, "maximum": 10000, "type": "integer", "description": "Maximum number of jobs to return per run. The minimum is 200 and the maximum is 5,000. Please set the memory to 1GB for runs above 2,000 jobs and increase your timeout up to 20 minutes..", "default": 200 }, "includeAi": { "title": "Include AI Fields", "type": "boolean", "description": "BETA Feature: Include AI enriched fields. We enrich jobs with AI to retrieve relevant data from the job description. Please note that this performed with a one-shot prompt, so there might be some errors. We enrich over 99.9% of all jobs.", "default": true }, "includeLinkedIn": { "title": "Include LinkedIn Company Data Fields", "type": "boolean", "description": "BETA Feature: Include LinkedIn company data. We use AI to map each job to a LinkedIn organization. This is a beta so there might be some errors. We map over 95% of all jobs with 99% accuracy." }, "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.)", "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. Location search uses phrase matching, so you must use the exact 'City, State/Region, Country' format. All locations use English names (e.g., 'Munich' not 'München', 'Bavaria' not 'Bayern'). For the UK, use the constituent country as the state (e.g., 'London, England, United Kingdom', 'Edinburgh, Scotland, United Kingdom'). For the US, use the full state name (e.g., 'New York, New York, United States', 'San Francisco, California, United States'). You can also search by just a country (e.g., 'United Kingdom') or a city (e.g., 'London'). Do not use abbreviations (NY, US, UK). Use :* for prefix matching (e.g., 'New:*' will match 'New York', 'New Jersey', etc.). If anything is unclear, please create an issue.", "items": { "type": "string" } }, "locationExclusionSearch": { "title": "Location Exclusion Search", "type": "array", "description": "Array of locations to exclude. Location search uses phrase matching, so you must use the exact 'City, State/Region, Country' format. All locations use English names. For the UK, use the constituent country as the state (e.g., 'London, England, United Kingdom'). Do not use abbreviations (NY, US, UK). Use :* for prefix matching (e.g., 'New:*' will match 'New York', 'New Jersey', etc.). If anything is unclear, please create an issue.", "items": { "type": "string" } }, "descriptionSearch": { "title": "Description Search (only use with other searches, read instructions) (includes title)", "type": "array", "description": "Warning, this search is very intensive. Please be very specific, limit your searches to a handful of keywords, and combine with one of the other searches, preferably titleSearch. Array of terms to search in job title & description. Use :* for prefix matching (e.g., 'Python:*' will match 'Python', 'Pythonic', etc.)", "items": { "type": "string" } }, "descriptionExclusionSearch": { "title": "Description Exclusion Search (only use with other searches, read instructions) (includes title)", "type": "array", "description": "Warning, this search is very intensive. Please be very specific, limit your searches to a handful of keywords, and combine with one of the other searches, preferably titleSearch. Array of terms to exclude from job title & description. Use :* for prefix matching (e.g., 'Python:*' will match 'Python', 'Pythonic', etc.)", "items": { "type": "string" } }, "organizationSearch": { "title": "Organization Search", "type": "array", "description": "Array of organization names to search for. Use :* for prefix matching (e.g., 'Google:*' will match 'Google', 'Google Cloud', etc.) Getting several companies with the same name? Use the domainFilter to filter by company domains.", "items": { "type": "string" } }, "organizationExclusionSearch": { "title": "Organization Exclusion Search", "type": "array", "description": "Array of organization names to exclude. Use :* for prefix matching (e.g., 'Google:*' will match 'Google', 'Google Cloud', etc.) Getting several companies with the same name? Use the domainExclusionFilter to filter by company domains.", "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 ore 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" ] } }, "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": "BETA Feature: Filter by employment type", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } }, "aiWorkArrangementFilter": { "title": "AI Work Arrangement", "type": "array", "description": "BETA Feature: Filter by work arrangement. Remote OK = remote with an office available. Remote Solely = remote with no office available. Include both to include all remote jobs.", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } }, "aiHasSalary": { "title": "AI Has Salary", "type": "boolean", "description": "BETA Feature: Filter for jobs with salary information only. Set to false to include all jobs. Results include jobs that have either an AI enriched salary or a raw salary (discovered in the job posting schema)." }, "aiExperienceLevelFilter": { "title": "AI Experience Level", "type": "array", "description": "BETA Feature: Filter by years of experience", "items": { "type": "string", "enum": [ "0-2", "2-5", "5-10", "10+" ] } }, "aiVisaSponsorshipFilter": { "title": "AI Visa Sponsorship", "type": "boolean", "description": "BETA Feature: Filter for jobs offering visa sponsorship only. Set to false to include all jobs." }, "aiTaxonomiesFilter": { "title": "AI Taxonomies Filter", "type": "array", "description": "BETA Feature: Filter by AI taxonomies", "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": "BETA Feature: Filter by primary AI taxonomy", "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: this filter is very broad)", "type": "array", "description": "BETA Feature: Exclude jobs by AI taxonomies. Warning: this filter is very broad and will exclude jobs that are not in any of the selected taxonomies. For example, 'Healthcare' might exclude Software Engineer job in Healthcare. Use inclusive filters to avoid this.", "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": false }, "populateAiRemoteLocationDerived": { "title": "Populate AI Remote Location Derived", "type": "boolean", "description": "If enabled, populates ai_remote_location_derived with locations_derived when ai_remote_location_derived is empty.", "default": false }, "removeAgency": { "title": "Remove Agency Jobs", "type": "boolean", "description": "Filter out recruitment agencies" }, "liIndustryFilter": { "title": "LinkedIn Industries", "type": "array", "description": "BETA Feature: Filter by LinkedIn industries", "items": { "type": "string" } }, "liOrganizationEmployeesLte": { "title": "LinkedIn Max Company Size", "minimum": 0, "type": "integer", "description": "BETA Feature: Maximum number of employees in the company" }, "liOrganizationEmployeesGte": { "title": "LinkedIn Min Company Size", "minimum": 0, "type": "integer", "description": "BETA Feature: Minimum number of employees in the company" }, "remote only (legacy)": { "title": "Remote Only", "type": "boolean", "description": "Filter for remote jobs only. Set to false to include all jobs. This filter is very sensitive and will include jobs that have 'remote' in the title, description, or location. Use AI Work Arrangement filter for more precise results." } } }, "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 } } } } } } } } } }