Name: Jobs Search API: Live Jobs from Company Career Sites
Brand: steadyscrape
SKU: api-steadyscrape-jobs-search
Availability: InStock
Author: API Market

# Jobs Search API

## Overview

The Jobs Search API returns live job openings straight from employers' own career sites on Greenhouse, Lever, Ashby, Workday, BambooHR, Workable, Recruitee, Personio, Rippling, Teamtailor, Breezy, Gem and Oracle HCM, not from reposting job boards. Three endpoints cover keyword search, remote search by where a candidate can work from, and every open job on specific company boards.

It is built for job boards, recruiting tools, labour market researchers and candidate alert services. Every job comes back in the same JSON shape: title, company, department, team, locations, remote or hybrid flag, employment type, salary when published, posted and updated dates, and the job and apply links. Remote results add eligible countries and regions, time zones and the evidence for each.

## Features

*   **13 ATS platforms**: one schema across Greenhouse, Lever, Ashby, Workday and nine more.
*   **Three endpoints**: keyword search, remote search and company board listing.
*   **Search filters**: country, location, remote, company, platform, employment type, posted within days and salary only.
*   **Remote eligibility**: worker country, region, time zone and remote type on `/v1/jobs/remote`.
*   **Optional descriptions**: `include_description` adds the full job text.
*   **Rate limit**: 1 request per second on Free, Starter and Business, 2 on Pro.

## Use Cases

*   **Job boards and aggregators**: fill a board with fresh roles direct from employers.
*   **Remote job tools**: show candidates only roles open to their country and time zone.
*   **Job widgets**: embed a company's open roles from its board link.
*   **Labour market research**: track postings by platform, company and salary.

## API Documentation

### Base URL

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

```
https://prod.api.market/api/v1/steadyscrape/jobs-search
```

### 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

Returns jobs from company career sites that match a keyword, with location, remote, company, platform, type, date and salary filters.

**Method:** `GET`

**Endpoint:** `/v1/jobs/search`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `query` | query | Job title keywords, comma separated. A job matches any of them. Up to 5 values. | string | Yes | - | - |
| `exclude` | query | Drop jobs whose title contains any of these words, comma separated. Up to 10 values. | string | No | - | - |
| `country` | query | Two-letter country codes, comma separated, for example US,CA. Up to 10 values. | string | No | - | - |
| `location` | query | City, state or region names, comma separated. Up to 5 values. | string | No | - | - |
| `remote` | query | true to return only remote jobs. | boolean | No | `false` | - |
| `company` | query | Only jobs from these company names, comma separated. Up to 10 values. | string | No | - | - |
| `platform` | query | Only jobs from these applicant tracking systems. Up to 13 values. | string | No | - | - |
| `employment_type` | query | Employment types, comma separated. Up to 6 values. | string | No | - | - |
| `posted_within_days` | query | Only jobs posted in the last N days (1-90). | integer | No | - | 90 |
| `salary_only` | query | true to return only jobs that publish a salary. | boolean | No | `false` | - |
| `sort` | query | Sort order: newest or relevance. | string | No | `newest` | - |
| `limit` | query | Maximum number of jobs to return (1-25). Default 10. | integer | No | `10` | 25 |
| `include_description` | query | true to include the plain-text job description (trimmed to 4,000 characters). | boolean | No | `false` | - |

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/steadyscrape/jobs-search/v1/jobs/search?query=python%20developer&remote=false&salary_only=false&sort=newest&limit=3&include_description=false' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "success": true,
  "endpoint": "jobs.search",
  "count": 3,
  "partial": false,
  "items": [
    {
      "jobId": "bamboohr:cialdnb:713",
      "sourceJobId": "713",
      "platform": "bamboohr",
      "boardSlug": "cialdnb",
      "company": "Cialdnb",
      "title": "Python Developer - IA",
      "department": "Data Science & Engineering",
      "team": null,
      "locations": [
        {
          "raw": "São Paulo, SP, Brazil",
          "city": "São Paulo",
          "region": "SP",
          "country": "Brazil",
          "countryCode": "BR",
          "isRemote": false
        }
      ],
      "locationText": "São Paulo, SP, Brazil",
      "isRemote": true,
      "workplaceType": "REMOTE",
      "employmentType": "CONTRACT",
      "employmentTypeRaw": null,
      "salary": null,
      "postedAt": null,
      "updatedAt": null,
      "jobUrl": "https://cialdnb.bamboohr.com/careers/713",
      "applyUrl": "https://cialdnb.bamboohr.com/careers/713",
      "requisitionId": null,
      "scrapedAt": "2026-10-28T13:02:31Z",
      "boardUrl": "https://cialdnb.bamboohr.com/careers",
      "matchedKeyword": "python developer",
      "source": {
        "type": "public career site (ATS job board API)",
        "indexRefreshedAt": "2026-10-28T14:21:01Z",
        "boardFetchedAt": "2026-10-28T13:02:31Z",
        "firstSeenAt": "2026-10-28T00:00:00Z",
        "descriptionFetchedLive": false,
        "verifiedListedAt": null
      }
    }
  ],
  "meta": {
    "generatedAt": "2026-10-29T04:50:03.712Z",
    "tookMs": 5711,
    "version": "1.0.0"
  }
}
```

#### 2. Search remote jobs

Returns remote jobs filtered by the countries, regions and time zones a candidate can work from, with the evidence for each.

**Method:** `GET`

**Endpoint:** `/v1/jobs/remote`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `query` | query | Job title keywords, comma separated. Leave empty for all categories. Up to 5 values. | string | No | - | - |
| `exclude` | query | Drop jobs whose title contains any of these words. Up to 10 values. | string | No | - | - |
| `worker_country` | query | Two-letter codes of countries the worker lives in, for example CA,MX. Up to 5 values. | string | No | - | - |
| `region` | query | Regions the worker lives in. Up to 5 values. | string | No | - | - |
| `remote_type` | query | Remote types to include. Up to 3 values. | string | No | `FULLY_REMOTE,REMOTE_OPTIONAL` | - |
| `timezone` | query | Worker time zone, IANA name such as America/Mexico_City or UTC-6. | string | No | - | - |
| `max_timezone_diff_hours` | query | Maximum time zone difference in hours when timezone is set. | integer | No | - | 12 |
| `category` | query | Job categories. Up to 5 values. | string | No | - | - |
| `seniority` | query | Seniority levels. Up to 8 values. | string | No | - | - |
| `posted_within_days` | query | Only jobs posted in the last N days (1-90). | integer | No | - | 90 |
| `salary_only` | query | true to return only jobs that publish a salary. | boolean | No | `false` | - |
| `limit` | query | Maximum number of jobs to return (1-25). Default 10. | integer | No | `10` | 25 |
| `include_description` | query | true to include the plain-text job description (trimmed to 4,000 characters). | boolean | No | `false` | - |

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/steadyscrape/jobs-search/v1/jobs/remote?query=python&remote_type=FULLY_REMOTE,REMOTE_OPTIONAL&salary_only=false&limit=3&include_description=false' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "success": true,
  "endpoint": "jobs.remote",
  "count": 3,
  "partial": false,
  "items": [
    {
      "jobId": "bamboohr:cialdnb:713",
      "title": "Python Developer - IA",
      "company": "Cialdnb",
      "department": "Data Science & Engineering",
      "jobUrl": "https://cialdnb.bamboohr.com/careers/713",
      "applyUrl": "https://cialdnb.bamboohr.com/careers/713",
      "locationText": "São Paulo, SP, Brazil",
      "remoteType": "FULLY_REMOTE",
      "remoteConfidence": "medium",
      "remoteScope": "COUNTRY",
      "eligibleCountries": [
        "BR"
      ],
      "eligibleCountryNames": [
        "Brazil"
      ],
      "eligibleRegions": [
        "Latin America"
      ],
      "eligibleSubdivisions": [],
      "eligibilitySource": "location",
      "timezones": [],
      "utcOffsetMin": -5,
      "utcOffsetMax": -2,
      "timezoneSource": "country",
      "remoteLocations": [],
      "officeLocations": [
        "São Paulo, SP, Brazil"
      ],
      "remoteEvidence": [
        "ats:REMOTE"
      ],
      "seniority": "MID",
      "jobCategory": "Engineering",
      "sourceJobId": "713",
      "platform": "bamboohr",
      "boardSlug": "cialdnb",
      "team": null,
      "locations": [
        {
          "raw": "São Paulo, SP, Brazil",
          "city": "São Paulo",
          "region": "SP",
          "country": "Brazil",
          "countryCode": "BR",
          "isRemote": false
        }
      ],
      "isRemote": true,
      "workplaceType": "REMOTE",
      "employmentType": "CONTRACT",
      "employmentTypeRaw": null,
      "salary": null,
      "postedAt": null,
      "updatedAt": null,
      "requisitionId": null,
      "scrapedAt": "2026-10-28T13:02:31Z",
      "boardUrl": "https://cialdnb.bamboohr.com/careers",
      "atsWorkplaceType": "REMOTE",
      "mergedPostings": 0,
      "mergedJobIds": [],
      "source": {
        "type": "employer career site (public ATS job board API)",
        "indexRefreshedAt": "2026-10-28T14:21:01Z",
        "boardFetchedAt": "2026-10-28T13:02:31Z",
        "firstSeenAt": "2026-10-28T00:00:00Z",
        "descriptionFetchedLive": false,
        "verifiedListedAt": null
      }
    }
  ],
  "meta": {
    "generatedAt": "2026-10-29T04:49:54.843Z",
    "tookMs": 10576,
    "version": "1.0.0"
  }
}
```

#### 3. List jobs on company boards

Returns every open job on up to 3 company job boards, given as board links.

**Method:** `GET`

**Endpoint:** `/v1/jobs/board`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `board` | query | Job board links starting with https://, comma separated, for example https://boards.greenhouse.io/stripe. Up to 3 values. | string | Yes | - | - |
| `query` | query | Keep jobs whose title contains any of these words. Up to 5 values. | string | No | - | - |
| `exclude` | query | Drop jobs whose title contains any of these words. Up to 10 values. | string | No | - | - |
| `location` | query | Keep jobs in these cities, regions or countries. Up to 5 values. | string | No | - | - |
| `department` | query | Keep jobs whose department contains any of these words. Up to 5 values. | string | No | - | - |
| `remote` | query | true to keep only remote jobs. | boolean | No | `false` | - |
| `posted_within_days` | query | Only jobs posted in the last N days. | integer | No | - | 365 |
| `limit` | query | Maximum number of jobs in total to return (1-50). Default 25. | integer | No | `25` | 50 |
| `include_description` | query | true to include the plain-text job description (trimmed to 4,000 characters). | boolean | No | `false` | - |

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/steadyscrape/jobs-search/v1/jobs/board?board=https://boards.greenhouse.io/stripe&remote=false&limit=3&include_description=false' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "success": true,
  "endpoint": "jobs.board",
  "count": 3,
  "partial": false,
  "items": [
    {
      "jobId": "greenhouse:stripe:8172508",
      "sourceJobId": "8172508",
      "platform": "greenhouse",
      "boardSlug": "stripe",
      "company": "Stripe",
      "title": "Abuse Investigator",
      "department": "8611 Security Analytics",
      "team": null,
      "locations": [
        {
          "raw": "Dublin",
          "city": "Dublin",
          "region": null,
          "country": "Ireland",
          "countryCode": "IE",
          "isRemote": false
        }
      ],
      "locationText": "Dublin",
      "isRemote": false,
      "workplaceType": null,
      "employmentType": null,
      "employmentTypeRaw": null,
      "salary": null,
      "postedAt": "2026-09-03T17:32:53Z",
      "updatedAt": "2026-10-22T13:16:15Z",
      "jobUrl": "https://stripe.com/jobs/search?gh_jid=8172508",
      "applyUrl": "https://stripe.com/jobs/search?gh_jid=8172508",
      "requisitionId": "See Opening ID",
      "scrapedAt": "2026-10-29T04:49:23Z",
      "boardUrl": "https://job-boards.greenhouse.io/stripe"
    }
  ],
  "meta": {
    "generatedAt": "2026-10-29T04:49:26.212Z",
    "tookMs": 6036,
    "version": "1.0.0"
  }
}
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request worked. The body has `success`, `endpoint`, `count`, `partial`, the `items` array and a `meta` block. |
| 400 | Bad Request | A required parameter is missing or a value is out of range. The body explains which parameter. |
| 401 | Unauthorized | The `x-api-market-key` header is missing or the key is not valid. |
| 403 | Forbidden | Your key has no active subscription to this API, or your plan quota is used up. |
| 404 | Not Found | The path is wrong. This API has three endpoints: `/v1/jobs/search`, `/v1/jobs/remote` and `/v1/jobs/board`. |
| 429 | Too Many Requests | You went over your plan's requests per second. The body has `retryAfterMs`, and `Retry-After` says how long to wait. |
| 500 | Internal Server Error | Something failed on the provider side. Retry once; if it keeps failing, contact us. |
| 503 | Service Unavailable | An upstream source is briefly unavailable. Retry after a short pause. |

## Rate Limits

Monthly quotas are 50 calls on Free, 750 on Starter, 2,250 on Pro and 6,000 on Business. The Free plan is a 7-day trial. Free and Starter allow 1 request per second, Pro allows 2 and Business allows 1, and each request counts as one call. Going over the per-second limit returns `429 Too Many Requests` with `retryAfterMs` in the body. Throttle your client, send requests one after another rather than in parallel on the lower plans, and honour the `Retry-After` header before retrying.

## FAQ

*   **How do `/v1/jobs/search` and `/v1/jobs/remote` differ?**

    `/v1/jobs/search` is a keyword search with a simple `remote` flag. `/v1/jobs/remote` returns only remote roles and filters by where the candidate lives (`worker_country`, `region`, `timezone`).

*   **What does `board` accept?**

    Board links starting with `https://`, such as `https://boards.greenhouse.io/stripe`, up to 3 separated by commas.

*   **How many jobs per call?**

    Up to 25 on search and remote, up to 50 on board, set with `limit`.

*   **How fresh are the jobs?**

    They are fetched from the career sites at request time, so a call usually takes 4 to 8 seconds.

## 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.


Live jobs from Greenhouse, Lever, Ashby, Workday and 9 more ATS platforms as JSON, with remote eligibility, salary, posted date and apply links.

Jobs Search API: Live Jobs from Company Career Sites

Free