HarvestAPI: Search Jobs

Search LinkedIn job postings by title, company, location, workplace type, and date posted.

Tool ID: harvestapi_search_jobs

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'harvestapi_search_jobs',
  {
    "search": "software companies hiring engineers",
    "companyId": "company_123",
    "location": "example"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute harvestapi_search_jobs --input '{
  "search": "software companies hiring engineers",
  "companyId": "company_123",
  "location": "example"
}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "elements": [
      {
        "id": "id_123"
      }
    ],
    "pagination": {
      "totalPages": 123,
      "totalElements": 123,
      "pageNumber": 123
    },
    "status": 1
  }
}

Use deepline describe harvestapi_search_jobs --json for the latest machine-readable contract.

Input reference

Search LinkedIn jobs by title, company, location, and more.

Name	Type	Required	Default	Details
`payload.search`	`string`	No	—	Search jobs by title
`payload.companyId`	`string`	No	—	Filter by company ID. One value or multiple comma-separated.
`payload.location`	`string`	No	—	Filter by location text
`payload.geoId`	`string`	No	—	Filter by location as LinkedIn Geo ID. Overrides the location query param. Use the /linkedin/geo-id-search endpoint to find the Geo ID
`payload.sortBy`	`"relevance" \| "date"`	No	—	Sort by field. Supported values: ‘relevance’, ‘date’ Allowed: `relevance`, `date`.
`payload.workplaceType`	`string`	No	—	Filter by workplace type. One or multiple values comma-separated. Supported values: ‘office’, ‘hybrid’, ‘remote’ Pattern: `^(office\|hybrid\|remote)(,(office\|hybrid\|remote))*$`.
`payload.employmentType`	`string`	No	—	Filter by employment type. One or multiple values comma-separated. Supported values: ‘full-time’, ‘part-time’, ‘contract’, ‘temporary’, ‘internship’ Pattern: `^(full-time\|part-time\|contract\|temporary\|internship)(,(full-time\|part-time\|contract\|temporary\|internship))*$`.
`payload.salary`	`"40k+" \| "60k+" \| "80k+" \| "100k+" \| "120k+" \| "140k+" \| "160k+" \| "180k+" \| "200k+"`	No	—	Filter by salary range. Supported values: ‘40k+’, ‘60k+’, ‘80k+’, ‘100k+’, ‘120k+’, ‘140k+’, ‘160k+’, ‘180k+’, ‘200k+’ Allowed: `40k+`, `60k+`, `80k+`, `100k+`, `120k+`, `140k+`, `160k+`, `180k+`, `200k+`.
`payload.postedLimit`	`"24h" \| "week" \| "month"`	No	—	Filter posts by maximum posted date. Supported values: ‘24h’, ‘week’, ‘month’ Allowed: `24h`, `week`, `month`.
`payload.experienceLevel`	`string`	No	—	Filter by experience level. One or multiple values comma-separated. Supported values: ‘internship’, ‘entry’, ‘associate’, ‘mid-senior’, ‘director’, ‘executive’ Pattern: `^(internship\|entry\|associate\|mid-senior\|director\|executive)(,(internship\|entry\|associate\|mid-senior\|director\|executive))*$`.
`payload.industryId`	`string`	No	—	Filter by industry ID. One value or multiple comma-separated industry IDs. Full list of IDs: https://github.com/HarvestAPI/linkedin-industry-codes-v2/blob/main/linkedin_industry_code_v2_all_eng.csv
`payload.functionId`	`string`	No	—	Filter by job function ID. One value or multiple comma-separated function IDs. Full list of IDs: https://github.com/HarvestAPI/apify-linkedin-profile-search/blob/main/.actor/input_schema.json#L142
`payload.under10Applicants`	`string`	No	—	Include this parameter to filter jobs with under 10 applicants
`payload.easyApply`	`"true" \| "false"`	No	—	Set this parameter to ‘true’ filter jobs with Easy Apply option or ‘false’ to exclude. Values can be ‘true’ or ‘false’ Allowed: `true`, `false`.
`payload.page`	`integer`	No	`1`	Page number for pagination

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.elements`	`array`	No	—	—
`result.data.elements[].id`	`string`	Yes	—	—
`result.data.elements[].url`	`string`	No	—	—
`result.data.elements[].title`	`string`	No	—	—
`result.data.elements[].postedDate`	`string`	No	—	Format: `date-time`.
`result.data.elements[].company`	`object`	No	—	—
`result.data.elements[].company.name`	`string`	No	—	—
`result.data.elements[].company.universalName`	`string`	No	—	—
`result.data.elements[].company.linkedinUrl`	`string`	No	—	—
`result.data.elements[].location`	`object`	No	—	—
`result.data.elements[].location.linkedinText`	`string`	No	—	—
`result.data.elements[].easyApply`	`boolean`	No	—	—
`result.data.pagination`	`object`	No	—	—
`result.data.pagination.totalPages`	`integer`	No	—	Format: `int32`.
`result.data.pagination.totalElements`	`integer`	No	—	Format: `int32`.
`result.data.pagination.pageNumber`	`integer`	No	—	Format: `int32`.
`result.data.pagination.previousElements`	`integer`	No	—	Format: `int32`.
`result.data.pagination.pageSize`	`integer`	No	—	Format: `int32`.
`result.data.pagination.paginationToken`	`string`	No	—	Format: `nullable`.
`result.data.status`	`string \| integer`	No	—	—
`result.data.error`	`string \| null`	No	—	—
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: provider_usage (provider usage).
Estimated Deepline credits: 0.01 per pricing unit.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation