{ "openapi": "3.0.1", "info": { "title": "Advanced LinkedIn Job Search API", "description": "Scrape public LinkedIn jobs by search URL, job URL or title + location. Get title, company, salary, seniority, applicants, full description and AI insights (skills, experience, benefits) as clean JSON. 60 input options, live output, no login or cookies needed.", "version": "1.0", "x-build-id": "GGOjatgbtqvXLqPs2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/insights_data~advanced-linkedin-job-search-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-insights_data-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/insights_data~advanced-linkedin-job-search-api/runs": { "post": { "operationId": "runs-sync-insights_data-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/insights_data~advanced-linkedin-job-search-api/run-sync": { "post": { "operationId": "run-sync-insights_data-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", "month", "6m", "any" ], "type": "string", "description": "Only jobs posted within this period. Run the Actor on a schedule that matches the range (e.g. every day with 24 hours) to catch every new job without duplicates.", "default": "7d" }, "limit": { "title": "๐Ÿ“Š Maximum jobs per run", "minimum": 10, "maximum": 50000, "type": "integer", "description": "Maximum number of jobs collected across the whole run (all links, titles and locations together). Minimum 10, maximum 5,000. Free plan users get up to 10 jobs per run; paid Apify plans have no limit.", "default": 10 }, "urls": { "title": "๐Ÿ”— LinkedIn job or job-search URLs", "type": "array", "description": "One or more LinkedIn links (bulk input supported, one per line). Accepts job search links (e.g. https://www.linkedin.com/jobs/search/?keywords=Data%20Engineer&location=United%20States) with their keyword, location and filter settings (settings missing from a link, such as the time range, come from the fields below), and single job links (e.g. https://www.linkedin.com/jobs/view/4475178472). A bare job ID also works.", "items": { "type": "string" } }, "jobTitles": { "title": "๐Ÿ’ผ Job titles / search queries", "type": "array", "description": "Search queries sent to LinkedIn job search, e.g. 'Data Engineer'. Boolean operators are supported. Each query runs once per location.", "items": { "type": "string" } }, "locations": { "title": "๐ŸŒ Locations", "type": "array", "description": "Locations such as 'San Francisco' or 'United Kingdom'. Each one is matched to LinkedIn's first location suggestion, so write 'United Kingdom' rather than 'UK' (which LinkedIn reads as Ukraine).", "items": { "type": "string" } }, "maxItems": { "title": "๐Ÿงฎ Maximum jobs per search", "minimum": 1, "type": "integer", "description": "Optional cap per search (each search link, or each job title and location pair). Leave empty to use the run maximum above." }, "page": { "title": "๐Ÿ“„ Start page number", "minimum": 1, "type": "integer", "description": "Result page to start from. Each page counts as 25 jobs, so page 3 starts at job 51.", "default": 1 }, "sortBy": { "title": "๐Ÿ”€ Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Order of the search results.", "default": "relevance" }, "postedLimit": { "title": "๐Ÿ“† Posted limit", "enum": [ "1h", "24h", "week", "month" ], "type": "string", "description": "Alternative way to set the time range. When set, it replaces the time range above." }, "workplaceType": { "title": "๐Ÿ  Workplace type", "type": "array", "description": "Select one or more workplace types.", "items": { "type": "string", "enum": [ "on_site", "remote", "hybrid" ], "enumTitles": [ "On-site", "Remote", "Hybrid" ] } }, "employmentType": { "title": "๐Ÿ‘” Employment type", "type": "array", "description": "Select one or more employment types.", "items": { "type": "string", "enum": [ "full_time", "part_time", "contract", "temporary", "volunteer", "internship", "other" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Temporary", "Volunteer", "Internship", "Other" ] } }, "experienceLevel": { "title": "๐ŸŽ“ Experience level", "type": "array", "description": "Select one or more experience levels.", "items": { "type": "string", "enum": [ "internship", "entry_level", "associate", "mid_senior", "director", "executive" ], "enumTitles": [ "Internship", "Entry level", "Associate", "Mid-Senior level", "Director", "Executive" ] } }, "salary": { "title": "๐Ÿ’ฐ Salary filter", "type": "array", "description": "Salary ranges such as '100k+' or '80k-120k'. Jobs with a known salary outside every range are removed; jobs without salary information are kept.", "items": { "type": "string" } }, "company": { "title": "๐Ÿข Companies", "maxItems": 10, "type": "array", "description": "Company names or LinkedIn company URLs (up to 10). Names are matched to LinkedIn's first company suggestion.", "items": { "type": "string" } }, "under10Applicants": { "title": "๐Ÿ”ฅ Under 10 applicants", "type": "boolean", "description": "Only jobs with fewer than 10 applicants.", "default": false }, "easyApply": { "title": "โšก LinkedIn Easy Apply", "type": "boolean", "description": "Only jobs that offer LinkedIn Easy Apply.", "default": false }, "industryIds": { "title": "๐Ÿ†” Industry IDs", "maxItems": 20, "type": "array", "description": "LinkedIn industry codes (up to 20), e.g. 4 for Software Development.", "items": { "type": "string" } }, "geoIds": { "title": "๐Ÿ“Œ Geo IDs", "maxItems": 10, "type": "array", "description": "LinkedIn location IDs (up to 10), e.g. 103644278 for the United States. Used when no location text is given.", "items": { "type": "string" } }, "titleSearch": { "title": "๐Ÿ” Title search", "type": "array", "description": "Keep only jobs whose title contains one of these terms. They are also searched as extra queries. Use :* for prefix matching ('Soft:*' matches 'Software', 'Softball').", "items": { "type": "string" } }, "titleExactMatch": { "title": "๐ŸŽฏ Exact title match", "type": "boolean", "description": "Title search must match the whole job title exactly instead of a part of it.", "default": false }, "titleExclusionSearch": { "title": "๐Ÿšซ Title exclusion", "type": "array", "description": "Remove jobs whose title contains one of these terms. Use :* for prefix matching.", "items": { "type": "string" } }, "locationSearch": { "title": "๐Ÿ“ Location search", "type": "array", "description": "Keep only jobs whose location contains one of these phrases, e.g. 'London, England, United Kingdom' or 'New York, New York, United States'. Use full English names, no abbreviations. Use :* for prefix matching ('New:*'). They are also searched as extra locations.", "items": { "type": "string" } }, "locationExclusionSearch": { "title": "โ›” Location exclusion", "type": "array", "description": "Remove jobs whose location contains one of these phrases. Use :* for prefix matching.", "items": { "type": "string" } }, "descriptionSearch": { "title": "๐Ÿ“– Description search (includes title)", "type": "array", "description": "Keep only jobs whose title or description contains one of these terms. Use :* for prefix matching. Not applied with the 6-month time range.", "items": { "type": "string" } }, "descriptionExclusionSearch": { "title": "๐Ÿงน Description exclusion (includes title)", "type": "array", "description": "Remove jobs whose title or description contains one of these terms. Use :* for prefix matching. Not applied with the 6-month time range.", "items": { "type": "string" } }, "organizationSearch": { "title": "๐Ÿ”Ž Organization search", "type": "array", "description": "Keep only jobs from organizations whose name contains one of these terms. Use :* for prefix matching ('Google:*').", "items": { "type": "string" } }, "organizationExclusionSearch": { "title": "โŒ Organization exclusion", "type": "array", "description": "Remove jobs from organizations whose name contains one of these terms. Use :* for prefix matching.", "items": { "type": "string" } }, "organizationSlugFilter": { "title": "๐Ÿ”– Organization slug filter", "type": "array", "description": "Keep only jobs from these LinkedIn company slugs (exact match). The slug is the part after /company/ in the URL, e.g. 'tesla-motors'. Only jobs whose company slug is known are kept.", "items": { "type": "string" } }, "organizationSlugExclusionFilter": { "title": "๐Ÿ“› Organization slug exclusion", "type": "array", "description": "Remove jobs from these LinkedIn company slugs (exact match).", "items": { "type": "string" } }, "industryFilter": { "title": "๐Ÿญ Industry filter", "type": "array", "description": "Keep only jobs from companies in these LinkedIn industries (exact names). LinkedIn rarely shows the company industry publicly, so this filter may remove all jobs.", "items": { "type": "string" } }, "industryExclusionFilter": { "title": "๐Ÿšง Industry exclusion", "type": "array", "description": "Remove jobs from companies in these LinkedIn industries (exact names).", "items": { "type": "string" } }, "organizationSizeFilter": { "title": "๐Ÿ“ Company size", "type": "array", "description": "Keep only jobs from companies in these size buckets. LinkedIn rarely shows the company size publicly, so this filter may remove all jobs.", "items": { "type": "string", "enum": [ "1", "2-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ], "enumTitles": [ "1", "2-10", "11-50", "51-200", "201-500", "501-1,000", "1,001-5,000", "5,001-10,000", "10,001+" ] } }, "organizationEmployeesGte": { "title": "๐Ÿ‘ฅ Minimum employees", "minimum": 0, "type": "integer", "description": "Keep only jobs from companies with at least this many employees. LinkedIn rarely shows the headcount publicly and unknown counts as 0, so a value above 0 may remove all jobs." }, "organizationEmployeesLte": { "title": "๐Ÿ‘ค Maximum employees", "minimum": 0, "type": "integer", "description": "Keep only jobs from companies with at most this many employees." }, "minCompanyFollowers": { "title": "๐Ÿ“ฃ Minimum company followers", "minimum": 0, "type": "integer", "description": "Keep only jobs from companies with at least this many LinkedIn followers. LinkedIn rarely shows the follower count publicly and unknown counts as 0, so a value above 0 may remove all jobs." }, "removeAgency": { "title": "๐Ÿšฎ Remove agency jobs", "type": "boolean", "description": "Remove jobs from companies recognised as staffing or recruiting agencies.", "default": false }, "recruiterOnly": { "title": "๐Ÿค Only jobs with a recruiter profile", "type": "boolean", "description": "Keep only jobs that include a link to the recruiter's LinkedIn profile. Recruiter profiles are not shown publicly, so this filter may remove all jobs.", "default": false }, "seniorityFilter": { "title": "๐Ÿ† Seniority level", "type": "array", "description": "Keep only jobs with these seniority levels (as shown on LinkedIn in English).", "items": { "type": "string", "enum": [ "Internship", "Entry level", "Associate", "Mid-Senior level", "Director", "Executive", "Not Applicable" ], "enumTitles": [ "Internship", "Entry level", "Associate", "Mid-Senior level", "Director", "Executive", "Not Applicable" ] } }, "functionFilter": { "title": "๐Ÿงฉ Job function", "type": "array", "description": "Keep only jobs with one of these LinkedIn job functions, e.g. 'Engineering' or 'Information Technology'. The job function is often not shown publicly, so this filter may remove all jobs.", "items": { "type": "string" } }, "datePostedAfter": { "title": "โฉ Date posted after", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])(T\\d{2}:\\d{2}(:\\d{2})?)?$|^(\\d+)\\s*(hour|day|week|month|year)s?$", "type": "string", "description": "Keep only jobs posted on or after this point. Pick an exact date (e.g. 2026-01-01, UTC) or a relative period such as '7 days' (= posted in the last 7 days), '2 weeks', '1 month' or '12 hours'." }, "postedBeforeDate": { "title": "โช Date posted before", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])(T\\d{2}:\\d{2}(:\\d{2})?)?$|^(\\d+)\\s*(hour|day|week|month|year)s?$", "type": "string", "description": "Keep only jobs posted on or before this point. Pick an exact date (e.g. 2026-01-31, UTC) or a relative period such as '3 days' (= posted more than 3 days ago), '1 week' or '1 month'." }, "directApply": { "title": "โœ… Easy Apply jobs only", "type": "boolean", "description": "Keep only jobs marked as LinkedIn Easy Apply. The Easy Apply mark is often not shown publicly, so this filter may remove all jobs; the Easy Apply search filter above is more reliable.", "default": false }, "noDirectApply": { "title": "โŽ Exclude Easy Apply jobs", "type": "boolean", "description": "Remove jobs marked as LinkedIn Easy Apply.", "default": false }, "hasSalary": { "title": "๐Ÿ’ต Has salary", "type": "boolean", "description": "Keep only jobs with salary information (from the posting or found in the description)." }, "hasNoLocation": { "title": "๐Ÿ‘ป Has no location", "type": "boolean", "description": "Keep only jobs without a known location. Do not combine with locations, location search or geo IDs.", "default": false }, "aiWorkArrangementFilter": { "title": "๐Ÿก Work arrangement (AI)", "type": "array", "description": "Keep only jobs whose description points to this work arrangement. Remote OK = remote with an office available, Remote Solely = remote only.", "items": { "type": "string", "enum": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ], "enumTitles": [ "On-site", "Hybrid", "Remote OK", "Remote Solely" ] } }, "aiExperienceLevelFilter": { "title": "๐Ÿ“ˆ Years of experience (AI)", "type": "array", "description": "Keep only jobs whose description asks for this many years of experience.", "items": { "type": "string", "enum": [ "0-1", "1-2", "2-5", "5-10", "10+" ], "enumTitles": [ "0-1 years", "1-2 years", "2-5 years", "5-10 years", "10+ years" ] } }, "aiEmploymentTypeFilter": { "title": "๐Ÿ“‹ Employment type (normalized)", "type": "array", "description": "Keep only jobs with one of these normalized employment types.", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACT", "CONTRACTOR", "TEMPORARY", "INTERNSHIP", "INTERN", "VOLUNTEER", "PER_DIEM", "OTHER" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Contractor", "Temporary", "Internship", "Intern", "Volunteer", "Per diem", "Other" ] } }, "aiVisaSponsorshipFilter": { "title": "๐Ÿ›‚ Visa sponsorship (AI)", "type": "boolean", "description": "Keep only jobs whose description mentions visa sponsorship." }, "aiLanguageFilter": { "title": "๐Ÿ”ค Description language (AI)", "type": "array", "description": "Keep only jobs whose description is in one of these languages, e.g. English.", "items": { "type": "string" } }, "aiTaxonomiesFilter": { "title": "๐Ÿ“‚ Job categories (AI)", "type": "array", "description": "Keep only jobs in these categories, e.g. Technology. Job categories are not filled by the built-in extraction, so this filter removes all jobs when used.", "items": { "type": "string" } }, "aiTaxonomiesPrimaryFilter": { "title": "โญ Primary job category (AI)", "type": "array", "description": "Keep only jobs whose main category is one of these. Job categories are not filled by the built-in extraction, so this filter removes all jobs when used.", "items": { "type": "string" } }, "aiTaxonomiesExclusionFilter": { "title": "๐Ÿ™… Excluded job categories (AI)", "type": "array", "description": "Remove jobs in any of these categories. Job categories are not filled by the built-in extraction, so this filter currently removes nothing.", "items": { "type": "string" } }, "excludeATSDuplicate": { "title": "๐Ÿ” Exclude ATS duplicates", "type": "boolean", "description": "Kept for compatibility with other job APIs. This Actor does not compare jobs with career-site datasets, so the duplicate flag is always empty and this option removes nothing.", "default": false }, "descriptionType": { "title": "๐Ÿ“ Description format", "enum": [ "text", "html" ], "type": "string", "description": "Format of the job description in the output: plain text or HTML.", "default": "text" }, "populateAiRemoteLocation": { "title": "๐Ÿ“ก Fill remote location", "type": "boolean", "description": "Copy the job's location into ai_remote_location when that field is empty.", "default": false }, "populateAiRemoteLocationDerived": { "title": "๐Ÿ›ธ Fill derived remote location", "type": "boolean", "description": "Copy the job's location into ai_remote_location_derived when that field is empty.", "default": false }, "fetchJobDetails": { "title": "๐Ÿ”ฌ Collect full job details", "type": "boolean", "description": "Open every job for its full description, seniority, employment type and applicant count. Turn off for faster runs with search-card data only.", "default": true }, "fetchCompanyEnrichment": { "title": "๐Ÿ“‡ Collect company details", "type": "boolean", "description": "Add the company's LinkedIn description when it is publicly available.", "default": true }, "proxyConfiguration": { "title": "๐ŸŒ Proxy configuration", "type": "object", "description": "By default no proxy is used. If LinkedIn blocks the run, it switches to a datacenter proxy and then to a residential proxy automatically. Pick a proxy here to start with it instead.", "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 } } } } } } } } } }