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.
/search/jobs/detailsCode Examples
curl -X POST 'https://api.connectsafely.ai/linkedin/search/jobs/details' \ -H 'Authorization: Bearer <your_api_key>' \ -H 'Content-Type: application/json' \ -d '{"jobId":"12345"}'Parameters
No parameters.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
accountId | string | No | LinkedIn account ID to use. If not provided, uses the default account. |
jobId | string | Yes | LinkedIn job ID from search results |
Example
{
"jobId": "12345"
}Responses
| Status | Description |
|---|---|
| 200 | Job details retrieved successfully |
| 400 | Bad Request - Missing required jobId parameter |
| 401 | Unauthorized - Invalid or missing API key |
| 500 | Internal Server Error - Failed to get LinkedIn credentials or job details |
200 Response Parameters
| Name | Type | Description |
|---|---|---|
success | boolean | |
jobId | string | LinkedIn job ID |
description | string | Full job description with requirements and responsibilities |
postedOn | string | When the job was posted (e.g., "Posted on Jan 29, 2026.") |
linkedinUrl | string | Direct URL to the job posting |
200 Example
{
"success": true,
"jobId": "4367156030",
"description": "We're hiring a high autonomy founding engineer to build...",
"postedOn": "Posted on Jan 29, 2026.",
"linkedinUrl": "https://www.linkedin.com/jobs/view/4367156030/"
}400 Response Parameters
| Name | Type | Description |
|---|---|---|
success | boolean | |
error | object |
400 Example
{
"success": false,
"error": {
"issues": [
{
"code": "invalid_type",
"expected": "string",
"received": "undefined",
"path": [
"jobId"
],
"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 get job details",
"success": false
}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 LinkedIn companies
Search for companies on LinkedIn by keywords and filters. Filter by headquarters location, industry, company size, and type. Useful for lead generation, market research, and finding potential business partners. Sales Navigator Support: Pass a Sales Navigator company search URL in the `url` parameter to search using Sales Navigator filters (revenue, employees, etc.). Requires Sales Navigator license on the LinkedIn account. Rate Limit: 300 searches per account per month (resets on the 1st of each month).