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