---
title: "Search for LinkedIn job postings"
method: POST
path: "/linkedin/search-job-postings"
tags: ["LinkedIn"]
---

# Search for LinkedIn job postings

`POST /linkedin/search-job-postings`

## Request

- Base URL: `https://api.exfunc.dev`
- URL: `https://api.exfunc.dev/linkedin/search-job-postings`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/carvedai/apis/exfunc-apis/docs/linkedin/search-job-postings/post.ts> (a function with typed inputs; its response is checked against the schema)

Search for job postings on LinkedIn for a given keywords, location, and other criteria

## Request body

- object
  - `keywords` string: Keywords to search for in job postings
  - `location` string: Location to filter job postings
  - `date_posted` 'Any time' | 'Past 24 hours' | 'Past Week' | 'Past Month': Filter for job postings based on when they were posted
  - `salary` '$40,000+' | '$60,000+' | '$80,000+' | '$100,000+' | '$120,000+' | '$140,000+' | '$160,000+' | '$180,000+' | '$200,000+': Salary range to filter job postings
  - `job_type` 'Contract' | 'Full-time' | 'Part-time' | 'Internship': Job type to filter (e.g., Full-time, Part-time)
  - `work_type` 'On-site' | 'Remote' | 'Hybrid': Work type to filter (e.g., Remote, On-site)
  - `experience_level` 'Associate' | 'Director' | 'Entry Level' | 'Executive' | 'Internship' | 'Mid-Senior Level': Experience level to filter (e.g., Associate, Executive)
  - `company_uids` string[]: List of company unique identifiers to filter
  - `sort_by` 'Most Recent' | 'Most Relevant': The criteria to sort results
  - `page` integer: Page number for pagination (default is 1)

## Response `200`

SearchJobPostings API successful response

- object
  - `job_postings` object[]
    - `url` string, uri: URL to the job posting
    - `title` string: Title of the job
    - `location` string: Job location
    - `date_posted` string: Date when the job was posted
    - `company_name` string: Name of the company offering the job
    - `company_url` string, uri: URL to the company's profile

## Other responses

- `400`: User error response
- `500`: Server error response

## Changes

- **2024-11-26** `4564942657b8`: 1 info
  - the request property `keywords` became optional
- **2024-11-19** `d52d4c23f66e`: 1 breaking
  - the `job_postings/items/date_posted` response's property format changed from `date-time` to no format for status `200`
- **2024-11-12** `c907d7ad48d9`: 2 warning, 10 info
  - removed the request property `job_types`
  - removed the request property `work_types`
  - added the new optional request property `experience_level`
  - added the new optional request property `job_type`
  - …8 more

[Operation history](https://skmtc.dev/carvedai/apis/exfunc-apis/changes/linkedin/search-job-postings/post.md)

---

[API](https://skmtc.dev/carvedai/apis/exfunc-apis.md) - [All operations](https://skmtc.dev/carvedai/apis/exfunc-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/carvedai/apis/exfunc-apis/revisions/22587fdf9a5e?raw)