Merge branch 'main' of https://github.com/Linked-API/linkedapi-node

Author: KirillSergeevich

src/core/operation.ts

@@ -25,9 +25,11 @@ export const OPERATION_NAME = {
   removeConnection: 'removeConnection',
   searchCompanies: 'searchCompanies',
   searchPeople: 'searchPeople',
+  searchJobs: 'searchJobs',
   fetchPerson: 'fetchPerson',
   fetchCompany: 'fetchCompany',
   fetchPost: 'fetchPost',
+  fetchJob: 'fetchJob',
   reactToPost: 'reactToPost',
   commentOnPost: 'commentOnPost',
   createPost: 'createPost',

src/index.ts

@@ -7,6 +7,7 @@ import {
   CreatePost,
   CustomWorkflow,
   FetchCompany,
+  FetchJob,
   FetchPerson,
   FetchPost,
   NvFetchCompany,
@@ -22,6 +23,7 @@ import {
   RetrievePerformance,
   RetrieveSSI,
   SearchCompanies,
+  SearchJobs,
   SearchPeople,
   SendConnectionRequest,
   SendMessage,
@@ -98,9 +100,11 @@ class LinkedApi {
     this.removeConnection = new RemoveConnection(this.httpClient);
     this.searchCompanies = new SearchCompanies(this.httpClient);
     this.searchPeople = new SearchPeople(this.httpClient);
+    this.searchJobs = new SearchJobs(this.httpClient);
     this.fetchCompany = new FetchCompany(this.httpClient);
     this.fetchPerson = new FetchPerson(this.httpClient);
     this.fetchPost = new FetchPost(this.httpClient);
+    this.fetchJob = new FetchJob(this.httpClient);
     this.reactToPost = new ReactToPost(this.httpClient);
     this.commentOnPost = new CommentOnPost(this.httpClient);
     this.createPost = new CreatePost(this.httpClient);
@@ -125,9 +129,11 @@ class LinkedApi {
       this.removeConnection,
       this.searchCompanies,
       this.searchPeople,
+      this.searchJobs,
       this.fetchCompany,
       this.fetchPerson,
       this.fetchPost,
+      this.fetchJob,
       this.reactToPost,
       this.commentOnPost,
       this.createPost,
@@ -579,6 +585,32 @@ class LinkedApi {
    */
   public fetchPost: FetchPost;
 
+  /**
+   * Retrieve detailed information about a LinkedIn job.
+   *
+   * This method fetches comprehensive data about a specific LinkedIn job,
+   * including company, location, salary, description, and application details.
+   *
+   * @param params - Parameters specifying the job URL
+   * @returns Promise resolving to an object containing the job data
+   *
+   * @see {@link https://linkedapi.io/docs/action-st-open-job/ st.openJob Action Documentation}
+   *
+   * @example
+   * ```typescript
+   * const workflow = await linkedapi.fetchJob.execute({
+   *   jobUrl: "https://www.linkedin.com/jobs/view/4416248954/"
+   * });
+   *
+   * const result = await linkedapi.fetchJob.result(workflow.workflowId);
+   * if (result.data) {
+   *   console.log("Job title:", result.data.title);
+   *   console.log("Company:", result.data.companyName);
+   * }
+   * ```
+   */
+  public fetchJob: FetchJob;
+
   /**
    * Search for companies on LinkedIn using standard search.
    *
@@ -676,6 +708,37 @@ class LinkedApi {
    */
   public searchPeople: SearchPeople;
 
+  /**
+   * Search for jobs on LinkedIn using standard search.
+   *
+   * This method performs a job search on LinkedIn using the standard search interface.
+   * You can filter by location, date posted, experience level, employment type, workplace type, and more.
+   *
+   * @param params - Search parameters including keywords, filters, and pagination options
+   * @returns Promise resolving to an object containing an array of job search results
+   *
+   * @see {@link https://linkedapi.io/docs/action-st-search-jobs/ st.searchJobs Action Documentation}
+   *
+   * @example
+   * ```typescript
+   * const workflow = await linkedapi.searchJobs.execute({
+   *   term: "product manager",
+   *   filter: {
+   *     location: "San Francisco, California, United States",
+   *     experienceLevels: ["midSeniorLevel", "director"],
+   *     workplaceTypes: ["remote", "hybrid"]
+   *   },
+   *   limit: 25
+   * });
+   *
+   * const jobsResult = await linkedapi.searchJobs.result(workflow.workflowId);
+   * if (jobsResult.data) {
+   *   console.log("Found jobs:", jobsResult.data.length);
+   * }
+   * ```
+   */
+  public searchJobs: SearchJobs;
+
   /**
    * Search for people on LinkedIn using Sales Navigator.
    *

src/operations/fetch-job.ts

@@ -0,0 +1,25 @@
+import { Operation, TOperationName } from '../core';
+import { TActionConfig, ThenWorkflowMapper, TResponseMappingConfig } from '../mappers';
+import { TBaseFetchJobParams, TFetchJobResult } from '../types';
+
+export class FetchJob extends Operation<TBaseFetchJobParams, TFetchJobResult> {
+  public override readonly operationName: TOperationName = 'fetchJob';
+  protected override readonly mapper = new FetchJobMapper();
+}
+
+const FETCH_JOB_ACTIONS: TActionConfig[] = [];
+
+const RESPONSE_MAPPINGS: TResponseMappingConfig[] = [];
+
+export class FetchJobMapper extends ThenWorkflowMapper<TBaseFetchJobParams, TFetchJobResult> {
+  constructor() {
+    super({
+      actionConfigs: FETCH_JOB_ACTIONS,
+      responseMappings: RESPONSE_MAPPINGS,
+      baseActionType: 'st.openJob',
+      defaultParams: {
+        basicInfo: true,
+      },
+    });
+  }
+}

src/operations/index.ts

@@ -10,7 +10,9 @@ export * from './nv-sync-conversation';
 export * from './nv-fetch-person';
 export * from './nv-search-companies';
 export * from './fetch-post';
+export * from './fetch-job';
 export * from './search-people';
+export * from './search-jobs';
 export * from './nv-search-people';
 export * from './send-connection-request';
 export * from './check-connection-status';

src/operations/search-jobs.ts

@@ -0,0 +1,10 @@
+import { Operation, TOperationName } from '../core';
+import { ArrayWorkflowMapper } from '../mappers/array-workflow-mapper';
+import { TSearchJobResult, TSearchJobsParams } from '../types';
+
+export class SearchJobs extends Operation<TSearchJobsParams, TSearchJobResult[]> {
+  public override readonly operationName: TOperationName = 'searchJobs';
+  protected override readonly mapper = new ArrayWorkflowMapper<TSearchJobsParams, TSearchJobResult>(
+    'st.searchJobs',
+  );
+}

src/types/actions/index.ts

@@ -1,6 +1,7 @@
 export * from './account';
 export * from './company';
 export * from './connection';
+export * from './job';
 export * from './message';
 export * from './person';
 export * from './post';

src/types/actions/job.ts

@@ -0,0 +1,152 @@
+import { TBaseActionParams } from '../params';
+
+export const JOB_DATE_POSTED = {
+  anyTime: 'anyTime',
+  past24Hours: 'past24Hours',
+  pastWeek: 'pastWeek',
+  pastMonth: 'pastMonth',
+} as const;
+export type TJobDatePosted = (typeof JOB_DATE_POSTED)[keyof typeof JOB_DATE_POSTED];
+
+export const JOB_EXPERIENCE_LEVEL = {
+  internship: 'internship',
+  entryLevel: 'entryLevel',
+  associate: 'associate',
+  midSeniorLevel: 'midSeniorLevel',
+  director: 'director',
+  executive: 'executive',
+} as const;
+export type TJobExperienceLevel = (typeof JOB_EXPERIENCE_LEVEL)[keyof typeof JOB_EXPERIENCE_LEVEL];
+
+export const JOB_EMPLOYMENT_TYPE = {
+  fullTime: 'fullTime',
+  partTime: 'partTime',
+  contract: 'contract',
+  temporary: 'temporary',
+  volunteer: 'volunteer',
+  internship: 'internship',
+  other: 'other',
+} as const;
+export type TJobEmploymentType = (typeof JOB_EMPLOYMENT_TYPE)[keyof typeof JOB_EMPLOYMENT_TYPE];
+
+export const JOB_WORKPLACE_TYPE = {
+  onSite: 'onSite',
+  remote: 'remote',
+  hybrid: 'hybrid',
+} as const;
+export type TJobWorkplaceType = (typeof JOB_WORKPLACE_TYPE)[keyof typeof JOB_WORKPLACE_TYPE];
+
+export const JOB_SALARY_PERIOD = {
+  yearly: 'yearly',
+  monthly: 'monthly',
+  hourly: 'hourly',
+} as const;
+export type TJobSalaryPeriod = (typeof JOB_SALARY_PERIOD)[keyof typeof JOB_SALARY_PERIOD];
+
+export const JOB_CURRENCY = {
+  usd: 'usd',
+  eur: 'eur',
+  gbp: 'gbp',
+  inr: 'inr',
+  cad: 'cad',
+  aud: 'aud',
+  nzd: 'nzd',
+  hkd: 'hkd',
+  sgd: 'sgd',
+  jpy: 'jpy',
+  cny: 'cny',
+  chf: 'chf',
+  sek: 'sek',
+  nok: 'nok',
+  dkk: 'dkk',
+  pln: 'pln',
+  czk: 'czk',
+  huf: 'huf',
+  ron: 'ron',
+  brl: 'brl',
+  mxn: 'mxn',
+  ars: 'ars',
+  zar: 'zar',
+  aed: 'aed',
+  sar: 'sar',
+  ils: 'ils',
+  try: 'try',
+  rub: 'rub',
+  uah: 'uah',
+  krw: 'krw',
+  thb: 'thb',
+  idr: 'idr',
+  myr: 'myr',
+  php: 'php',
+  vnd: 'vnd',
+  ngn: 'ngn',
+  twd: 'twd',
+} as const;
+export type TJobCurrency = (typeof JOB_CURRENCY)[keyof typeof JOB_CURRENCY];
+
+export interface TJobSalary {
+  currency: TJobCurrency | null;
+  minAmount: number | null;
+  maxAmount: number | null;
+  period: TJobSalaryPeriod | null;
+}
+
+export interface TJobFilter {
+  location?: string;
+  datePosted?: TJobDatePosted;
+  experienceLevels?: TJobExperienceLevel[];
+  employmentTypes?: TJobEmploymentType[];
+  workplaceTypes?: TJobWorkplaceType[];
+  companies?: string[];
+  industries?: string[];
+  jobFunctions?: string[];
+  easyApply?: boolean;
+  hasVerifications?: boolean;
+  under10Applicants?: boolean;
+  inYourNetwork?: boolean;
+  fairChanceEmployer?: boolean;
+}
+
+export interface TSearchJobsParams extends TBaseActionParams {
+  term?: string;
+  limit?: number;
+  filter?: TJobFilter;
+  customSearchUrl?: string;
+}
+
+export interface TSearchJobResult {
+  jobId: string | null;
+  jobUrl: string | null;
+  title: string;
+  companyName: string | null;
+  location: string | null;
+  workplaceType: string | null;
+  salary: TJobSalary | null;
+  easyApply: boolean;
+  isPromoted: boolean;
+}
+
+export interface TBaseFetchJobParams extends TBaseActionParams {
+  jobUrl: string;
+}
+
+export type TFetchJobParams = TBaseFetchJobParams;
+
+export interface TJob {
+  jobId: string;
+  jobUrl: string;
+  title: string;
+  companyName: string | null;
+  companyUrl: string | null;
+  location: string | null;
+  postedDate: string | null;
+  applicantsCount: number | null;
+  workplaceType: string | null;
+  employmentType: string | null;
+  salary: TJobSalary | null;
+  description: string | null;
+  applyUrl: string | null;
+  easyApply: boolean;
+}
+
+export type TFetchJobResult = TJob;

src/types/errors.ts

@@ -17,9 +17,10 @@ import { TOperationName } from '../core';
  * - notPending (withdrawConnectionRequest))
  * - retrievingNotAllowed (retrieveConnections, fetchCompany, nvFetchCompany)
  * - connectionNotFound (removeConnection)
- * - searchingNotAllowed (searchCompanies, searchPeople, nvSearchCompanies, nvSearchPeople)
+ * - searchingNotAllowed (searchCompanies, searchPeople, searchJobs, nvSearchCompanies, nvSearchPeople)
  * - companyNotFound (fetchCompany, nvFetchCompany)
  * - postNotFound (fetchPost, reactToPost, commentOnPost)
+ * - jobNotFound (fetchJob)
  * - commentingNotAllowed (commentOnPost)
  * - noPostingPermission (createPost, reactToPost, commentOnPost)
  * - noSalesNavigator (nvSendMessage, nvSyncConversation, nvSearchCompanies, nvSearchPeople, nvFetchCompany, nvFetchPerson)
@@ -41,6 +42,7 @@ export const LINKED_API_ACTION_ERROR = {
   searchingNotAllowed: 'searchingNotAllowed',
   companyNotFound: 'companyNotFound',
   postNotFound: 'postNotFound',
+  jobNotFound: 'jobNotFound',
   commentingNotAllowed: 'commentingNotAllowed',
   noPostingPermission: 'noPostingPermission',
   noSalesNavigator: 'noSalesNavigator',