Skip to main content
POST
/
v1
/
recruiter
/
posts
Get Job Posts
curl --request POST \
  --url https://api.linkupapi.com/v1/recruiter/posts \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "login_token": "<string>",
  "job_id": "<string>",
  "fetch_details": true,
  "total_results": 123,
  "start_page": 123,
  "end_page": 123,
  "country": "<string>"
}
'
{
  "status": "success",
  "data": {
    "total_results": 1,
    "total_available_results": 5,
    "fetch_details": true,
    "posts": [
      {
        "linkedin_job_id": "4178681649",
        "title": "Directeur marketing",
        "company_name": "Linkup API",
        "location": "Nice, Provence-Alpes-Côte d'Azur, France",
        "job_state": "SUSPENDED",
        "description": "The ideal candidate will be responsible leading an effective marketing strategy to propel company growth...",
        "editableDescription": "<p>The ideal candidate will be responsible leading an effective marketing strategy...</p>",
        "employment_status": "Temps plein",
        "workplace_type": "Sur site",
        "created_at": 1741369498000,
        "listed_at": 1741430682000,
        "closed_at": null,
        "num_views": 346,
        "num_applies": 52,
        "job_url": "https://www.linkedin.com/jobs/view/4178681649/",
        "contact_email": "[email protected]",
        "suspend_reasons": ["FREE_JOB_APPLICATION_LIMIT"],
        "industry": ["Développement de logiciels"],
        "talent_questions": ["Avez-vous le niveau d'études requis : Maîtrise ?"],
        "budget": {
          "total_charge": "0.00",
          "currency": "EUR",
          "buffered_total_charge": "93.00",
          "daily_budget": "0"
        }
      }
    ],
    "pagination": {
      "start_page": 1,
      "end_page": 1,
      "items_per_page": 10,
      "pages_fetched": 1
    }
  }
}

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.

Retrieve information about the job postings you have created on LinkedIn. You can choose between getting basic information (title, company, location) at no cost, or complete details (description, applicant statistics, workplace type, industry) for 1 credit per job posting.
Credit Usage:
  • With fetch_details: true (default): 1 credit per job posting retrieved.
  • With fetch_details: false: 1 credit per 10 results (or fraction thereof). For example:
    • 1-10 results = 1 credit
    • 11-20 results = 2 credits
    • 300 results = 30 credits
  • When specifying a job_id, 1 credit is always used regardless of fetch_details value.

​
Header Parameters

​
x-api-key
string
required
Your API key

​
Body Parameters

​
login_token
string
required
LinkedIn authentication cookie obtained from the login/verify process
​
job_id
string
Optional: Retrieve details for a specific job posting by its LinkedIn ID
​
fetch_details
boolean
default:"true"
Whether to retrieve complete job details (true) or basic information only (false)
​
total_results
number
default:"10"
Number of job postings to retrieve per page when using pagination
​
start_page
number
default:"1"
First page to fetch when using pagination mode
​
end_page
number
default:"same as start_page"
Last page to fetch when using pagination mode
​
country
string
default:"FR"
Country code for proxy selection. Available: (US, UK, FR, DE, NL, IT, IL, CA, BR, ES, IN)

​
Response

​
status
string
Request status (success/error)
​
data
object
Response data container
​
data.total_results
number
Number of job postings returned in this response
​
data.total_available_results
number
Total number of job postings available on LinkedIn
​
data.fetch_details
boolean
Indicates whether the response contains complete details or basic information only
​
data.pagination
object
Pagination information (not included when using job_id)
​
data.posts
array
List of job postings with details according to fetch_details parameter
​
data.posts[].linkedin_job_id
string
LinkedIn’s internal job posting ID
​
data.posts[].title
string
Job posting title
​
data.posts[].company_name
string
Company name
​
data.posts[].location
string
Job location
​
data.posts[].job_url
string
URL to view the job posting
​
data.posts[].posted_date
string
Human-readable posting date (e.g. “Posted 2 days ago”) - Basic info only
​
data.posts[].status
string
Basic status (e.g. “Active”) - Basic info only
​
data.posts[].applicants_count
string
Human-readable applicant count (e.g. “25+ applicants”) - Basic info only
The following fields are only available when fetch_details is true:
​
data.posts[].job_state
string
Current state of the job posting (OPEN, CLOSED, SUSPENDED, etc.)
​
data.posts[].description
string
Full job description
​
data.posts[].editableDescription
string
HTML-formatted job description
​
data.posts[].employment_status
string
Employment type (Full-time, Part-time, etc.)
​
data.posts[].workplace_type
string
Workplace type (On-site, Remote, Hybrid)
​
data.posts[].created_at
number
Timestamp when job was created
​
data.posts[].listed_at
number
Timestamp when job was listed
​
data.posts[].closed_at
number
Timestamp when job was closed (if applicable)
​
data.posts[].num_views
number
Number of views the job posting has received
​
data.posts[].num_applies
number
Number of applications the job posting has received
​
data.posts[].contact_email
string
Contact email for the job posting
​
data.posts[].suspend_reasons
array
Reasons why the job posting might be suspended
​
data.posts[].industry
array
Industries associated with the job posting
​
data.posts[].talent_questions
array
Screening questions for applicants
​
data.posts[].budget
object
Budget information for the job posting
{
  "status": "success",
  "data": {
    "total_results": 1,
    "total_available_results": 5,
    "fetch_details": true,
    "posts": [
      {
        "linkedin_job_id": "4178681649",
        "title": "Directeur marketing",
        "company_name": "Linkup API",
        "location": "Nice, Provence-Alpes-Côte d'Azur, France",
        "job_state": "SUSPENDED",
        "description": "The ideal candidate will be responsible leading an effective marketing strategy to propel company growth...",
        "editableDescription": "<p>The ideal candidate will be responsible leading an effective marketing strategy...</p>",
        "employment_status": "Temps plein",
        "workplace_type": "Sur site",
        "created_at": 1741369498000,
        "listed_at": 1741430682000,
        "closed_at": null,
        "num_views": 346,
        "num_applies": 52,
        "job_url": "https://www.linkedin.com/jobs/view/4178681649/",
        "contact_email": "[email protected]",
        "suspend_reasons": ["FREE_JOB_APPLICATION_LIMIT"],
        "industry": ["Développement de logiciels"],
        "talent_questions": ["Avez-vous le niveau d'études requis : Maîtrise ?"],
        "budget": {
          "total_charge": "0.00",
          "currency": "EUR",
          "buffered_total_charge": "93.00",
          "daily_budget": "0"
        }
      }
    ],
    "pagination": {
      "start_page": 1,
      "end_page": 1,
      "items_per_page": 10,
      "pages_fetched": 1
    }
  }
}