# Search LinkedIn jobs

### Search LinkedIn jobs

`POST /api/v1/linkedin/jobs/search`

Operation ID: `searchLinkedinJobs`

Job search by keywords, companies, or filters; a jobs search URL replaces them all. location, industries, jobTitles and jobFunctions take ids from GET /api/v1/linkedin/search/parameters.

**Request body** (required)

- `connectedAccountId` (string · uuid, required): Connected account to act as
- `keywords` (string, optional)
- `companies` (string[], optional): Companies to search within. Each non-numeric identifier costs one extra lookup call.
- `location` (string, optional): A single location id from GET /api/v1/linkedin/search/parameters?type=LOCATION. One location per search.
- `industries` (string[], optional): Industry ids from GET /api/v1/linkedin/search/parameters?type=INDUSTRY.
- `jobTitles` (string[], optional): Job title ids from GET /api/v1/linkedin/search/parameters?type=JOB_TITLE.
- `jobFunctions` (string[], optional): Job function ids from GET /api/v1/linkedin/search/parameters?type=JOB_FUNCTION.
- `seniority` ("executive" | "director" | "mid_senior" | "associate" | "entry" | "intern"[], optional)
- `jobType` ("full_time" | "part_time" | "contract" | "temporary" | "volunteer" | "internship" | "other"[], optional)
- `workplace` ("on_site" | "hybrid" | "remote"[], optional)
- `postedWithinDays` (integer, optional)
- `sortBy` ("relevance" | "date", optional): Defaults to relevance.
- `searchUrl` (string · uri, optional): A LinkedIn jobs search URL, which cannot be combined with the filter fields above. Use it for filters this endpoint does not expose, such as salary.
- `cursor` (string, optional)
- `limit` (integer, optional): Page size, capped at 50 for a classic job search. Use cursor for the next page.

**200**: Jobs and an optional cursor.

- `jobs` (object[], required)
- `cursor` (string | null, required)

**Errors**

- `400`: Bad request
- `401`: Unauthorized: missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid request payload