> ## Documentation Index
> Fetch the complete documentation index at: https://orangeslice.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Scrape Jobs

> Scrape job listings from a careers page

<Info>
  <Icon icon="coins" /> **1 credit** per call
</Info>

## Method

```typescript theme={null}
services.company.careers.scrapeJobs(params);
```

Supports major ATS providers including Workday, iCIMS, Greenhouse, Lever, and LinkedIn.

## Input

<ParamField path="url" type="string" required>
  Careers page URL to scrape
</ParamField>

<ParamField path="maxJobs" type="number" default={1000}>
  Maximum jobs to scrape
</ParamField>

<ParamField path="recent" type="string" default="all">
  Filter by recency: `"24h"`, `"week"`, `"month"`, or `"all"`
</ParamField>

<ParamField path="scrapeDetails" type="boolean" default={false}>
  Include full job descriptions (slower)
</ParamField>

<ParamField path="exactMatchingOnly" type="boolean" default={false}>
  Only return jobs with guaranteed unique IDs
</ParamField>

## Output

Returns an array of job objects:

<ResponseField name="title" type="string">
  Job title
</ResponseField>

<ResponseField name="id" type="string" optional>
  Job ID (if available)
</ResponseField>

<ResponseField name="location" type="string" optional>
  Job location
</ResponseField>

<ResponseField name="description" type="string" optional>
  Full description (if `scrapeDetails: true`)
</ResponseField>

<ResponseField name="datePosted" type="string" optional>
  Posted date
</ResponseField>

## Example

```typescript theme={null}
const jobs = await services.company.careers.scrapeJobs({
  url: "https://careers.acme.com",
  maxJobs: 100,
  recent: "week",
});

return jobs.filter((j) => j.title.includes("Engineer"));
```

### Find careers page first, then scrape

```typescript theme={null}
// First find the careers page
const careers = await services.company.careers.findPage({
  domain: ctx.thisRow.get("Website"),
  companyLinkedinUrl: ctx.thisRow.get("Company LinkedIn"),
});

// Then scrape the job listings
const jobs = await services.company.careers.scrapeJobs({
  url: careers.url,
  maxJobs: 50,
  recent: "week",
});

return jobs;
```