v2

latestOpenAPI 3.0.3AGPL-3.0 license2026-07-2613501.9 MB

Unified LinkedIn Search — posts, people, companies, jobs

Unified LinkedIn Search

This is the all-in-one search endpoint. It accepts any of the 4 categories (posts, people, companies, jobs) and returns structured results.

When to use this endpoint

Use this endpoint when you need to search across categories dynamically (e.g. the user chooses the category at runtime). For a simpler interface with category-specific documentation, use the dedicated endpoints:

POST /search/linkedin/posts — search posts
POST /search/linkedin/people — search people
POST /search/linkedin/companies — search companies
POST /search/linkedin/jobs — search jobs
POST /search/linkedin/url — search by pasting a LinkedIn search URL

Two ways to search

Structured: pass category + keywords + optional filters
URL-based: pass a LinkedIn search url — the endpoint parses it automatically

Explicit parameters always override URL-derived values.

Keyword syntax (Boolean operators)

Keywords support LinkedIn Boolean search syntax for precise matching:

Exact phrase: wrap in double quotes — "outreach automation" matches only that exact phrase
AND: both terms required — outreach AND linkedin (default when terms are space-separated)
OR: either term — CEO OR founder OR owner
NOT: exclude — manager NOT assistant
Parentheses: group — (CEO OR CTO) AND SaaS

Operators must be UPPERCASE (AND, OR, NOT). Lowercase is treated as plain text. Wildcards (*) and +/- are not supported. Precedence: Quotes → Parentheses → NOT → AND → OR.

Without quotes, a multi-word query like outreach automation is treated as outreach AND automation, which may return broad results. Use "outreach automation" for exact matching.

Resolving filter IDs

Many filters (location, industry, company, school) require LinkedIn numeric IDs. Use GET /search/linkedin/parameters to convert text (e.g. "San Francisco") into IDs (e.g. "103644278").

Pagination

Use start (offset, default 0) and count (page size, default 10, max 50). The response includes paging.total and hasMore to control iteration.

Credits

post/search/linkedin

Request body

category'posts' | 'people' | 'companies' | 'jobs'

Type of search to perform (required unless url is provided)

urlstring

LinkedIn search URL — category and filters are extracted automatically. Explicit params override URL-derived ones.

keywordsstring

Search keywords. Supports LinkedIn Boolean syntax: use double quotes for exact phrases (e.g. "outreach automation"), AND to require both terms, OR for alternatives (e.g. CEO OR founder), NOT to exclude (e.g. manager NOT assistant), and parentheses to group (e.g. (CEO OR CTO) AND SaaS). Operators must be UPPERCASE. Without quotes, multi-word queries are treated as AND by default which may return overly broad results — use exact phrases with quotes for precise matching.

sortBystring

Sort order — 'relevance' or 'date' (or natural 'newest'/'recent'); normalized server-side (posts & jobs)

datePostedstring

Time filter — 'past-24h'/'past-week'/'past-month' or natural ('last week','this month','24 hours'); normalized server-side (posts & jobs)

contentTypestring

Media type — 'images'/'videos'/'documents' or natural ('video','photo','pdf'); normalized server-side (posts only)

authorIndustrystring[]

Author industry IDs (posts only, resolve via /search/parameters)

authorCompanystring[]

Author company IDs (posts only, resolve via /search/parameters)

connectionDegreestring[]

Connection degree: F=1st, S=2nd, O=3rd+. Human forms ('2nd','3rd','second','2') are normalized for you (people only).

firstNamestring

First name filter (people only)

lastNamestring

Last name filter (people only)

titlestring

Job title filter (people only). Supports LinkedIn Boolean OR syntax: 'CEO OR CTO OR CMO'. Pipe separators are auto-converted: 'CEO|CTO|CMO' becomes 'CEO OR CTO OR CMO'. Use quotes for exact multi-word titles: '"Head of Marketing"'.

connectionOfstring

Profile URN to find connections of (people only)

followersOfstring[]

Profile URNs whose followers to search — find a creator's audience (people only)

openToVolunteeringboolean

Only people open to volunteering (people only)

serviceCategoriesstring[]

LinkedIn Service-Marketplace category names — for freelancer/consultant discovery, resolved to IDs server-side (people only)

profileLanguagestring[]

Profile language codes e.g. ['en','fr'] (people only)

schoolstring[]

School IDs (people only, resolve via /search/parameters)

locationstring[]

Geo labels e.g. ['Paris','France'] (people, companies, jobs) — server resolves, numeric IDs also accepted

industrystring[]

Industry labels e.g. ['Software Development'] (people, companies) — server resolves, numeric IDs also accepted

currentCompanystring[]

Current company labels e.g. ['Stripe'] (people only) — server resolves, numeric IDs also accepted

pastCompanystring[]

Past company labels (people only) — server resolves, numeric IDs also accepted

companySizestring[]

Company size — pass a human range ('51-200') or a code A=1-10/B=11-50/C=51-200/D=201-500/E=501-1K/F=1K-5K/G=5K-10K/H=10K+/I=self; labels are normalized server-side (companies only)

jobTypestring[]

Job type — 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 (jobs only)

experienceLevelstring[]

Experience level — pass a natural label (internship, entry, associate, mid-senior, director, executive) OR a code 1-6; normalized server-side (jobs only)

workplaceTypestring[]

Workplace type — pass 'onsite'/'remote'/'hybrid' or a code 1/2/3; labels are normalized server-side (jobs only)

companystring[]

Hiring company names, resolved to IDs server-side (jobs only)

jobFunctionstring[]

Job function names: Information Technology, Engineering, Consulting, Sales, Marketing, Finance, Business Development, Management, Project Management, Quality Assurance, Analyst, Research, Manufacturing, Other (jobs only)

easyApplyboolean

Only LinkedIn Easy Apply jobs (jobs only)

under10Applicantsboolean

Only jobs with fewer than 10 applicants (jobs only)

inYourNetworkboolean

Only jobs at companies where you have a connection (jobs only)

hasVerificationsboolean

Only jobs from verified posters (jobs only)

fairChanceEmployerboolean

Only jobs from Fair Chance employers (jobs only)

benefitsstring[]

Advertised benefit names e.g. ['Medical insurance','401(k)'] (jobs only)

commitmentsstring[]

Employer commitment names e.g. ['Work-life balance'] (jobs only)

startinteger

Pagination offset (default 0)

countinteger

Results per page (default 10, max 50)

campaignSlugstring

Campaign ID. Auto-adds discovered contacts to this campaign in background.

Response

Search results for the specified category

successtrue required

category'posts' | 'people' | 'companies' | '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.