# Ashby Jobs API: 50K+ Jobs from 2,200 Company Boards (`makerio/ashby-jobs-api`) Actor

Search every open job on 2,200 Ashby job boards (OpenAI, Snowflake, Airwallex, Harvey, Mistral) in seconds. Refreshed nightly. 30% remote, most US jobs with salary. Filter by title, location, remote, date, salary; full descriptions and apply links.

- **URL**: https://apify.com/makerio/ashby-jobs-api.md
- **Developed by:** [Makerio](https://apify.com/makerio) (community)
- **Categories:** Jobs, Lead generation, AI
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 jobs

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Ashby Jobs API

Searches every open job on 2,200 Ashby job boards (AI companies and startups) by title, location, posting date, remote and salary, and returns structured jobs (company, title, location, pay range, posting date, apply link, description) in seconds.

**Run the example in one click:** press **Start** (or **Try for free**). It returns the 10 newest "data engineer" jobs from 2,200 Ashby job boards in a few seconds. Then type your own job title.

```json
{ "searchText": "data engineer", "maxJobs": 10, "maxJobsPerCompany": 5 }
```

Search **every open job on 2,200 Ashby job boards at once**: about 50,000 jobs from OpenAI, Snowflake, Airwallex, Harvey, Applied Intuition, Crusoe, Mistral, Legora and two thousand fast-growing startups. Ashby is the hiring platform of choice for AI and venture-backed companies: **30% of its jobs are remote and 57% of US jobs publish a salary range**. Every night we read the public Ashby job board of every company in our directory and store the jobs in one database, so a search takes seconds. Full descriptions, pay ranges and apply links are loaded live from Ashby for the jobs you get back.

**Priced for volume:** $0.01 per search and $2 per 1,000 jobs. A daily feed of 1,000 Ashby jobs costs about $2.

### What you can do with it

- **Search all Ashby companies at once** instead of opening boards one by one.
- **Build an AI, startup or remote job board or alert.** Schedule a daily run with "Only jobs not returned before" and get just the new postings.
- **Find who is hiring a role.** Each run also saves `COMPANIES`: the employers with matching jobs, their number of jobs, countries and example titles. Hiring is a buying signal for sales and recruiting.
- **Get every job of one company.** Put its Ashby board name or URL into `companies` (for example `openai` or `https://jobs.ashbyhq.com/openai`).

### Input

| Field | What it does |
|---|---|
| `searchText` | Job title or keyword (leave empty with `postedWithinDays` for a feed of every new job). It must appear in the job title, so "data engineer" finds "Senior Data Engineer", not every job that mentions data. |
| `locations` | Cities, regions, countries, two-letter country codes or `Remote`. Checked against every location of a job. |
| `remoteOnly` | Keep only remote jobs. |
| `postedWithinDays` | Keep only jobs published in the last N days. |
| `maxJobs` | Stop after this many jobs. Also caps the cost. |
| `maxJobsPerCompany` | At most this many jobs from one company. |
| `companies` | Search only these companies (Ashby board names or URLs). |
| `excludeTitleKeywords` | Drop titles with these words, for example `intern`. |
| `descriptionKeywords` | Keep jobs whose description mentions any of these terms. |
| `employmentTypes` | `full_time`, `part_time`, `contract`, `temporary`, `internship`. |
| `requireSalary` | Keep only jobs with a published pay range (57% of US Ashby jobs publish one). |
| `excludeAgencies` | On by default: staffing and recruiting agencies are left out. |
| `descriptionFormat` | `text` (default), `html`, `both` or `none`. `none` is the fastest. |
| `onlyNewJobs`, `stateKey` | Return only jobs not returned by earlier runs of the same monitor. |

Example: remote product manager jobs in the US from the last week, with salary.

```json
{
    "searchText": "product manager",
    "locations": ["US", "Remote"],
    "remoteOnly": true,
    "postedWithinDays": 7,
    "requireSalary": true,
    "maxJobs": 100,
    "maxJobsPerCompany": 3
}
```

### A feed of every new job

Leave `searchText` empty and set `postedWithinDays`: the run returns every job posted in that window on 2,200 Ashby boards (about 1,000 a day), newest first, with the same filters. Schedule it daily for a job board, an alert or a data pipeline.

```json
{"postedWithinDays": 1, "maxJobs": 2000, "descriptionFormat": "none"}
```

### Output

Every job has the same fields, whatever platform it came from. A field is `null` when the company did not publish it.

```json
{
    "id": "ashby:fieldguide:eb8b637c-d9cd-4b98-99e4-ea5113701473",
    "ats": "ashby",
    "companyName": "Fieldguide",
    "title": "Software Engineer, Production Support",
    "department": "Engineering, Product, and Design",
    "location": "Remote (USA)",
    "locations": [
        "Remote (USA)"
    ],
    "workplaceType": "remote",
    "isRemote": true,
    "employmentType": "full_time",
    "salaryMin": 178000,
    "salaryMax": 208000,
    "salaryCurrency": "USD",
    "salaryInterval": "year",
    "postedAt": "2026-11-17T00:00:00.000Z",
    "url": "https://jobs.ashbyhq.com/fieldguide/eb8b637c-d9cd-4b98-99e4-ea5113701473",
    "applyUrl": "https://jobs.ashbyhq.com/fieldguide/eb8b637c-d9cd-4b98-99e4-ea5113701473",
    "descriptionText": "About the Role\nWe are building a new engineering-led production support function, and as a Senior Software Eng ..."
}
```

A run summary is saved as `SUMMARY` in the key-value store: when the database was built, how many jobs it holds, how many matched and how many were returned per platform.

**Companies hiring, free with every search:** next to the jobs, the run saves `COMPANIES` in the key-value store: each company with returned jobs, biggest first, with its number of jobs, remote jobs, newest posting date, countries and example titles. A ready list of who is hiring a role in a place, for sales and recruiting.

### Use it from your code

One request runs a search and returns the jobs as JSON (API token: Console > Settings > API & Integrations):

```bash
curl -X POST "https://api.apify.com/v2/acts/makerio~ashby-jobs-api/run-sync-get-dataset-items?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchText": "data engineer", "remoteOnly": true, "postedWithinDays": 7, "maxJobs": 50}'
```

Python, with `pip install apify-client`:

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("makerio/ashby-jobs-api").call(run_input={"searchText": "data engineer", "maxJobs": 50})
for job in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(job["postedAt"][:10], job["companyName"], "|", job["title"], "|", job["url"])
```

To get new jobs every day without code, save the input as a task, add a schedule, and connect the result to Google Sheets, Slack, email or a webhook under **Integrations**.

### Use it from an AI agent (MCP)

Claude, ChatGPT, Cursor and other MCP clients can call this Actor as a tool through the Apify MCP server. Add this server URL to your client, with your Apify API token:

```
https://mcp.apify.com?tools=makerio/ashby-jobs-api
```

Then ask in plain words, for example "Which companies posted registered nurse jobs in Ohio in the last 3 days? Give me the links." The agent fills in the input, runs the search and reads the jobs back.

### Coverage

**50,121 open jobs on 2,200 Ashby job boards** in the build of November 18, 2026; the numbers change every night. The directory is built from public web crawls and grows over time. A company that is missing can still be searched: put its Ashby board URL into `companies`, and the Actor reads it live.

Need other platforms too? [Jobs Database API](https://apify.com/makerio/career-site-jobs-database) searches 1.2 million jobs from 26,000 career sites on Workday, Greenhouse, Lever, Ashby, SmartRecruiters, Oracle and more with the same input. Greenhouse boards only: [Greenhouse Jobs API](https://apify.com/makerio/greenhouse-jobs-api).

### Pricing

Pay per event, no subscription:

- **$0.01 per search** across all Ashby boards.
- **$2 per 1,000 jobs returned** ($0.002 per job). Filters run before you are charged, so you pay only for jobs you get.

A search that returns 50 jobs costs $0.11. Set `maxJobs` or a maximum cost per run and the Actor stops exactly there.

### FAQ

**How fresh is the data?**
The database is rebuilt every night; the run summary shows the build time. Descriptions and pay come live from Ashby for the jobs you get back. A job closed since the last build can still appear until the next night.

**Does every job have a posting date?**
Yes. Ashby publishes the date each job was posted, and `postedWithinDays` uses it.

**Do I need an Ashby account or API key?**
No. Only the public job boards that companies publish for anyone to see are read.

**Why must the keyword be in the title?**
Searching descriptions returns every job that mentions a word in passing. Title matching gives precise results. Use `descriptionKeywords` to narrow further by skills.

**Is it legal?**
Only public job postings are read, without logging in. No personal data is collected. Check the terms that apply to your use case.

### Related Actors

- [Jobs Database API](https://apify.com/makerio/career-site-jobs-database): search 1.2M jobs from 26,000 career sites in seconds.
- [Greenhouse Jobs API](https://apify.com/makerio/greenhouse-jobs-api): every job on 4,000 Greenhouse boards.
- [Remote Jobs Search](https://apify.com/makerio/remote-jobs-search): remote jobs from company career sites.
- [Career Site Job Search](https://apify.com/makerio/career-site-job-search): live search of every career site at run time.
- [Career Site Jobs Scraper](https://apify.com/makerio/career-site-jobs): every job of the companies you list.
- [Workday Jobs Scraper](https://apify.com/makerio/workday-jobs): any myworkdayjobs.com career site.

### Support

Missing a company or a field? Open an issue on the **Issues** tab.

# Actor input Schema

## `searchText` (type: `string`):

Required. One job title or keyword that must appear in the job title, for example "data engineer", "registered nurse" or "product designer". Not case sensitive; whole words with common endings ("engineer" also finds "Engineering"). The description is not searched here (use descriptionKeywords). To search several titles, start one run per title. Leave it empty and set "postedWithinDays" to get every new job (a daily feed).

## `locations` (type: `array`):

Optional. Keep jobs in any of these places, checked against every location of the job. Use a city, region or country name ("Berlin", "California", "United States"), a two-letter country code ("US") or "Remote". Leave empty for jobs worldwide. Jobs whose location is only a site name without a city or country (for example "Katy Hospital") are left out when this is set.

## `remoteOnly` (type: `boolean`):

Keep only jobs the company marks as remote, or with "remote" in the location.

## `postedWithinDays` (type: `integer`):

Optional. Keep only jobs published in the last N days, for example 1 for today and yesterday or 7 for the past week. Leave empty for any age; results are always sorted newest first.

## `maxJobs` (type: `integer`):

Stop after this many jobs (default 50; the example uses 10). Each returned job costs $0.002, so this also caps the cost of the run: 50 jobs cost $0.01 + $0.10.

## `maxJobsPerCompany` (type: `integer`):

Return at most this many jobs from one company, so a few big employers do not fill the whole result.

## `companies` (type: `array`):

Search only these companies: Ashby board names (e.g. "openai") or job board URLs (https://jobs.ashbyhq.com/openai). A company outside the nightly database is read live.

## `excludeTitleKeywords` (type: `array`):

Drop jobs whose title contains any of these words or phrases, for example "intern" or "director".

## `descriptionKeywords` (type: `array`):

Keep jobs that mention at least one of these terms in the title or the full description, for example "Kubernetes" or "SAP".

## `employmentTypes` (type: `array`):

Keep only these employment types.

## `requireSalary` (type: `boolean`):

Keep only jobs that state a pay range, in the job data or in the description.

## `excludeAgencies` (type: `boolean`):

Leave out staffing and recruiting agencies, job marketplaces and freelance gig platforms: their postings are often reposts or always-open pools, some years old.

## `descriptionFormat` (type: `string`):

How to return the full job description. Choose "No description" for the fastest run.

## `onlyNewJobs` (type: `boolean`):

Remember returned jobs between runs and output only postings that are new since the last run. Ideal for a daily schedule that feeds job alerts.

## `stateKey` (type: `string`):

Optional. Runs with the same monitor name share their memory of returned jobs. Use different names to track different searches separately.

## Actor input object example

```json
{
  "searchText": "data engineer",
  "remoteOnly": false,
  "maxJobs": 10,
  "maxJobsPerCompany": 5,
  "requireSalary": false,
  "excludeAgencies": true,
  "descriptionFormat": "text",
  "onlyNewJobs": false
}
```

# Actor output Schema

## `jobs` (type: `string`):

One item per open job posting: title, company, all locations, country, remote type, employment type, seniority, posting date, requisition ID, job link and description.

## `summary` (type: `string`):

JSON record with the search text, how many career sites were searched per platform, how many jobs matched and were returned, failed or skipped sites, and rate limits met during the run.

## `companies` (type: `string`):

JSON list of the companies with returned jobs, biggest first: jobs, remote jobs, newest posting, countries and example titles. Included at no extra cost.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchText": "data engineer",
    "maxJobs": 10,
    "maxJobsPerCompany": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("makerio/ashby-jobs-api").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchText": "data engineer",
    "maxJobs": 10,
    "maxJobsPerCompany": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("makerio/ashby-jobs-api").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchText": "data engineer",
  "maxJobs": 10,
  "maxJobsPerCompany": 5
}' |
apify call makerio/ashby-jobs-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,makerio/ashby-jobs-api"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/0mX8VXvgEdy5TSjbe/builds/F2cxmUWXFeTLJtCMH/openapi.json
