Name: Job Search API: 700,000+ Live Jobs from Career Sites
Brand: clean-feeds
SKU: api-clean-feeds-job-search
Availability: InStock
Author: API Market

Clean Feeds

# Job Search API

## Overview

The Job Search API returns live job postings taken directly from employers' own career sites. It indexes more than 700,000 open jobs from the applicant tracking systems of over 16,000 companies, including Greenhouse, Lever, Ashby, SmartRecruiters, Workable, Recruitee, Personio, Teamtailor, Rippling and Breezy HR, and refreshes the index daily. It has 3 endpoints: `/search` searches the whole index by keyword, location, salary, seniority and remote status, `/company` lists every open job at one company from its name, domain or careers page, and `/meta` reports the index size and last refresh time.

It is built for job boards, recruiting and sourcing tools, labour market research, career apps and job alert services that need clean, current jobs without reposts. Each call returns up to 50 jobs with structured fields such as salary range, seniority, years of experience, remote or hybrid status and visa sponsorship when the posting states it. In our test a search for `python,django` matched 1,306 jobs, and `/company?company=stripe.com` found 719 open roles on Stripe's Greenhouse board, each in about 2 seconds.

## Features

*   **3 endpoints**: Index-wide search, all jobs at one company, and index status.
*   **Employer-direct data**: Jobs come from company career sites, not reposts or agency copies.
*   **Rich filters**: Keywords, exclusions, locations, remote, seniority, salary, posting date and ATS.
*   **Live checks**: With `verify=true`, each job is re-checked on the employer's board and its full description added.
*   **Duplicate folding**: The same job posted in several cities appears once, with a `similarPostings` count.
*   **Cursor pagination**: Up to 50 jobs per page and 500 results per query.
*   **Rate limit**: 2 requests per second on Free and Starter, 5 on Basic, Pro and Ultra.

## Use Cases

*   **Job boards**: Fill a niche job board with fresh, employer-direct roles.
*   **Job alerts**: Use `posted_after` to fetch only jobs posted since your last call.
*   **Recruiting tools**: List every open role at a target company.
*   **Salary research**: Filter jobs that publish pay with `has_salary` and `min_salary`.
*   **Labour market analysis**: Track hiring by title, location or seniority over time.

## API Documentation

### Base URL

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

```
https://prod.api.market/api/v1/clean-feeds/job-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

Searches the whole index, newest jobs first. Give at least one of `keywords`, `locations` or `remote=true`. Follow `meta.nextCursor` for the next page.

**Method:** `GET`

**Endpoint:** `/search`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `keywords` | query | Comma-separated title keywords (any match), e.g. `python,data engineer`. | string | No | - | - |
| `exclude` | query | Comma-separated title keywords to exclude, e.g. `intern,senior`. | string | No | - | - |
| `locations` | query | Comma-separated location terms (any match), e.g. `Germany,Berlin`. | string | No | - | - |
| `remote` | query | Only remote jobs. | boolean | No | false | - |
| `posted_within_days` | query | Only jobs posted in the last N days. | integer | No | - | 365 |
| `ats` | query | Comma-separated ATS filter, e.g. `greenhouse,ashby`. | string | No | all | - |
| `limit` | query | Jobs per page. | integer | No | 20 | 50 |
| `per_company` | query | Maximum jobs per company on one page. | integer | No | 5 | 50 |
| `verify` | query | Re-check each job live and add full descriptions (about 5 to 20 seconds). `false` returns index data in about 1 to 3 seconds. | boolean | No | true | - |
| `descriptions` | query | Include full job descriptions (needs `verify=true`). | boolean | No | true | - |
| `include_aggregators` | query | Include boards that repost other companies' jobs. | boolean | No | false | - |
| `dedupe` | query | Show each job title once per company. | boolean | No | true | - |
| `min_salary` | query | Only jobs whose yearly salary reaches this amount in `salary_currency`. | integer | No | - | - |
| `salary_currency` | query | 3-letter currency code for `min_salary`. | string | No | USD | - |
| `has_salary` | query | Only jobs that publish a salary. | boolean | No | false | - |
| `seniority` | query | Comma-separated levels: intern, entry, mid, senior, lead, manager, director, executive. | string | No | - | - |
| `posted_after` | query | Only jobs posted after this ISO date or datetime (UTC). | string | No | - | - |
| `cursor` | query | `nextCursor` from the previous page. | string | No | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/clean-feeds/job-search/search?keywords=python,django&limit=2&descriptions=false" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged to 1 of 2 jobs):**

```json
{
  "meta": {
    "matched": 1306,
    "returned": 2,
    "expiredSkipped": 0,
    "liveChecked": true,
    "indexRefreshedAt": "2026-10-24T02:31:56.879918Z",
    "hasMore": true,
    "nextCursor": "eyJ2IjoxLCJxIjoiYmZlYTNhYWQ4OWQyIiwiZyI6IjIwMjYtMTAtMjRUMDI6MzE6NTYuODc5OTE4WiIsInAiOjIsIm4iOjJ9"
  },
  "jobs": [
    {
      "id": "greenhouse:btgpactual:6232058004",
      "ats": "greenhouse",
      "companySlug": "btgpactual",
      "company": "BTG Pactual",
      "title": "Analista/Desenvolvedor(a) Full Stack Sênior — React e Python",
      "department": "TECHNOLOGY BRAZIL - 8453",
      "location": "São Paulo, Rio de Janeiro",
      "employmentType": "full-time",
      "salaryMin": null,
      "salaryMax": null,
      "postedAt": "2026-10-23T20:20:25Z",
      "url": "https://carreiras.btgpactual.com/vagas?gh_jid=6232058004",
      "applyUrl": "https://carreiras.btgpactual.com/vagas?gh_jid=6232058004",
      "similarPostings": 0,
      "seniority": null,
      "visaSponsorship": null
    }
  ]
}
```

#### 2. Jobs at one company

Lists every open job at one company, read live from its job board. `company` accepts a name, a domain, a careers page or a job-board URL. Large Workday boards can take up to a minute on the first call.

**Method:** `GET`

**Endpoint:** `/company`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `company` | query | Company name (`Stripe`), domain (`stripe.com`), careers page or job-board URL. | string | Yes | - | - |
| `keywords` | query | Comma-separated title keywords (any match). | string | No | - | - |
| `exclude` | query | Comma-separated title keywords to exclude. | string | No | - | - |
| `locations` | query | Comma-separated location terms (any match). | string | No | - | - |
| `remote` | query | Only remote jobs. | boolean | No | false | - |
| `posted_within_days` | query | Only jobs posted in the last N days. | integer | No | - | 365 |
| `limit` | query | Jobs per page. | integer | No | 20 | 50 |
| `descriptions` | query | Include full job descriptions. | boolean | No | true | - |
| `min_salary` | query | Only jobs whose yearly salary reaches this amount. | integer | No | - | - |
| `salary_currency` | query | 3-letter currency code for `min_salary`. | string | No | USD | - |
| `has_salary` | query | Only jobs that publish a salary. | boolean | No | false | - |
| `seniority` | query | Comma-separated seniority levels. | string | No | - | - |
| `visa_sponsorship` | query | Only jobs that do (`true`) or do not (`false`) sponsor visas. Paid plans. | boolean | No | - | - |
| `posted_after` | query | Only jobs posted after this ISO date or datetime (UTC). | string | No | - | - |
| `cursor` | query | `nextCursor` from the previous page. | string | No | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/clean-feeds/job-search/company?company=stripe.com&limit=2&descriptions=false" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged to 1 of 2 jobs):**

```json
{
  "meta": {
    "company": { "ats": "greenhouse", "slug": "stripe" },
    "jobsOnBoard": 719,
    "matched": 719,
    "returned": 2,
    "hasMore": true,
    "nextCursor": "eyJ2IjoxLCJxIjoiYmZmZDY5ODM3YzU3IiwicCI6Mn0"
  },
  "jobs": [
    {
      "id": "greenhouse:stripe:8172487",
      "company": "Stripe",
      "title": "Abuse Investigator",
      "department": "8611 Security Analytics",
      "location": "Dublin",
      "employmentType": "full-time",
      "postedAt": "2026-09-03T17:30:34Z",
      "url": "https://stripe.com/jobs/search?gh_jid=8172487",
      "seniority": "senior",
      "yearsExperienceMin": 5
    }
  ]
}
```

#### 3. Index status

Returns the number of jobs in the index, the job systems it covers and the time of the last refresh.

**Method:** `GET`

**Endpoint:** `/meta`

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/clean-feeds/job-search/meta" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
{
  "jobs": 737256,
  "companyBoardsRefreshedLastRun": 7834,
  "indexRefreshedAt": "2026-10-24T02:31:56.879918Z",
  "ats": ["ashby", "breezy", "…8 more"],
  "maxResultsPerQuery": 500
}
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded and the body holds the result. |
| 400 | Bad Request | A required parameter is missing, for example `/search` without `keywords`, `locations` or `remote=true`, or `/company` without `company`. |
| 401 | Unauthorized | The `x-api-market-key` header is missing, invalid or expired. |
| 403 | Forbidden | Your subscription does not include this endpoint. |
| 404 | Not Found | The path does not exist under the base URL. |
| 429 | Too Many Requests | You sent more than your plan's requests per second, or you used all 100 calls of the Free plan. |
| 500 | Internal Server Error | Something failed on the provider side. Retry after a short delay. |
| 503 | Service Unavailable | The service or its upstream data source is temporarily unavailable. Retry with backoff. |

## Rate Limits

The Free and Starter plans allow 2 requests per second, and Basic, Pro and Ultra allow 5. The Free plan includes 100 calls in total over a 7-day trial and its limit is hard. Starter includes 500 calls a month, Basic 5,000, Pro 20,000 and Ultra 60,000; on these plans extra calls are billed at $0.006, $0.004, $0.003 and $0.0025 each. One call is one API unit however many jobs it returns. Requests above your per-second limit return `429 Too Many Requests`; back off and honour any `Retry-After` header. Calls with `verify=true` take about 5 to 20 seconds, so set your client timeout above that.

## FAQ

**How fresh are the jobs?**

The index refreshes daily, and with `verify=true` each returned job is re-checked on the employer's board at request time.

**How do I get more than 50 jobs?**

Pass `meta.nextCursor` from the previous response as `cursor`. A single query can return up to 500 results.

**How do I build a new-jobs alert?**

Store the time of your last call and pass it as `posted_after` on the next one.

**Why do some jobs have no salary?**

The employer did not publish one. Use `has_salary=true` to return only jobs with a salary.

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


Search 700,000+ live jobs from 16,000+ employer career sites, or list every open role at one company, with salary, seniority and remote filters.

Job Search API: 700,000+ Live Jobs from Career Sites

Free

clean-feeds

Starter

Basic

Ultra

Search 700,000+ live jobs from employer career sites, or list every open role at one company. Salary, seniority and remote filters, up to 50 jobs per call.