v2

latestOpenAPI 3.0.3AGPL-3.0 license2026-07-2613501.9 MB

Search LinkedIn Jobs

Find job listings on LinkedIn by keywords, location, job type, experience level, and workplace type. Returns lightweight job rows (title, company, companyUrl, companyLogo, location, workplaceType, postedAt, jobUrl, listingId). For RICH job-detail (applicant count, full description, employment status, listed/expire timestamps, inferred benefits, formattedJobFunctions, formattedIndustries, applyMethod, companyDescription), pass the result's listingId to visitJob (or POST /api/visit/linkedin/job).

Parameters

keywords (optional): Search terms matched against job title, company name, and description

Keyword syntax (Boolean operators)

Keywords support LinkedIn Boolean search syntax:

Exact phrase: "frontend engineer" — matches only that exact title
AND: React AND TypeScript — both terms required (spaces default to AND)
OR: "frontend engineer" OR "front-end developer" — either term
NOT: engineer NOT intern — exclude unwanted terms
Parentheses: (React OR Vue) AND "senior engineer" — group logic

Operators must be UPPERCASE. Precedence: Quotes > Parentheses > NOT > AND > OR.

Available filters

Pass human-readable names for location, company, industry, jobFunction, benefits, commitments — they are resolved to LinkedIn IDs server-side. Do not hand-resolve.

Filter	Type	Description
location	string[]	City/region/country names
company	string[]	Hiring company names
industry	string[]	Company industry names
jobFunction	string[]	Job function names (Engineering, Sales, …)
datePosted	string	"past-24h" \| "past-week" \| "past-month"
sortBy	string	"relevance" \| "date"
jobType	string[]	Employment type codes (see below)
experienceLevel	string[]	Seniority codes (see below)
workplaceType	string[]	Work location codes (see below)
benefits	string[]	Advertised benefit names
commitments	string[]	Employer commitment names
easyApply	boolean	Only Easy Apply jobs
under10Applicants	boolean	Only jobs with <10 applicants
inYourNetwork	boolean	Only jobs where you have a connection
hasVerifications	boolean	Only verified job posters
fairChanceEmployer	boolean	Only Fair Chance employers

Job type codes

Code	Type
F	Full-time
P	Part-time
C	Contract
T	Temporary
I	Internship
V	Volunteer
O	Other

Experience level codes

Code	Level
1	Internship
2	Entry level
3	Associate
4	Mid-Senior level
5	Director
6	Executive

Workplace type codes

Code	Type
1	On-site
2	Remote
3	Hybrid

Response fields (per item)

Field	Type	Description
title	string	Job title
company	string\|null	Hiring company name
companyUrl	string\|null	Company LinkedIn page URL
companyLogo	string\|null	Company logo URL
location	string\|null	Job location
workplaceType	string\|null	On-site / Remote / Hybrid
postedAt	string\|null	Human-readable posting time (e.g. "2 days ago")
jobUrl	string	Direct URL to the job listing
listingId	string	LinkedIn job listing ID

Pagination

Default page size: 10, max: 50
Use start + count to paginate. Check hasMore for more pages.

Example workflows

Job monitoring: Search by title + location → track new openings in your area
Competitive hiring analysis: Search by company keywords → see what roles competitors are hiring for
Market demand research: Search by skills → gauge demand for specific expertise

Credits

post/search/linkedin/jobs

Request body

keywordsstring

Search keywords. Matches against job title, company name, and description. Optional — you can search by filters alone. Supports LinkedIn Boolean syntax: use double quotes for exact phrases (e.g. "frontend engineer"), AND to require both terms, OR for alternatives (e.g. React OR Vue OR Angular), NOT to exclude (e.g. engineer NOT intern), and parentheses to group (e.g. (React OR Vue) AND "senior engineer"). Operators must be UPPERCASE.

urlstring

Optional LinkedIn search URL. If provided, keywords and filters are extracted from the URL. Explicit params override URL-derived values.

locationstring[]

Filter by job location. Pass human labels (e.g. ['Paris','France']) — server resolves to LinkedIn geo IDs via typeahead. Numeric IDs pass through if you already have them.

datePostedstring

Filter by posting date: 'past-24h'/'past-week'/'past-month' or natural ('last week','this month'). Normalized server-side.

sortBystring

Sort order: 'relevance' (default) or 'date'/'newest' (most recent first). Normalized server-side.

jobTypestring[]

Filter by employment type (OR logic). Pass a natural label (full-time, part-time, contract, temporary, internship, volunteer, other) OR a code F/P/C/T/I/V/O — normalized server-side.

experienceLevelstring[]

Filter by seniority (OR logic). Pass a natural label (internship, entry, associate, mid-senior, director, executive) OR a code 1-6 — normalized server-side.

workplaceTypestring[]

Filter by workplace type (OR logic). Pass 'onsite'/'remote'/'hybrid' or a code 1/2/3 — labels are normalized server-side.

companystring[]

Filter by hiring company. Pass company NAMES (e.g. ['Stripe','Datadog']) — they are resolved to LinkedIn company IDs server-side. Numeric IDs also accepted.

industrystring[]

Filter by company industry. Pass industry NAMES (e.g. ['Software Development','Financial Services']) — resolved to LinkedIn industry IDs server-side. Numeric IDs also accepted.

jobFunctionstring[]

Filter by job function. Pass function names: Information Technology, Engineering, Consulting, Sales, Marketing, Finance, Business Development, Management, Project Management, Quality Assurance, Analyst, Research, Manufacturing, Other.

easyApplyboolean

When true, only return jobs with LinkedIn Easy Apply (apply without leaving LinkedIn).

under10Applicantsboolean

When true, only return jobs with fewer than 10 applicants — less competition.

inYourNetworkboolean

When true, only return jobs at companies where the credential holder has a connection.

hasVerificationsboolean

When true, only return jobs from verified job posters.

fairChanceEmployerboolean

When true, only return jobs from Fair Chance employers.

benefitsstring[]

Filter by advertised benefits. Names: Medical insurance, Vision insurance, Dental insurance, 401(k), Pension plan, Paid maternity leave, Paid paternity leave, Commuter benefits, Student loan assistance, Tuition assistance, Disability insurance.

commitmentsstring[]

Filter by employer commitments. Names: Diversity equity and inclusion, Environmental sustainability, Work-life balance, Social impact, Career growth and learning.

startinteger

Pagination offset (default 0). Use multiples of count to page through results.

countinteger

Results per page (default 10, max 50).

Response

List of LinkedIn job listings matching the search criteria

successtrue required

category'jobs' required

hasMoreboolean required

creditsUsedinteger required

Credits consumed by this call (0 for free endpoints, cached results, or duplicates).

retryAfterinteger required

Seconds to wait before making another call of the same type. 0 means no wait needed.