Find accessible LinkedIn job postings matching {query}, returning deduplicated canonical job URLs and visible card metadata in newest-first order. Support location, geographic ID, posting-age, seniority, work-mode, Easy Apply, compensation, Boolean, synonymous-query, and pagination filters. This is read-only.
Use Cases
Use for public LinkedIn job searches, especially searches limited to recent postings such as the last 24 hours or last week, location-constrained searches, or searches requiring several query variants to be merged. Use the guest endpoint for ordinary searches; use the rendered search route when a filter or authenticated-session evidence requires it.
Automation Flow
- Construct the direct guest endpoint, omitting unspecified parameters:
https://www.linkedin.com/jobs-guest/jobs/api/seeMoreJobPostings/search?keywords={encodeURIComponent(query)}&location={encodeURIComponent(location)}&geoId={geo-id}&f_E={seniority}&f_WT={work-mode}&f_TPR={recency}&sortBy=DD&start={offset}Begin withstart=0. Usef_TPR=r86400for approximately the last 24 hours andf_TPR=r604800for approximately the last week.sortBy=DDsorts newest first. For an explicit geography filter, supply a verifiedgeoId; do not substitute one geography for another. - In one browser-agent call, navigate directly to the endpoint with
waitUntil: "domcontentloaded", wait briefly for HTML cards, and run the evaluator below. For more pages, use the same endpoint with exposed or incrementedstartoffsets. LinkedIn commonly returns batches of 10, sostart=0,10,20,...is a useful default, including for requests for 10 postings, but stop when a response contains fewer than the batch size, no new cards, or an access/error state. Do not visit the homepage or type into search controls. - For multiple
{queries}, load one guest endpoint per query and union results by opaquejobId, preserving every matching query on each result. Query variants such as an abbreviation or remote-qualified variant are optional caller choices. - Continue pagination until no new cards or no further page is requested. Deduplicate by
jobId, falling back to canonical URL. Return visible cards only and preserve newest-first order. For a requested{limit}, return the first{limit}deduplicated results after merging pages and query variants. - If Easy Apply, remote work, compensation, or seniority is required, retain only cards with visible evidence; never infer missing attributes. For full details of a selected result, follow Inspect LinkedIn Job Posting.
- When using the rendered search surface, construct the URL directly, for example:
https://www.linkedin.com/jobs/search/?keywords={encodeURIComponent(query)}&location={encodeURIComponent(location)}&f_TPR={recency}&sortBy=DD&position=1&pageNum=0Optional parameters includegeoId={geo-id},f_E={seniority},f_WT=2for remote work, andf_AL=truefor Easy Apply. Navigate once, wait briefly afterdomcontentloaded, and extract visible cards. Paginate only through visible enabled controls or continuation URLs exposed by LinkedIn; do not invent page parameters.
Guest-card evaluator for the currently loaded guest-results page:
(() => {
const clean=s=>(s||'').replace(/\s+/g,' ').trim();
const abs=href=>{try{const u=new URL(href,location.href);u.search='';u.hash='';return u.href}catch{return null}};
const jobs=[],seen=new Set();
for(const li of document.querySelectorAll('li')){
const urn=li.querySelector('[data-entity-urn]')?.getAttribute('data-entity-urn')||'';
const jobId=(urn.match(/urn:li:jobPosting:(\d+)/)||[])[1]||null;
if(!jobId||seen.has(jobId))continue;
const link=li.querySelector('a.base-card__full-link,a[href*="/jobs/view/"]');
const url=link?abs(link.href):null;if(!url)continue;seen.add(jobId);
const text=clean(li.innerText),time=li.querySelector('time');
const compensation=clean([...li.querySelectorAll('*')].find(e=>/[$€£₹]\s?\d|\d[\d,.]*\s?[-–]\s?[$€£₹]?\d|per hour|per year|annually|hourly salary|salary range/i.test(clean(e.innerText))&&clean(e.innerText).length<180)?.innerText)||null;
jobs.push({jobId,title:clean(li.querySelector('.base-search-card__title,.job-card-list__title')?.textContent)||clean(link.innerText),company:clean(li.querySelector('.base-search-card__subtitle,.base-search-card__subtitle a')?.textContent),location:clean(li.querySelector('.job-search-card__location')?.textContent),postedIso:time?.getAttribute('datetime')||null,postedRelative:clean(time?.textContent),easyApply:/easy apply/i.test(text),activelyHiring:!!li.querySelector('.job-posting-benefits'),compensation,url,cardText:text.slice(0,2000)});
}
const body=clean(document.body?.innerText||'').slice(0,2000);
const blocked=/captcha|security verification|checkpoint|consent|sign in|authwall|access denied/i.test(location.href+' '+body)&&!jobs.length;
return{success:!blocked,pageUrl:location.href.split('#')[0],count:jobs.length,jobs,blocked,error:blocked?body:null};
})()For multiple pages, invoke the evaluator after each direct navigation and union jobs by jobId; merge query labels when the same job appears in multiple searches. Do not assume every page has exactly 10 results.
Possible Friction Points
- The durable public search route is
/jobs-guest/jobs/api/seeMoreJobPostings/search; it returns HTML cards, not JSON. - The rendered public search route is
/jobs/search/;keywords,location,geoId,f_TPR,f_E,f_WT,f_AL,sortBy,position, andpageNumare useful direct URL parameters. A location-only search may omitgeoId; preserve the requested visible location and do not substitute an unverified geography ID. f_TPR=r86400represents approximately the last 24 hours andf_TPR=r604800approximately the last seven days.sortBy=DDrequests descending date order but does not guarantee every card has an exact timestamp; preserve visible relative posting text.- The rendered route can reach the requested state in one navigation, for example
/jobs/search/?keywords={query}&location={location}&f_TPR=r86400; do not visit the homepage or type into search controls first. - Guest results commonly arrive in batches of 10, and
startoffsets are typically0,10,20,...; verify each response and stop on short or duplicate pages rather than assuming a fixed count. - Job IDs are opaque and may be exposed in
data-entity-urn; resolve them from returned cards and never guess them. - Card markup varies. Prefer
.base-search-card__title,.base-search-card__subtitle,.job-search-card__location,time, anda.base-card__full-link, while preservingcardTextand returning null for absent fields. - A visible
.job-posting-benefitselement is a concrete card-level signal that LinkedIn is showing an actively-hiring benefit; do not infer hiring status without such visible evidence. - Easy Apply, compensation, remote status, seniority, and actively-hiring status require visible evidence; do not infer them from titles or company names.
- A login wall, consent page, CAPTCHA, checkpoint, anti-bot challenge, malformed response, or rendering failure is an access error, not an empty result.
- Keep navigation, fetching, and extraction read-only and same-origin. Do not collect credentials, cookies, tokens, private messages, or unrelated page data.
Example Result
{
"success": true,
"pageUrl": "https://example.com/jobs",
"count": 1,
"jobs": [
{
"jobId": "123456",
"title": "Example Title",
"company": "Example Company",
"location": "Example Location",
"postedIso": "2025-01-01T00:00:00.000Z",
"postedRelative": "2 days ago",
"easyApply": true,
"activelyHiring": false,
"compensation": null,
"url": "https://example.com/jobs/view/123456",
"cardText": "Example Title Example Company Example Location"
}
],
"blocked": false,
"error": null
}