Get Job Posts
curl --request POST \
--url https://api.linkupapi.com/v2/recruiter \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '
{
"account_id": "<string>",
"action": "<string>",
"params": {
"job_id": "<string>",
"count": 123,
"offset": 123,
"fetch_details": true
}
}
'{
"success": true,
"data": {
"posts": [
{
"linkedin_job_id": "4178681638",
"title": "Growth Hacker",
"company_name": "Acme Corp",
"location": "France",
"job_state": "CLOSED",
"employment_status": "Full-time",
"workplace_type": "",
"created_at": 1741369464000,
"listed_at": 1761591723000,
"closed_at": 1762167565000,
"num_views": 962,
"num_applies": 100,
"job_url": "https://www.linkedin.com/jobs/view/4178681638/",
"contact_email": "[email protected]",
"industry": ["Software Development"],
"budget": {
"total_charge": "277.20",
"currency": "EUR",
"buffered_total_charge": "417.00",
"daily_budget": "88.0"
}
}
],
"total_results": 1,
"total_available_results": 1,
"pagination": {
"offset": 0,
"count": 1,
"next_offset": null,
"has_more": false,
"results_per_page": 25
}
},
"metadata": {
"action": "get_posts",
"account_id": "your-account-id",
"credits_consumed": 1,
"timestamp": "2026-04-26T10:35:00Z"
}
}
Recruiting
Get Job Posts
Retrieve job postings from your recruiter account.
POST
/
v2
/
recruiter
Get Job Posts
curl --request POST \
--url https://api.linkupapi.com/v2/recruiter \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '
{
"account_id": "<string>",
"action": "<string>",
"params": {
"job_id": "<string>",
"count": 123,
"offset": 123,
"fetch_details": true
}
}
'{
"success": true,
"data": {
"posts": [
{
"linkedin_job_id": "4178681638",
"title": "Growth Hacker",
"company_name": "Acme Corp",
"location": "France",
"job_state": "CLOSED",
"employment_status": "Full-time",
"workplace_type": "",
"created_at": 1741369464000,
"listed_at": 1761591723000,
"closed_at": 1762167565000,
"num_views": 962,
"num_applies": 100,
"job_url": "https://www.linkedin.com/jobs/view/4178681638/",
"contact_email": "[email protected]",
"industry": ["Software Development"],
"budget": {
"total_charge": "277.20",
"currency": "EUR",
"buffered_total_charge": "417.00",
"daily_budget": "88.0"
}
}
],
"total_results": 1,
"total_available_results": 1,
"pagination": {
"offset": 0,
"count": 1,
"next_offset": null,
"has_more": false,
"results_per_page": 25
}
},
"metadata": {
"action": "get_posts",
"account_id": "your-account-id",
"credits_consumed": 1,
"timestamp": "2026-04-26T10:35:00Z"
}
}
Overview
Retrieve job postings from your LinkedIn recruiter account. Passjob_id to fetch a specific job (with full details) or omit it to list all jobs (offset-based pagination).
This endpoint consumes 1 credit per 10 results returned.
Request
Your API key for authentication.
The unique identifier of the account to use.
Must be
"get_posts".Show params properties
Show params properties
Fetch a single specific job posting by ID. When provided,
count and offset are ignored and fetch_details is forced to true.Number of job posts to return. Defaults to
10. Capped at 1000 per call.Zero-indexed offset into the job posts list. Defaults to
0. Use pagination.next_offset from a previous response to fetch the next page.Include full job details (description, budget, talent_questions, etc.). Set to
false for a faster lightweight listing.Response
Indicates whether the request was successful.
Show data properties
Show data properties
List of job postings.
Show post properties
Show post properties
LinkedIn numeric job ID.
Job title.
Hiring company name.
Job location.
Job state:
"LISTED", "CLOSED", "DRAFT", etc.Plain-text job description (only when
fetch_details: true).HTML-rich job description (only when
fetch_details: true).e.g.
"Full-time", "Part-time", "Contract", "Internship".e.g.
"Remote", "On-site", "Hybrid".Unix epoch (ms) when the job was created.
Unix epoch (ms) when the job became live.
Unix epoch (ms) when the job was closed (null if still open).
Total view count.
Total applicant count.
Public LinkedIn job URL.
Contact email associated with the job.
List of industry categories (strings).
Screening questions configured on the post.
Budget data when the job is sponsored:
total_charge, currency, buffered_total_charge, daily_budget.Reasons the post was suspended (empty when active).
Number of job posts returned in this response.
Total number of job posts on the recruiter account.
Show pagination properties
Show pagination properties
Offset of the first post in this response.
Number of posts returned (mirrors
total_results).Offset to send as
offset in the next request. null when exhausted.true if more posts are available beyond this batch.Maximum batch size used per upstream request (25).
{
"success": true,
"data": {
"posts": [
{
"linkedin_job_id": "4178681638",
"title": "Growth Hacker",
"company_name": "Acme Corp",
"location": "France",
"job_state": "CLOSED",
"employment_status": "Full-time",
"workplace_type": "",
"created_at": 1741369464000,
"listed_at": 1761591723000,
"closed_at": 1762167565000,
"num_views": 962,
"num_applies": 100,
"job_url": "https://www.linkedin.com/jobs/view/4178681638/",
"contact_email": "[email protected]",
"industry": ["Software Development"],
"budget": {
"total_charge": "277.20",
"currency": "EUR",
"buffered_total_charge": "417.00",
"daily_budget": "88.0"
}
}
],
"total_results": 1,
"total_available_results": 1,
"pagination": {
"offset": 0,
"count": 1,
"next_offset": null,
"has_more": false,
"results_per_page": 25
}
},
"metadata": {
"action": "get_posts",
"account_id": "your-account-id",
"credits_consumed": 1,
"timestamp": "2026-04-26T10:35:00Z"
}
}
Was this page helpful?
⌘I