{ "openapi": "3.0.1", "info": { "title": "Advanced LinkedIn Job Search API", "description": "Access our real-time LinkedIn Jobs database with over 10 million new jobs per month. With detailed company data, recruiter data, and AI enrichments! Get exact results with our advanced filters on title, description, location, company description, no. of employees, industry. Powered by Fantastic.jobs", "version": "0.0", "x-build-id": "f9BCyMQt5UAnozDZz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fantastic-jobs~advanced-linkedin-job-search-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fantastic-jobs-advanced-linkedin-job-search-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/fantastic-jobs~advanced-linkedin-job-search-api/runs": { "post": { "operationId": "runs-sync-fantastic-jobs-advanced-linkedin-job-search-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/fantastic-jobs~advanced-linkedin-job-search-api/run-sync": { "post": { "operationId": "run-sync-fantastic-jobs-advanced-linkedin-job-search-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 all active jobs (great to get started, last 6 months, 6m). We strongly recommend running the Actor at the same time every hour/day/week to ensure that you get all jobs without duplicates", "default": "7d" }, "limit": { "title": "Maximum Jobs per API call", "minimum": 10, "maximum": 5000, "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 }, "removeAgency": { "title": "Remove Agency Jobs", "type": "boolean", "description": "Filter out recruitment agencies, job boards and other low quality sources" }, "recruiterOnly": { "title": "Include only Jobs With Recruiter Profile (paid add-on, see pricing table)", "type": "boolean", "description": "Only return jobs that include a `recruiter_url` (a LinkedIn profile link to the recruiter who posted the job) ⚠️ Enabling this option triggers an additional per-result charge — see pricing.", "default": false }, "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 (includes title) (not supported with 6m time range)", "type": "array", "description": "Warning: This search is NOT supported with the 6m backfill API. It might also be too intensive for the 7d API. 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 (includes title) (not supported with 6m time range)", "type": "array", "description": "Warning: This search is NOT supported with the 6m backfill API. It might also be too intensive for the 7d API. 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" } }, "organizationSlugFilter": { "title": "Organization Slug Filter", "type": "array", "description": "Filter by LinkedIn organization slugs (exact match). The slug is the company specific part of the url. For example the slug in the following url is 'tesla-motors': https://www.linkedin.com/company/tesla-motors/", "items": { "type": "string" } }, "organizationSlugExclusionFilter": { "title": "Organization Slug Exclusion Filter", "type": "array", "description": "Exclude jobs from specific LinkedIn organization slugs (exact match). The slug is the company specific part of the url. For example the slug in the following url is 'tesla-motors': https://www.linkedin.com/company/tesla-motors/", "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 organizationSlugFilter to filter by LinkedIn organization slugs.", "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 organizationSlugExclusionFilter to filter by LinkedIn organization slugs.", "items": { "type": "string" } }, "descriptionType": { "title": "Description Type", "enum": [ "text", "html" ], "type": "string", "description": "Format of the job description. Choose 'text' for plain text or 'html' for HTML formatted description. Leave empty to include no description.", "default": "text" }, "datePostedAfter": { "title": "Date Posted After", "type": "string", "description": "We don't recommend using this parameter if you retrieve jobs on a regular interval with the 1h/24h/7d time range. Filter jobs posted on or after a specific date. The correct format is '2025-01-01'. To include time, use the following syntax: '2025-01-01T14:00:00'. Warning, some LinkedIn jobs don't include time and default to 00:00 Please keep in mind that the jobs posted date/time is UTC and there's a 1 to 2 hour delay before jobs appear on this API. Please be wary of duplicate jobs when using this filter." }, "seniorityFilter": { "title": "Seniority Level (English speaking countries only)", "type": "array", "description": "Filter English speaking countries by seniority level. This filter is case sensitive. You can select multiple seniority levels.", "items": { "type": "string", "enum": [ "Associate", "Director", "Executive", "Mid-Senior level", "Entry level", "Not Applicable", "Internship" ] } }, "noDirectApply": { "title": "Exclude jobs with Easy Apply", "type": "boolean", "description": "Filter for jobs that do not have easy apply on LinkedIn. " }, "directApply": { "title": "Easy Apply Only", "type": "boolean", "description": "Filter for jobs that can be applied to directly through LinkedIn Easy Apply" }, "industryFilter": { "title": "Industry Filter", "type": "array", "description": "Filter by LinkedIn industries. Use exact industry names. Industries containing commas will be automatically wrapped in quotes. You can find a list of industries on our website: https://fantastic.jobs/article/linkedin-industries", "items": { "type": "string" } }, "organizationEmployeesLte": { "title": "Max Employees", "minimum": 0, "type": "integer", "description": "Maximum number of employees in the company" }, "organizationEmployeesGte": { "title": "Min Employees", "minimum": 0, "type": "integer", "description": "Minimum number of employees in the company" }, "aiEmploymentTypeFilter": { "title": "AI Employment Type", "type": "array", "description": "Filter by AI-derived employment type. Normalized, market-independent values now that every job is AI-analysed.", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } }, "excludeATSDuplicate": { "title": "Exclude ATS Duplicates (only use in combination with the Career Site Job Listing API!)", "type": "boolean", "description": "Set this parameter to true to remove the majority of duplicate jobs between this API and the 'Career Site Job Listing API' actor. LinkedIn jobs are checked against the ATS dataset using two exact-match signals: job title + organization name + country, and job title + LinkedIn company profile + country. Agency listings are now checked. Jobs flagged as duplicates will have ats_duplicate=true, checked non-duplicates will have ats_duplicate=false, and unchecked jobs will have ats_duplicate=null." }, "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 }, "aiWorkArrangementFilter": { "title": "AI Work Arrangement", "type": "array", "description": "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" ] } }, "hasSalary": { "title": "Has Salary", "type": "boolean", "description": "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": "Filter by years of experience", "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. Set to false to include all jobs." }, "aiTaxonomiesFilter": { "title": "AI Taxonomies Filter", "type": "array", "description": "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": "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": "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" ] } }, "industryExclusionFilter": { "title": "Industry Exclusion Filter", "type": "array", "description": "Exclude jobs from these LinkedIn industries. Use exact industry names; industries containing commas are automatically wrapped in quotes.", "items": { "type": "string" } }, "organizationSizeFilter": { "title": "Company Size", "type": "array", "description": "Filter by LinkedIn company-size bucket (matches the org_linkedin_size field).", "items": { "type": "string", "enum": [ "1", "2-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ] } }, "aiLanguageFilter": { "title": "AI Language", "type": "array", "description": "Filter by the AI-detected language of the job description (e.g. English, French, German, Spanish). Matches the ai_job_language field.", "items": { "type": "string" } }, "hasNoLocation": { "title": "Has No Location", "type": "boolean", "description": "When true, returns only jobs with no normalized location (locations_derived is null). Do not combine with location search, which would always return zero rows.", "default": false }, "remote": { "title": "Remote (deprecated, use AI Work Arrangement)", "type": "boolean", "description": "Deprecated in favor of AI Work Arrangement (aiWorkArrangementFilter). When set to true, this is translated to ai_work_arrangement=Remote OK,Remote Solely. If you set AI Work Arrangement explicitly, this parameter is ignored. Set to false to include all jobs." }, "EmploymentTypeFilter": { "title": "Employment Type (deprecated, use AI Employment Type)", "type": "array", "description": "Deprecated in favor of AI Employment Type (aiEmploymentTypeFilter). Filter by raw, source-provided employment type. Values are country-specific and vary by job board.", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACTOR", "TEMPORARY", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ] } }, "aiHasSalary": { "title": "AI Has Salary (deprecated, use hasSalary)", "type": "boolean", "description": "Deprecated alias of hasSalary with the same functionality. 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)." } } }, "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 } } } } } } } } } }