Jobs by Ashby Search

Search jobs on a company's Ashby job board.

GET/api/v1/ashby/search

Costs 1 credit per request; failed requests are refunded. Authentication, the search_metadata envelope and error codes are the same as for every endpoint (see the API reference). Try it in the playground.

Parameters

Search parameters

Parameter	Type	Description
`q`	string	Case-insensitive phrase in title or description.Up to 512 characters.
`page`	integer	One-based results page. Use next_page from the response to continue.Default: 1.Minimum: 1.
`board`required	string	Employer board name from jobs.ashbyhq.com/{board}, for example ashby.
`location`	string	Case-insensitive phrase in primary or secondary locations.Up to 512 characters.
`department`	string	Case-insensitive department name.Up to 512 characters.
`team`	string	Exact team name, case-insensitive.Up to 512 characters.
`workplace_type`	"OnSite" \| "Remote" \| "Hybrid"	Employer's workplace type.
`country`	string	Country from a primary or secondary postal address, for example USA. Exact case-insensitive match.Up to 512 characters.
`region`	string	State or province from a primary or secondary postal address. Exact case-insensitive match.Up to 512 characters.
`city`	string	City from a primary or secondary postal address. All supplied address filters must match the same address.Up to 512 characters.
`remote`	boolean	True selects remote jobs. False selects non-remote jobs.
`employment_type`	"FullTime" \| "PartTime" \| "Intern" \| "Contract" \| "Temporary"	Employment type.
`limit`	integer	Results per page.Default: 20.Range: 1 to 100.
`include_compensation`	boolean	Include published compensation tiers and salary ranges.Default: true.

Response

A JSON object with search_metadata (request id, credits used and remaining) and the result data: jobs_results. Groups and fields depend on the content of each page, so treat every field as optional.

Examples

cURL

curl "https://serpfast.com/api/v1/ashby/search?board=ashby&q=engineer" \
  -H "Authorization: Bearer $SERPFAST_KEY"

Node.js 18+

const params = new URLSearchParams({
  "board": "ashby",
  "q": "engineer"
});
const res = await fetch(`https://serpfast.com/api/v1/ashby/search?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SERPFAST_KEY}` },
});
const data = await res.json();
console.log(data);

Python

import os, requests

params = {
  "board": "ashby",
  "q": "engineer"
}
res = requests.get(
    "https://serpfast.com/api/v1/ashby/search",
    params=params,
    headers={"Authorization": f"Bearer {os.environ['SERPFAST_KEY']}"},
    timeout=120,
)
print(res.json())