Name: Jobs API: Search Career Page Jobs from Company ATS Boards
Brand: siftwright
SKU: api-siftwright-career-jobs-api
Availability: InStock
Author: API Market

Siftwright Data

# Career Page Jobs Search API

## Overview

The Career Page Jobs Search API returns open job postings taken from the public job feeds that companies publish on their own career pages through seven applicant tracking systems (ATS): Greenhouse, Lever, Ashby, Workable, SmartRecruiters, Recruitee and Personio. It has 3 endpoints. Search queries a daily index of open jobs across every indexed company, newest first, with filters for title keywords, excluded words, location, remote, department, platform, company, published salary and posting date. Company jobs lists every open role at one company, fetched live on each call from a careers page URL, a job board URL or a `platform:slug` shortcut such as `ashby:ramp`, so it also works for companies outside the index. Index health reports how many jobs and companies the index holds and when it was last built; in our test it held 396,429 jobs from 7,302 companies.

It is built for recruiters and staffing agencies watching for new openings in their niche, job boards and job-search apps that want first-party listings with apply links, sales and growth teams that use hiring as a buying signal, researchers tracking labour-market trends, and career assistants that need to answer "who is hiring for X near Y" with current data. Every job comes back in the same shape on both job endpoints: platform, company name and slug, job ID, title, department, team, primary location and the full `locations` list, an `isRemote` flag, workplace type, employment type, salary (min, max, currency, interval and the original text) when the employer publishes it, country, posting date, and links to the posting and the application form. Fields the employer's ATS does not provide come back as `null`.

## Features

*   **3 endpoints**: Search jobs across the index, list every open job at one company, and check index health.
*   **Seven ATS platforms**: Greenhouse, Lever, Ashby, Workable, SmartRecruiters, Recruitee and Personio, filterable with `platform`.
*   **Flexible company input**: The company endpoint accepts a careers page URL, a job board URL, or a `platform:slug` shortcut such as `ashby:ramp`.
*   **Search filters**: Comma-separated title keywords (`q`), excluded title words (`exclude`), `location`, `remote`, `department`, `platform`, `company`, `has_salary` and `posted_within_days`, with `limit` (up to 100) and `offset` for paging.
*   **Live company lookups**: The company endpoint reads the company's board on each call and returns up to 500 jobs, with optional plain-text job descriptions.
*   **Salary data**: When an employer publishes pay, `salary` carries numeric `min` and `max`, `currency`, `interval` and the original `text`.
*   **Data source**: Public job feeds of the ATS each company uses for its own career page. The search index is rebuilt daily, and `indexBuiltAt` tells you when.
*   **Rate limit**: 10 requests per second on every plan.

## Use Cases

*   **Recruiting and staffing**: Find companies posting roles in your specialty in the last few days with `posted_within_days`.
*   **Niche job boards**: Fill a remote, city or industry board with first-party listings and direct apply links.
*   **Sales prospecting**: Spot companies building out engineering, data, security or sales teams and reach them while they are hiring.
*   **Labour-market research**: Track role volumes, remote share and salary transparency by location or department.
*   **Company monitoring**: Pull every open role at a target company, including companies outside the index, and compare runs over time.
*   **Career assistants**: Answer job-search questions with current postings and links to the original application form.

## API Documentation

### Base URL

All requests go through the API.market gateway at this base URL:

```
https://prod.api.market/api/v1/siftwright/career-jobs-api
```

### Authentication

Every request needs your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Search jobs

Searches the daily index of open jobs from all indexed companies and returns them newest first. The response gives the `total` number of matches, the `offset` and `limit` used, the `indexBuiltAt` time of the index, and a `jobs` array. Every word of a keyword in `q` must appear in the title, and comma-separated keywords let you search several titles at once.

**Method:** `GET`

**Endpoint:** `/search`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `q` | query | Title keywords, comma-separated, for example `data engineer`. Every word of a keyword must appear in the title. | string | No | - | - |
| `exclude` | query | Drop jobs whose title contains any of these words, comma-separated, for example `intern,principal`. | string | No | - | - |
| `location` | query | City, region or country, comma-separated, for example `Toronto,Remote`. | string | No | - | - |
| `remote` | query | Set to `true` to return remote jobs only. | boolean | No | - | - |
| `department` | query | Department or team name contains this text, for example `Engineering`. | string | No | - | - |
| `platform` | query | One of `greenhouse`, `lever`, `ashby`, `workable`, `smartrecruiters`, `recruitee`, `personio`. | string | No | - | - |
| `company` | query | Company name or board slug contains this text, for example `stripe`. | string | No | - | - |
| `has_salary` | query | Set to `true` to return only jobs that publish a salary. | boolean | No | - | - |
| `posted_within_days` | query | Only jobs posted in the last N days. `0` means any time. | integer | No | - | - |
| `limit` | query | Number of results to return. | integer | No | - | 100 |
| `offset` | query | Number of results to skip, for pagination. | integer | No | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/siftwright/career-jobs-api/search?q=data%20engineer&location=New%20York&limit=2" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK):**

```json
{
  "total": 188,
  "offset": 0,
  "limit": 2,
  "indexBuiltAt": "2026-10-19T05:07:08.919Z",
  "jobs": [
    {
      "platform": "greenhouse",
      "companyName": "DoorDash USA",
      "companySlug": "doordashusa",
      "jobId": "8294468",
      "title": "Staff Software Engineer, Data - Experimentation",
      "department": null,
      "team": null,
      "location": "California, CA; San Francisco, CA; Seattle, WA; New York,NY",
      "locations": [
        "California, CA; San Francisco, CA; Seattle, WA; New York,NY"
      ],
      "isRemote": false,
      "workplaceType": null,
      "employmentType": null,
      "salary": null,
      "postedAt": "2026-10-17T07:28:44.000Z",
      "url": "https://job-boards.greenhouse.io/doordashusa/jobs/8294468",
      "applyUrl": "https://job-boards.greenhouse.io/doordashusa/jobs/8294468",
      "country": null
    },
    {
      "platform": "greenhouse",
      "companyName": "CoreWeave",
      "companySlug": "coreweave",
      "jobId": "4722819006",
      "title": "Director, Data Center Engineering",
      "department": null,
      "team": null,
      "location": "Livingston, NJ / New York, NY / Sunnyvale, CA / San Francisco, CA / Bellevue, WA",
      "locations": [
        "Livingston, NJ / New York, NY / Sunnyvale, CA / San Francisco, CA / Bellevue, WA"
      ],
      "isRemote": false,
      "workplaceType": null,
      "employmentType": null,
      "salary": null,
      "postedAt": "2026-10-16T23:38:51.000Z",
      "url": "https://coreweave.com/careers/job?4722819006&board=coreweave&gh_jid=4722819006",
      "applyUrl": "https://coreweave.com/careers/job?4722819006&board=coreweave&gh_jid=4722819006",
      "country": null
    }
  ]
}
```

Use `offset` with `limit` to page through `total`. Some Greenhouse boards put several cities in one location string, as these two results show, so match on `location` text rather than expecting one city per entry.

#### 2. Company jobs

Returns every open job at one company, fetched live from its board on each call, so it reflects what is open right now. The response gives the detected `platform`, `companySlug` and `companyName`, the `totalOpenJobs` on the board, the number `returned`, and a `jobs` array. Jobs from this endpoint also carry `updatedAt` and `requisitionId` fields. The company does not have to be in the search index.

**Method:** `GET`

**Endpoint:** `/company`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `company` | query | Careers page URL, job board URL, or `platform:slug` shortcut such as `ashby:ramp`. URL-encode the value. | string | Yes | - | - |
| `q` | query | Optional title keywords to filter the company's jobs, for example `engineer`. | string | No | - | - |
| `description` | query | Set to `true` to include plain-text job descriptions. | boolean | No | - | - |
| `limit` | query | Maximum number of jobs to return. | integer | No | - | 500 |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/siftwright/career-jobs-api/company?company=ashby%3Aramp&limit=2" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK):**

```json
{
  "platform": "ashby",
  "companySlug": "ramp",
  "companyName": "Ramp",
  "totalOpenJobs": 167,
  "returned": 2,
  "jobs": [
    {
      "platform": "ashby",
      "companyName": "Ramp",
      "companySlug": "ramp",
      "jobId": "34413f8d-26bf-4bbc-8ade-eb309a0e2245",
      "title": "Security Engineer, Cloud",
      "department": "Engineering",
      "team": "Backend",
      "location": "New York, NY (HQ)",
      "locations": [
        "New York, NY (HQ)",
        "Remote (Canada)",
        "Remote (US)",
        "Miami, FL"
      ],
      "isRemote": true,
      "workplaceType": "hybrid",
      "employmentType": "FullTime",
      "salary": {
        "min": 211400,
        "max": 290600,
        "currency": "USD",
        "interval": "year",
        "text": "$211.4K \u2013 $290.6K • Offers Equity"
      },
      "postedAt": "2026-04-07T17:12:35.753Z",
      "updatedAt": null,
      "url": "https://jobs.ashbyhq.com/ramp/34413f8d-26bf-4bbc-8ade-eb309a0e2245",
      "applyUrl": "https://jobs.ashbyhq.com/ramp/34413f8d-26bf-4bbc-8ade-eb309a0e2245/application",
      "requisitionId": null,
      "country": "USA"
    },
    {
      "platform": "ashby",
      "companyName": "Ramp",
      "companySlug": "ramp",
      "jobId": "f564dcf9-9390-4a3f-896f-8047a5086040",
      "title": "Mobile Engineer, Android",
      "department": "Engineering",
      "team": "Mobile",
      "location": "New York, NY (HQ)",
      "locations": [
        "New York, NY (HQ)",
        "Remote (Canada)",
        "San Francisco, CA",
        "Remote (US)"
      ],
      "isRemote": true,
      "workplaceType": "hybrid",
      "employmentType": "FullTime",
      "salary": {
        "min": 189000,
        "max": 330000,
        "currency": "USD",
        "interval": "year",
        "text": "$189K \u2013 $330K • Offers Equity"
      },
      "postedAt": "2025-07-31T21:58:34.674Z",
      "updatedAt": null,
      "url": "https://jobs.ashbyhq.com/ramp/f564dcf9-9390-4a3f-896f-8047a5086040",
      "applyUrl": "https://jobs.ashbyhq.com/ramp/f564dcf9-9390-4a3f-896f-8047a5086040/application",
      "requisitionId": null,
      "country": "USA"
    }
  ]
}
```

`totalOpenJobs` counts every open role on the board, while `returned` is the number in this response after `q` and `limit` are applied. The salary `text` is the employer's own wording; the JSON escape `\u2013` is a range dash.

#### 3. Index health

Returns the state of the daily search index: whether it is healthy (`ok`), the number of `jobs` and `companies` it holds, and `indexBuiltAt`, the time it was last rebuilt. Use it to check freshness before a batch of searches.

**Method:** `GET`

**Endpoint:** `/health`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| - | - | This endpoint takes no parameters. | - | - | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/siftwright/career-jobs-api/health" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK):**

```json
{
  "ok": true,
  "jobs": 396429,
  "companies": 7302,
  "indexBuiltAt": "2026-10-19T05:07:08.919Z"
}
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded. Search returns `total` and a `jobs` array, company jobs returns `totalOpenJobs` and a `jobs` array. |
| 400 | Bad Request | A parameter is missing or invalid, for example `/company` called without the required `company` value. |
| 401 | Unauthorized | The `x-api-market-key` value is invalid or expired. |
| 403 | Forbidden | Your subscription does not include this endpoint. |
| 404 | Not Found | The endpoint path does not exist. Check that you are calling `/search`, `/company` or `/health` under the base URL. |
| 429 | Too Many Requests | You went over 10 requests per second, or you have used all the calls in your plan. |
| 500 | Internal Server Error | Something failed while processing the request, for example the company's job board did not answer. Retry after a short delay. |

## Rate Limits

The Free trial, Starter, Basic, Pro and Ultra plans each allow 10 requests per second. They include 100, 300, 2,000, 10,000 and 50,000 calls respectively (the Free plan is a 7-day trial), and every call counts as one call whichever endpoint you use. All plans have hard limits: requests above the per-second limit, or after the plan's calls are used up, return `429 Too Many Requests`. Back off before retrying and honour any `Retry-After` header. The first call after the service has been idle is slower; in our tests it took about 4 to 7 seconds, after which search answered in about 0.6 seconds and a company lookup in about 0.8 seconds. Company lookups on large boards can take longer because the board is read live.

## FAQ

**Where does the job data come from?**

From the public job feeds of the applicant tracking systems that companies use for their own career pages: Greenhouse, Lever, Ashby, Workable, SmartRecruiters, Recruitee and Personio. Each job links to the original posting (`url`) and the application form (`applyUrl`). The job content belongs to the employers who published it.

**How fresh are the results?**

The search index is rebuilt daily; check `indexBuiltAt` in any search response or call `/health`. The company endpoint reads the company's board live on every call, so it always shows what is open at that moment.

**Can I look up a company that is not in the search index?**

Yes. Pass its careers page URL, its job board URL, or a `platform:slug` shortcut such as `ashby:ramp` to `/company`. The index only covers companies in the provider's directory, but the company endpoint does not depend on it.

**How do I page through search results?**

Use `limit` (up to 100) and `offset`. For example, `limit=100&offset=0` returns the first page and `offset=100` the second. `total` tells you how many jobs match. The company endpoint returns up to 500 jobs in one call, so it does not need paging.

**Why are `department`, `salary` or `country` sometimes `null`?**

The API returns what the employer's ATS feed provides. Many boards leave department, workplace type, employment type or country empty, and many employers do not publish pay. Set `has_salary=true` on `/search` to return only jobs with a salary.

**Which companies and roles are not covered?**

Only roles that companies publish on their own career pages through the seven supported ATS platforms. Companies that use other systems, or post only on job boards, are not included. Postings close over time, so use `posted_within_days` to focus on new roles.

**Why was my first request slow?**

The first call after a period with no traffic takes longer while the service starts. In our tests that first call took about 4 to 7 seconds, and calls after it answered in under a second.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Jobs API that searches about 400,000 openings from 7,000+ company career pages on Greenhouse, Lever, Ashby and more, with title, location and salary filters.

Jobs API: Search Career Page Jobs from Company ATS Boards

Free