Skip to content

Instantly share code, notes, and snippets.

@fegvilela
Forked from Diegiwg/linkedIn_jobs_api.md
Created January 30, 2025 12:11
Show Gist options
  • Save fegvilela/2fb05e539584a728b3b2850e69e212ef to your computer and use it in GitHub Desktop.
Save fegvilela/2fb05e539584a728b3b2850e69e212ef to your computer and use it in GitHub Desktop.
LinkedIn Jobs API Documentation

LinkedIn

Search Jobs

The API URL for searching jobs is: https://www.linkedin.com/jobs-guest/jobs/api/seeMoreJobPostings/search, and it can be called this way, returning jobs from all categories.

Parameters

Parameter Description
start Sets the starting job position, used for pagination. Accepts int values, typically working in increments of 25, i.e., 0, 25, ... 125, 150.
keywords A word or phrase used as the main filter in the search.
location A country to narrow down the job search. Supported terms are in English, and for Brazil, use Brazil.
f_AL Filter for jobs with simplified application. Set to true to activate.
f_E Filter to search for jobs based on Experience Level, with options like Intern, Assistant, Junior, Mid-Senior, Director, and Executive. Accepts int values: 1, 2, 3, 4, 5, 6.
f_JT Filter to define the Job Type, allowing searches for Full-time, Part-time, Contract, Temporary, Volunteer, Internship, and Other. Accepts string values: F, P, C, T, V, I, O.
f_WT Filter to define the Work Schedule Model, allowing searches for On-site, Remote, and Hybrid. Accepts int values: 1, 2, 3.
f_JIYN Filter to limit the jobs to those with fewer than 10 applicants. Set to true to activate.
f_PP Filter for jobs in a specific City. Accepts the $ID of the city, which is described here.
f_C Filter for jobs from a specific Company. Accepts the $ID of the company, described here.
f_TPR Filter for the time since the job was posted. You can set one of the following values: "" for any time or "r86400" for the past 24 hours or "r604800" for the past week or "r2592000" for the past month

Logged-in Account-dependent Parameters

Parameter Description
f_JIYN Filter for jobs connected to your Network. Set to true to activate.

HTML Structure

Resource CSS Selector Description Extra
Job li > div.base-card Returns a list of all job nodes. Must be executed within the Node Document context.
Job Title [class*=_title] Returns the job title. Must be executed within the Job Node context.
Job URL [class*=_full-link] Returns the job URL. Must be executed within the Job Node context.
Company Name [class*=_subtitle] Returns the name of the company responsible. Must be executed within the Job Node context.
City [class*=_location] Returns the City, State, and Country of the job. Must be executed within the Job Node context.
Post Time [class*=listdate] Returns the time since the job was posted. Must be executed within the Job Node context.

Job Information

The URL to retrieve data for a job is: https://www.linkedin.com/jobs-guest/jobs/api/jobPosting/$job_id.

Getting the ID from a Full Link

Step Input Output Procedure
1 Full Link Partial Link Apply a function to split the string using the '?' parameter, selecting Index 0
2 Partial Link Job ID Apply a function to split using the '-' parameter, selecting the Last Index

HTML Structure

Resource CSS Selector Description Extra
Job Description [class*=description] > section > div Returns the job description. Must be executed within the Document Node context.
Job Criteria List [class*=_job-criteria-list] Returns the job criteria list. Must be executed within the Document Node context.

Context

It is expected that you have saved the Title, Company Name, City, and Post Time information.

Secondary APIs

Companies

The URL to search for companies is: https://www.linkedin.com/jobs-guest/api/typeaheadHits?typeaheadType=COMPANY. Based on a term, it returns all companies with that term in their name.

Parameter

Parameter Description
query Company name

Cities

The URL to search for cities is: https://www.linkedin.com/jobs-guest/api/typeaheadHits?origin=jserp&typeaheadType=GEO&geoTypes=POPULATED_PLACE. Based on a term, it returns all cities with that term in their name.

Parameter

Parameter Description
query City name
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment