POST
/
v1
/
recruiter
/
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
    }
  }
}

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)

​
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
    }
  }
}