Search LinkedIn jobs
Search for job postings on LinkedIn with various filters. Supports pagination and multiple filter criteria including location, job type, experience level, and more. Falls back to unified search if primary search returns no results. Rate Limit: 300 searches per account per month (resets on the 1st of each month).
/search/jobsCode Examples
curl -X POST 'https://api.connectsafely.ai/linkedin/search/jobs' \ -H 'Authorization: Bearer <your_api_key>' \ -H 'Content-Type: application/json' \ -d '{"accountId":"acc_12345","keywords":"","count":25,"start":0,"filters":{"locationId":"San Francisco, CA","geoUrn":"urn:li:example:123456","companyIds":["Acme Inc"],"jobType":["default"],"experienceLevel":["example_value"],"workplaceType":["default"],"datePosted":"2024-01-15","industry":["Technology"],"easyApply":false}}'Parameters
No parameters.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
accountId | string | No | LinkedIn account ID to use for the search. If not provided, uses the default account. |
keywords | string | No | Search keywords for job title, company, or description |
count | number | No | Number of results to return per page |
start | number | No | Pagination offset (0-indexed) |
filters | object | No | Optional filters to narrow down search results |
Example
{
"accountId": "acc_12345",
"keywords": "",
"count": 25,
"start": 0,
"filters": {
"locationId": "San Francisco, CA",
"geoUrn": "urn:li:example:123456",
"companyIds": [
"Acme Inc"
],
"jobType": [
"default"
],
"experienceLevel": [
"example_value"
],
"workplaceType": [
"default"
],
"datePosted": "2024-01-15",
"industry": [
"Technology"
],
"easyApply": false
}
}Responses
| Status | Description |
|---|---|
| 200 | Jobs retrieved successfully |
| 400 | Bad Request - Invalid request parameters |
| 401 | Unauthorized - Invalid or missing API key |
| 500 | Internal Server Error - Failed to get LinkedIn credentials or search failed |
200 Response Parameters
| Name | Type | Description |
|---|---|---|
success | boolean | |
jobs | array | |
pagination | any | |
hasMore | boolean | Whether more results are available |
200 Example
{
"success": true,
"jobs": [
{
"jobId": "4367156030",
"title": "Founding Software Engineer - AI and Backend",
"companyName": "Dexicon",
"companyId": "109565258",
"companyUniversalName": "dexicon",
"location": "Bengaluru, Karnataka, India (Remote)",
"isRemote": true,
"isHybrid": false,
"jobUrl": "https://www.linkedin.com/jobs/view/4367156030/",
"easyApply": false
},
{
"jobId": "4321502503",
"title": "Software Engineer (backend)",
"companyName": "Kodo",
"companyId": "28718046",
"companyUniversalName": "kodohq",
"location": "Mumbai Metropolitan Region (On-site)",
"isRemote": false,
"isHybrid": false,
"jobUrl": "https://www.linkedin.com/jobs/view/4321502503/",
"easyApply": true
}
],
"pagination": {
"count": 25,
"start": 0,
"total": 1000
},
"hasMore": true
}400 Response Parameters
| Name | Type | Description |
|---|---|---|
success | boolean | |
error | object |
400 Example
{
"success": false,
"error": {
"issues": [
{
"code": "invalid_type",
"expected": "string",
"received": "undefined",
"path": [
"keywords"
],
"message": "Required"
}
],
"name": "ZodError"
}
}401 Response Parameters
| Name | Type | Description |
|---|---|---|
error | string |
401 Example
{
"error": "Unauthorized - Invalid credentials"
}500 Response Parameters
| Name | Type | Description |
|---|---|---|
error | string |
500 Example
{
"error": "Failed to search jobs",
"success": false
}Search LinkedIn people (alias)
Alias endpoint for /search/people. Search for LinkedIn members/professionals with extensive filtering options. Ideal for recruiting, sales prospecting, and networking. Filter by name, job title, company, location, connection degree, and more.
Get job details
Retrieve detailed information about a specific job posting including full description, requirements, company information, and application details. Use the jobId from search results.