> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkupapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Job Posts
> Retrieve job postings from your recruiter account.
## Overview
Retrieve job postings from your recruiter account. Pass `job_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. Ignore this if you're on per-seat pricing: usage is unlimited.
## Request
Your API key for authentication.
The unique identifier of the account to use.
Must be `"get_posts"`.
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.
List of job postings.
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 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.
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).
The action that was performed (`"get_posts"`).
The account ID used for the request.
Number of credits consumed (1 per 10 results).
ISO 8601 timestamp of the response.
```json 200 theme={null}
{
"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": "hiring@example.com",
"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"
}
}
```
```json 400 theme={null}
{
"success": false,
"error": {
"code": "INVALID_PARAMS",
"message": "account_id is required."
},
"metadata": {
"action": "get_posts",
"account_id": null,
"credits_consumed": 0,
"timestamp": "2026-04-26T10:35:00Z"
}
}
```