Linked APILinked API

st.openJob

This action allows you to open a LinkedIn job and optionally retrieve its details.

Constraints

⏺️ Root Start: allowed, when jobUrl parameter is provided.

⬆️ Parent Actions: st.doForJobs.

⬇️ Child Actions: N/A.

Parameters

json
{
  "actionType": "st.openJob",
  "label": "job1",
  "jobUrl": "https://www.linkedin.com/jobs/view/4416248954/",
  "basicInfo": true
}
  • label (optional) – custom label for tracking this action in workflow completion.
  • jobUrl (required for root start, omitted for parent start) – LinkedIn job URL. When st.openJob is used under st.doForJobs, the URL is injected from the parent search result.
  • basicInfo (optional, default: false) – when set to true, the action includes job details in the result.

Result options

  1. Successful job opening with basicInfo set to true:
json
{
  "actionType": "st.openJob",
  "label": "job1",
  "success": true,
  "data": {
    "jobId": "4416248954",
    "jobUrl": "https://www.linkedin.com/jobs/view/4416248954/",
    "title": "Senior Product Manager",
    "companyName": "Example Company",
    "companyUrl": "https://www.linkedin.com/company/example-company",
    "location": "San Francisco, CA",
    "postedDate": "1w",
    "applicantsCount": 84,
    "workplaceType": "remote",
    "employmentType": "Full-time",
    "salary": {
      "currency": "usd",
      "minAmount": 140000,
      "maxAmount": 180000,
      "period": "yearly"
    },
    "description": "Example job description text.",
    "applyUrl": "https://www.linkedin.com/jobs/view/4416248954/apply/",
    "easyApply": true
  }
}
  • label – included only if specified in the action parameters.
  • data – job details.
    • jobId – LinkedIn job identifier.
    • jobUrl – normalized LinkedIn job URL.
    • title – job title.
    • companyName – company name, if available.
    • companyUrl – normalized LinkedIn company URL, if available.
    • location – free-form job location, if available.
    • postedDate – compact relative date, such as 1w, 3d, or 2mo, if available.
    • applicantsCount – number of applicants, if LinkedIn shows it.
    • workplaceType – workplace type label as shown by LinkedIn (such as remote, hybrid, or on-site), if available. Not one of the workplaceTypes filter values.
    • employmentType – employment type label as shown by LinkedIn (such as Full-time), if available. Not one of the employmentTypes filter values.
    • salary – parsed salary range, if LinkedIn shows one.
      • currency – lowercase currency code, such as usd, eur, or gbp.
      • minAmount – minimum amount in the parsed range.
      • maxAmount – maximum amount in the parsed range.
      • period – salary period. Possible values are yearly, monthly, and hourly.
    • description – job description text, if available.
    • applyUrl – Easy Apply or external application URL, if available.
    • easyApply – boolean indicating whether the job uses LinkedIn Easy Apply.
  1. Successful job opening with basicInfo set to false:
json
{
  "actionType": "st.openJob",
  "label": "job1",
  "success": true
}
  • label – included only if specified in the action parameters.
  • The action opens the job but does not include job details in the result.
  1. Failed job opening:
json
{
  "actionType": "st.openJob",
  "label": "job1",
  "success": false,
  "error": {
    "type": "jobNotFound",
    "message": "The job could not be opened or no longer exists."
  }
}
  • label – included only if specified in the action parameters.
  • error.type – enum with the following possible values:
    • jobNotFound – the job could not be opened or no longer exists.
Previousst.retrievePostReactionsNextst.doForCompanies