JUjustoneapi
LinkedIn

Job Search

Changed on

Searches LinkedIn job postings by keyword with location, posting age, company, employment type, seniority, and pagination filters. Use it to discover recruitment opportunities and research hiring activity.

get/api/linkedin/search-job/v1

Request

Query parameters

tokenstring required

Access token for this API service.

keywordstring required

Free-form job search keyword.

locationstring

Free-text location, such as London, United Kingdom.

pageinteger

First page to fetch, from 1 to 100. Each page contains up to 10 jobs.

numPagesinteger

Number of consecutive pages to fetch, from 1 to 20. The last requested page must not exceed 100.

geoIdstring

Numeric LinkedIn geographic location ID. Required when radius is supplied.

sortBy'relevance' | 'date'

LinkedIn job result sort order

Sort order. Date sorting applies to the jobs returned in this response.

Available Values:

  • relevance: Keep relevance ordering
  • date: Sort the returned jobs from newest to oldest
datePosted'all' | 'today' | '3days' | 'week' | 'month'

LinkedIn job posting age filter

Job posting age filter.

Available Values:

  • all: All posting dates
  • today: Posted within the last 24 hours
  • 3days: Posted within the last 72 hours
  • week: Posted within the last 7 days
  • month: Posted within the last 30 days
employmentTypesstring[]

Comma-separated employment types. Applying this filter enables job details and may return fewer jobs than the requested page size.

Available Values:

  • FULLTIME: Full-time employment
  • PARTTIME: Part-time employment
  • CONTRACTOR: Contract employment
  • INTERN: Internship employment
seniorityLevelsstring[]

Comma-separated seniority levels. Applying this filter enables job details and may return fewer jobs than the requested page size.

Available Values:

  • Internship: Internship positions
  • Entry level: Entry-level positions
  • Associate: Associate positions
  • Mid-Senior level: Mid-senior-level positions
  • Director: Director positions
  • Executive: Executive positions
  • Not Applicable: Positions without an applicable seniority level
companyIdstring

Numeric LinkedIn company ID to restrict the search to one company.

remoteJobsOnlyboolean

Return only jobs with an explicit remote marker. This best-effort filter may omit remote jobs.

includeDetailsboolean

Fetch details for up to 100 jobs per request in addition to search cards. Employment and seniority filters enable details regardless of this value.

radiusinteger

Search radius in kilometres, at least 1. Requires geoId.

fieldsstring

Comma-separated job fields to include. job_id and job_title are always included.

Response

OK

code0 | 100 | 101 | 202 | 300 | 301 | 302 | 303 | 400 | 404 | 500 | 503 | 600 | 601 | 602 required
messagestring nullable required
dataunknown required
recordTimestring nullable required
requestIdstring
reasonstring

Changes