Advanced LinkedIn Job Search API

The perfect actor for applications requiring high quality LinkedIn jobs, every week, day, or hour! We aim to index all LinkedIn jobs worldwide, over 10 million roles per month!

The maximum number of jobs per run is 5,000. If you wish to go over this number, please reach out to us!

Technical Details

• This Actor calls a database that includes LinkedIn jobs posted during the last hour, day, or week. Our scrapers are continiously indexed new roles, several hundreds of thousands every day!

• You may choose a time range using the 'Time Range' parameter. Please note that there are slight differences between the ranges:

1h: Includes jobs that have been indexed by our systems during the last hour

24h: Includes jobs that have been indexed by our systems during the last 24 hours

7d: Includes jobs that have been posted during the last 7 days

• The job data is returned in our APIs with a one hour delay. For example, if a job is posted at 06:00 UTC, it will appear between 07:00 and 08:00 UTC

• All jobs in the database are unique based on their URL. However, organizations occasionally create duplicates themselves. More commonly, organizations sometimes create the same job listing for multiple cities or states. If you wish to create a rich and unique dataset, we recommend further deduplication on title + organization, or title + organization + locations

• BETA Feature. We extract useful job details from the description with an LLM. We are currently enriching over 99.9% of all Technology jobs. Please note that our enrichment is a simple one-shot prompt on each job description, so there might be some errors.

• There are a number of jobs on LinkedIn without jobposting schema. We also index these but they have slightly less features. These are marked with the field no_jb_schema=true:

• Where included we provide the external apply url.

FAQ

Wait, this isn't a scraper?
Technically, no, or yes? We scrape all jobs in the backend, and you're accessing our database with scraped jobs with a small delay. This is a much more reliable system then scraping LinkedIn directly. This also allows us to enrich and derive data before sharing it with you, adding more value per job!

Can I see how many jobs will be returned for my query

Not at the moment, please test with the free plan or create an issue and we'll have a look for you! Make sure to include all parameters.

How can I retrieve a XML with the jobs from my latest run?

• Follow the documentation to create a saved task: https://docs.apify.com/platform/actors/running/tasks
• Create a schedule for the task: https://docs.apify.com/platform/schedules
• Copy the following endpoint to access the latest successful run from your scheduled task: Replace task-name with the the lower case username/task combination, there's a copy paste button on the task page. For example: 'username/task-name' Replace apiKey with your api key. You can find your API key at 'Settings' --> 'API & Integrations'

https://api.apify.com/v2/actor-tasks/*task-name*/runs/last/dataset/items?token=*apiKey*&format=xml&status=SUCCEEDED

You can export in several formats, not just XML. Please see the documentation for more information:

https://docs.apify.com/api/v2/actor-task-runs-last-get

https://docs.apify.com/api/v2/dataset-items-get

Input Parameters

Maximum Jobs

The maximum number of jobs that can be retrieved in a single run. Must be between 10 and 5,000.

Please set the memory to 512 for runs above 2,000 jobs!

Search Parameters

Our search parameters allow you to include or exclude jobs based on keywords. You may include :_ for prefix matching (e.g., 'Soft:_' will match 'Software', 'Softball', etc.)

Don't use abbreviations for location searches. NY should be New York, US should be United States

WARNING. The description searches are VERY intensive and at risk of time-out. Please be very specific, limit your searches to a handful of keywords, and combine with one of the other searches, preferably titleSearch. If you receive errors while using descriptionSearch or descriptionExclusionSearch, please reach out to us.

• titleSearch: Terms to search in job titles
• titleExclusionSearch: Terms to exclude from job titles
• locationSearch: Terms to search in job locations
• locationExclusionSearch: Terms to exclude from job locations
• descriptionSearch: Terms to search in job descriptions
• descriptionExclusionSearch: Terms to exclude from job descriptions
• organizationSearch: Terms to search in organization names
• organizationExclusionSearch: Terms to exclude from organization names
• organizationDescriptionSearch: Terms to search in organization descriptions
• organizationDescriptionExclusionSearch: Terms to exclude from organization descriptions

Description Type

Type of description to fetch. Options:

• text: Plain text description

Remote

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.

LinkedIn Filters

• seniorityFilter: Filter by seniority level. Available options: "Associate", "Director", "Executive", "Mid-Senior level", "Entry level", "Not Applicable", "Internship"

• external_apply_url: Filter for jobs that include an external apply URL (the opposited of Easy Apply)

• directApply: Filter for jobs that can be applied to directly through LinkedIn Easy Apply

• organizationSlugFilter: 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/

• organizationSlugExclusionFilter: Exclude jobs from specific LinkedIn organization slugs (exact match)

• industryFilter: 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

• organizationEmployeesLte: Maximum number of employees in the company

• organizationEmployeesGte: Minimum number of employees in the company

• removeAgency: Filter out recruitment agencies, job boards and other low quality sources

• EmploymentTypeFilter: Filter by employment type. Available options: FULL_TIME, PART_TIME, CONTRACTOR, TEMPORARY, INTERN, VOLUNTEER, PER_DIEM, OTHER

AI Filters

• includeAi: 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 are currently only enriching technology roles

• aiWorkArrangementFilter: 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. Available options: On-site, Hybrid, Remote OK, Remote Solely

• aiHasSalary: 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: BETA Feature: Filter by years of experience. Available options: 0-2, 2-5, 5-10, 10+

• aiVisaSponsorshipFilter: BETA Feature: Filter for jobs offering visa sponsorship only. Set to false to include all jobs.

Output Schema

Output Fields

Name	Description	Type
id	The job's internal ID. Used for expiration	text
title	Job Title	text
organization	Name of the hiring organization	text
organization_url	URL to the organization's page	text
organization_logo	URL to the organization's logo	text
date_posted	Date & Time of posting	timestamp
date_created	Date & Time of indexing in our systems	timestamp
date_validthrough	Date & Time of expiration, is null in most cases	timestamp
locations_raw	Raw location data, per the Google for Jobs requirements	json[]
locations_alt_raw	Complimentary raw location field for ATS with limited location data, currently only in use for Workday	text[]
locations_derived	Derived location data, which is the raw data (locations_raw or location_requirements_raw) matched with a database. This is the field where you search locations on.	text[] [{city, admin (state), country}]
location_type	To identify remote jobs: 'TELECOMMUTE' per the Google for Jobs requirements	text
location_requirements_raw	Location requirement to accompany remote (TELECOMMUTE) jobs per the Google for Jobs requirements.	json[]
salary_raw	raw Salary data per the Google for Jobs requirements	json
employment_type	Types like 'Full Time", "Contract", "Internship" etc. Is an array but most commonly just a single value.	text[]
url	The URL of the job, can be used to direct traffic to apply for the job	text
source	the source ATS or career site	text
source_type	either 'ats' or 'career-site'	text
source_domain	the domain of the career site	text
description_text	plain text job description - if included	text
description_html	raw HTML job description - if included	text
cities_derived	All cities from locations_derived	json[]
regions_derived	All regions/states/provinces from locations_derived	json[]
countries_derived	All countries from locations_derived	json[]
timezones_derived	Timezones derived from locations_derived	json[]
lats_derived	lats derived from locations_derived	json[]
lngs_derived	lngs derived from locations_derived	json[]
remote_derived	jobs flagged as remote by inclusion of the word 'remote' in title, description, raw location, and the offical google jobs 'TELECOMMUTE' schema	bool
seniority	Seniority level: Associate, Director, Executive, Mid-Senior level, Entry level, Not Applicable, Internship	text
directapply	'true' if the end user can apply directly on the job page, in this case LinkedIn "easyapply". False if the job contains a link to a 3rd party	bool
external_apply_url	The external application url, where included. We don't clean this url so there might be trackers (src, utm_, etc)	text
no_jb_schema	Set to true if the job was indexed from LinkedIn without JobPosting schema. These jobs have slightly different data from jobs with a schema: - locations_raw has all location data under 'addressLocality' instead of being split up by region/country/locality. (locations_derived still has the split) - orglogo and jobimage both use the same company logo as seen on the page - The following fields are not included: locationtype, locationrequirements, salary_raw, datevalidthrough	bool
recruiter_name	name of the recruiter (if present)	text
recruiter_title	title of the recruiter (if present)	text
recruiter_url	url to the LI profile of the recruiter (if present)	text
linkedin_org_employees	the number of employees within the job's company according to LI	int
linkedin_org_url	url to the company page	text
linkedin_org_size	the number of employees within the job's company according to the company	text
linkedin_org_slogan	the company's slogan	text
linkedin_org_industry	the company's industry. This is a fixed list that the company can choose from, so could be useful for classification. Keep in mind that this is in the language of the company's HQ	text
linkedin_org_followers	the company's followers on LI	int
linkedin_org_headquarters	the company's HQ location	text
linkedin_org_type	the company's type, like 'privately held', 'public', etc	text
linkedin_org_foundeddate	the company's founded date	text
linkedin_org_specialties	a comma delimited list of the company's specialties	text[]
linkedin_org_locations	the full address of the company's locations	text[]
linkedin_org_description	the description of the company's linkedin page	text
linkedin_org_recruitment_agency_derived	If the company is a recruitment agency, true or false. We identify this for each company using an LLM. The accuracy may vary and job boards might be flagged as false.	bool
linkedin_org_slug	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/	text

AI Output Fields

BETA Feature We are currently only enriching technology roles

Set include_ai to true to include the fields in this table These fields are derived from the text with an LLM and might contain mistakes.

Name	Description	Type
ai_salary_currency	The salary currency	text
ai_salary_value	The salary value, if there's a single salary with no salary range	numeric
ai_salary_minvalue	The salary minimum salary in a range	numeric
ai_salary_maxvalue	The salary maximum salary in a range	numeric
ai_salary_unittext	If the salary is per HOUR/DAY/WEEK/MONTH/YEAR	text
ai_benefits	An array with other non-salary benefits mentioned in the job listing	text[]
ai_experience_level	years of experience required, one of: 0-2, 2-5, 5-10, or 10+	text
ai_work_arrangement	Remote Solely/Remote OK/Hybrid/On-site. Remote solely is remote without an office available, Remote OK is remote with an optional office.	text
ai_work_arrangement_office_days	when work_arrangement is Hybrid, returns the number of days per week in office	bigint
ai_remote_location	When remote but only in a certain location, returns the location	text[]
ai_remote_location_derived	Derived remote location data, which is the raw data (ai_remote_location) matched with a database of locations. This is the same database as the locations_derived field.	text[]
ai_key_skills	An array of key skills mentioned in the job listing	text[]
ai_hiring_manager_name	If present, the hiring manager name	text
ai_hiring_manager_email_address	If present, the hiring manager's email address	text
ai_core_responsibilities	A 2-sentence summary of the job's core responsibilities	text
ai_requirements_summary	A 2-sentence summary of the job's requirements	text
ai_working_hours	The number of required working hours. Defaults to 40 if not mentioned	bigint
ai_employment_type	One or more employment types as derived from the job description: FULL_TIME/PART_TIME/CONTRACTOR/TEMPORARY/INTERN/VOLUNTEER/PER_DIEM/OTHER	text[]
ai_job_language	The language of the job description	text
ai_visa_sponsorship	Returns true if the job description mentions Visa sponsorship opportunities	boolean