LinkedIn

Retrieves LinkedIn job postings for companies identified by company IDs, vanity names, or company page URLs, with optional keyword, location, posting age, and pagination filters. Use it to track company hiring activity across one or more employers.

get/api/linkedin/get-company-jobs/v1

Request

Query parameters

tokenstring required

Access token for this API service.

companyIdstring

Comma-separated numeric LinkedIn company IDs, up to 10. Supply companyId or company. Companies are matched as a union; a page may contain jobs from only some selected companies.

companystring

Comma-separated LinkedIn company vanity names or company page URLs, up to 10. Supply companyId or company. An unknown vanity name fails the request.

keywordstring

Optional job keyword to search within the selected companies.

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
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