Levels.fyi Search

Search Levels.fyi jobs by company, location, level and pay.

GET/api/v1/levels/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	Job title, keywords or company; omit to browse.Up to 512 characters.
`page`	integer	One-based results page. Use next_page from the response to continue.Default: 1.Minimum: 1.
`company`	string	Company slug, such as google.
`location`	string	Levels.fyi location slug, such as united-states; not a free-text city name.
`sort`	"relevance" \| "date_published" \| "total_compensation"	Result ordering.Default: relevance.
`limit`	integer	Companies per page; jobs are grouped by company.Default: 5.Range: 1 to 20.
`jobs_per_company`	integer	Maximum matching jobs included for each company.Default: 3.Range: 1 to 15.
`min_base_compensation`	integer	Minimum annual base compensation in USD.Minimum: 0.
`min_total_compensation`	integer	Minimum median annual total compensation in USD; may include Levels.fyi estimates.Minimum: 0.
`posted_within`	integer	Maximum posting age in posted_within_unit units.Minimum: 1.
`posted_within_unit`	"days" \| "weeks" \| "months"	Unit for posted_within.Default: days.

Parameter	Type	Description
`companies`	string
`locations`	string
`job_families`	string
`levels`	string
`employment_types`	string
`work_arrangements`	string
`company_types`	string
`company_sizes`	string
`company_valuations`	string
`perk_ids`	string

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/levels/search?q=software+engineer" \
  -H "Authorization: Bearer $SERPFAST_KEY"

Node.js 18+

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

Python

import os, requests

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