linkedin/
search-jobs

The LinkedIn Search Jobs API searches public LinkedIn job listings by location and optional provider filters, with normalized role, company, place, employment, experience, remote, salary, and timing fields.

LinkedIn Search Jobs API

Location required
Structured discovery
Canonical job records
0.5 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

LinkedIn Search Jobs

LinkedIn Search Jobs builds one public discovery query from a required location and optional filters. It returns collection-time listing records for research and workflow intake; a returned listing does not prove that applications remain open, and a result count is not a direct measure of hiring or headcount.

LinkedIn Search Jobs API Features

  • Location-led discoveryStart every LinkedIn Search Jobs API query with a non-empty location and optionally narrow the public listing sample with a keyword, country, company, or other provider filter.
  • Flexible source filtersForward time_range, job_type, experience_level, remote, company, location_radius, selective_search, and exclusion values without inventing SocQ enums.
  • Configurable result capSet results_limit from 1 through 2000 for the single discovery query; the default is 100 and the provider may return fewer records.
  • Canonical job recordsReceive stable job, company, location, salary, publication, expiry, and collection fields rather than provider-specific nesting.
  • Nullable source fidelityKeep unavailable salary, remote, company, experience, location, publication, and expiry values null instead of inferring them.

LinkedIn Search Jobs API Parameters

ParametersRequiredDescription
locationRequiredRequired non-empty location string used to build the provider discovery query.
keywordOptionalOptional non-empty role, skill, or topic string forwarded to the provider.
countryOptionalOptional non-empty country filter string forwarded without SocQ-side translation.
time_rangeOptionalOptional non-empty provider-specific recency or time-range string.
job_typeOptionalOptional non-empty provider-specific employment or job-type filter string.
experience_levelOptionalOptional non-empty provider-specific experience or seniority filter string.
remoteOptionalOptional non-empty provider-specific workplace or remote filter string.
companyOptionalOptional non-empty company filter string forwarded to the provider.
selective_searchOptionalOptional boolean forwarded to the provider to control its selective-search behavior.
jobs_to_not_includeOptionalOptional list of non-empty exclusion strings forwarded to the provider.
location_radiusOptionalOptional non-empty provider-specific radius string associated with the location query.
results_limitOptionalOptional integer cap for this query. The default is 100, the minimum is 1, and the maximum is 2000.

How to Use the LinkedIn Search Jobs API

Submit one location-based query to the LinkedIn Search Jobs API, poll the asynchronous task, and process every returned result page.

  1. Choose a required location and add only provider filter values whose interpretation you have tested.
  2. POST the query to /v1/linkedin/search-jobs and save the returned task_id.
  3. Poll /v1/tasks/{task_id} until the task reaches a terminal status.
  4. On success, process data.results.items and follow next_cursor whenever has_more is true.
curl -X POST "https://api.socq.ai/v1/linkedin/search-jobs" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"Seattle","keyword":"Python","country":"US","results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

LinkedIn Search Jobs API Use Cases

  • Regional role discovery: Collect public listings with a consistent role-and-location query in the LinkedIn Search Jobs API and retain the collection time for later comparison.
  • Employer and role review: Inspect which employers, titles, places, work modes, experience levels, and employment types appear in the returned sample.
  • Compensation availability: Identify listings that expose salary information while preserving missing compensation as an explicit null.
  • Job workflow intake: Feed the public listing URLs and fields returned by the LinkedIn Search Jobs API into review, deduplication, alerting, or downstream analysis workflows.

LinkedIn Search Jobs API Pro Tips

  • Test provider-specific filter spellings on a small LinkedIn Search Jobs API query before using them in a recurring workflow.
  • Use the same filters and collection schedule when comparing locations or dates.
  • Deduplicate by stable job id or listing URL because renewed and overlapping searches can surface the same opening.
  • Treat remote labels as source signals and read the description for geographic, residency, or time-zone constraints.
  • Keep published_at, expires_at, and collected_at distinct so listing time is not confused with retrieval time.
  • Treat empty results as one collection outcome, not proof that no matching public jobs exist.

Beyond the LinkedIn Search Jobs API, use these APIs when you need a different type of public LinkedIn data.

  • LinkedIn Profiles API — Normalize public profile identity, roles, location, visible audience counts, experience, education, and skills from profile URLs.
  • LinkedIn Companies API — Normalize public company descriptions, websites, logos, visible audience and employee counts, industries, locations, and specialties.
  • LinkedIn Posts API — Collect public post text, authors, visible engagement, media, publication time, type, and hashtags from supported URLs.
  • LinkedIn Jobs API — Normalize public job titles, companies, descriptions, locations, qualifications, employment details, application links, and available salary fields.
  • LinkedIn Company Jobs API — Discover public job listings from prepared LinkedIn /jobs/ URLs with normalized role, company, location, employment, experience, remote, salary, and timing fields.
  • LinkedIn Company Posts API — Discover public posts from LinkedIn company-page URLs with text, author context, media, hashtags, timestamps, and visible engagement.

Explore other platforms

Combine LinkedIn data with public data from other supported social platforms.

LinkedIn Search Jobs API — FAQ

LinkedIn Search Jobs API is a programmatic interface for discovering public LinkedIn job listings from a required location and optional provider filters. It returns normalized role, company, location, employment, experience, remote, salary, and timing fields for listings available at collection time.

location is required and must contain a non-empty string. Supplying only a keyword, company, or another optional filter does not satisfy the current validator.

No. SocQ forwards the non-empty filter strings to the discovery provider without defining or translating their accepted spellings and combinations.

No. It is an integer cap from 1 to 2000, with a default of 100. Public availability, filter combinations, pagination, duplicates, and provider behavior can produce fewer records.

No. Each result is a public collection-time record. Verify application status, responsibilities, location constraints, and compensation on the listing before acting.

No. The endpoint does not apply, save jobs, create alerts, retrieve applicants, access Recruiter, or provide personalized match scores.

Each returned job record costs 0.5 SocQ credits, with no base charge. The default estimate is 100 results, empty result sets have no result charge, and actual usage may exceed the estimate when permitted.