Catalog / Levels.fyi Jobs

Levels.fyi Jobs API

levels.fyi

Read-only live job search over Levels.fyi. Search accepts the site's job-board filters, job IDs round-trip to full details, and company endpoints expose source company summaries and open jobs. Responses preserve the source's field names, values, and per-record types. The source-reported totalMatchingJobs is the count for the current search query, not the number of returned rows or a fixed site-wide denominator; search-text queries can use a broader index than an unfiltered query. The source's public job payloads provide posting-level compensation. Public benchmark-volume reads were also observed, but they return only source company/job-family identifiers and sampleSize, not pay values; the public benchmark page identifies its dataset as not freely accessible. Therefore benchmark-by-company, role, level, and location pay is not exposed here. Example CLI call: agent-data call levels-fyi jobs --searchText "software engineer" --jobFamilySlugs "[\"software-engineer\"]" --locationSlugs "[\"san-francisco-bay-area\"]" --sortBy relevance --limit 5 --offset 0. Array filters accept repeated parameters, comma-separated values, or a JSON-array text value. The raw benchmark source records and the posting-level alternative are documented in probe_plan.md; the active execution plan points to the same retained evidence.

  • Business
  • jobs
  • recruiting
  • employment
  • compensation
5 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the Levels.fyi Jobs API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Search live job listings using Levels.fyi's public job-board filters. Every array filter accepts repeated parameters, one comma-separated value (for example --locationSlugs san-francisco-bay-area,greater-austin-area), or JSON-array text (for example --locationSlugs '[\"san-francisco-bay-area\",\"greater-austin-area\"]'). Results retain source grouping by company; use a nested job id with the detail route. Pagination uses offset and limit as accepted by the source. totalMatchingJobs is the source's current-query match count and can differ across query forms; it is not the returned page size or a fixed unfiltered universe. Salary fields are passed through per record: search results observed numeric values remain numbers, while detail can return string values.

Optional parameters 19

Repeat, comma-separate, or pass JSON-array text; values are Levels.fyi job-family slugs.

Repeat, comma-separate, or pass JSON-array text; values are Levels.fyi company slugs.

Repeat, comma-separate, or pass JSON-array text.

Repeat, comma-separate, or pass JSON-array text.

Repeat, comma-separate, or pass JSON-array text.

Repeat, comma-separate, or pass JSON-array text; use locationSlugs returned by job-filters.

Repeat, comma-separate, or pass JSON-array text.

Repeat, comma-separate, or pass JSON-array text.

Source valuation ranges as JSON [min,max] values; accepts repeated range texts or a comma-separated range list.

Numeric source benefit IDs; repeat, comma-separate, or pass JSON-array text.

View call pricing
cURL · Jobs
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/696af215-0906-4c36-91b6-61203bdfe4b0/v1/jobs' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY"

Endpoints

Inputs and response fields for every endpoint in this API.

GETJobs/v1/jobs

Search live job listings using Levels.fyi's public job-board filters. Every array filter accepts repeated parameters, one comma-separated value (for example --locationSlugs san-francisco-bay-area,greater-austin-area), or JSON-array text (for example --locationSlugs '[\"san-francisco-bay-area\",\"greater-austin-area\"]'). Results retain source grouping by company; use a nested job id with the detail route. Pagination uses offset and limit as accepted by the source. totalMatchingJobs is the source's current-query match count and can differ across query forms; it is not the returned page size or a fixed unfiltered universe. Salary fields are passed through per record: search results observed numeric values remain numbers, while detail can return string values.

Input

searchTextOptionalQuery · string | null

Example: software engineer

jobFamilySlugsOptionalQuery · array | null

Repeat, comma-separate, or pass JSON-array text; values are Levels.fyi job-family slugs.

Example: [\"software-engineer\"]

companySlugsOptionalQuery · array | null

Repeat, comma-separate, or pass JSON-array text; values are Levels.fyi company slugs.

Example: nvidia

standardLevelsOptionalQuery · array | null

Repeat, comma-separate, or pass JSON-array text.

Example: mid_staff

employmentTypesOptionalQuery · array | null

Repeat, comma-separate, or pass JSON-array text.

Example: full_time

workArrangementsOptionalQuery · array | null

Repeat, comma-separate, or pass JSON-array text.

Example: remote

locationSlugsOptionalQuery · array | null

Repeat, comma-separate, or pass JSON-array text; use locationSlugs returned by job-filters.

Example: san-francisco-bay-area,greater-austin-area

companyTypesOptionalQuery · array | null

Repeat, comma-separate, or pass JSON-array text.

Example: public

companySizesOptionalQuery · array | null

Repeat, comma-separate, or pass JSON-array text.

Example: enterprise

companyValuationsOptionalQuery · array | null

Source valuation ranges as JSON [min,max] values; accepts repeated range texts or a comma-separated range list.

Example: [[1000000000,10000000000]]

perkIdsOptionalQuery · array | null

Numeric source benefit IDs; repeat, comma-separate, or pass JSON-array text.

Example: 58

minBaseCompensationOptionalQuery · number | null

Example: 100000

minMedianTotalCompensationOptionalQuery · number | null

Example: 150000

postedAfterValueOptionalQuery · integer | null

Example: 30

postedAfterTimeTypeOptionalQuery · string | null

Example: month

sortByOptionalQuery · string | null

Example: relevance

limitPerCompanyOptionalQuery · integer | null

Example: 3

limitOptionalQuery · integer | null

Example: 5

offsetOptionalQuery · integer | null

Example: 0

Response

resultsobject[]
results[].jobs?object[]
results[].jobs[].idstring
results[].jobs[].titlestring
results[].jobs[].locations?string[]
results[].jobs[].expiryDate?string | null
results[].jobs[].postingDate?string | null
results[].jobs[].maxBaseSalary?string | integer | number | null
results[].jobs[].minBaseSalary?string | integer | number | null
results[].jobs[].applicationUrl?string | null
results[].jobs[].maxTotalSalary?string | integer | number | null
results[].jobs[].minTotalSalary?string | integer | number | null
results[].jobs[].baseSalaryCurrency?string | null
results[].isPromoted?boolean | null
results[].companyIcon?string | null
results[].companyInfo?object | null
results[].companyNamestring
results[].companySlugstring
results[].companyType?string | null
results[].employeeCount?integer | null
results[].shortDescription?string | null
results[].estimatedValuation?number | null
totalMatchingJobs?integer | null

Fields marked ? are optional.

GETJob filters/v1/job-filters

Return live Levels.fyi location data and city suggestions, plus source-declared values and parameter names for its public job-board controls. Each city suggestion includes locationSlugs containing the source slug(s) usable with jobs; for example, an Austin suggestion maps to greater-austin-area when the source location export provides that relationship.

Input

queryOptionalQuery · string | null

Optional city text for live autocomplete suggestions

Example: San Francisco

Response

sourcestring
filtersobject
locationsobject[]
citySuggestionsobject[]
GETJobs by job id/v1/jobs/{job_id}

Retrieve every structured field returned by Levels.fyi for a public job posting. Pass the id returned in a search result. Compensation fields are source-faithful: Levels.fyi has been observed returning numeric salary values in search results and string salary values in detail responses, so this API does not convert them.

Input

job_idRequiredPath · string

Levels.fyi job id

Example: 0fxmzwhiej5fk

Response

idstring
titlestring
locations?string[]
companyInfo?object | null
description?string | null
postingDate?string | null
jobFamilySlug?string | null
maxBaseSalary?string | integer | number | null
minBaseSalary?string | integer | number | null
applicationUrl?string | null
maxTotalSalary?string | integer | number | null
minTotalSalary?string | integer | number | null
employmentTypes?string[]
postalAddresses?object[]
workArrangement?string | null
isCompanyPromoted?boolean | null
baseSalaryCurrency?string | null
baseCompensationSource?string | null
totalCompensationEstimates?object[]

Fields marked ? are optional.

GETCompanies by company slug/v1/companies/{company_slug}

Return the company summary that Levels.fyi places alongside search results and its live open-job list. This is the source-supported company information available without login.

Input

company_slugRequiredPath · string

Levels.fyi company slug

Example: nvidia

Response

companyobject
company.jobs?object[]
company.jobs[].idstring
company.jobs[].titlestring
company.jobs[].locations?string[]
company.jobs[].expiryDate?string | null
company.jobs[].postingDate?string | null
company.jobs[].maxBaseSalary?string | integer | number | null
company.jobs[].minBaseSalary?string | integer | number | null
company.jobs[].applicationUrl?string | null
company.jobs[].maxTotalSalary?string | integer | number | null
company.jobs[].minTotalSalary?string | integer | number | null
company.jobs[].baseSalaryCurrency?string | null
company.isPromoted?boolean | null
company.companyIcon?string | null
company.companyInfo?object | null
company.companyNamestring
company.companySlugstring
company.companyType?string | null
company.employeeCount?integer | null
company.shortDescription?string | null
company.estimatedValuation?number | null
openJobsobject
openJobs.resultsobject[]
openJobs.results[].idstring
openJobs.results[].titlestring
openJobs.results[].locations?string[]
openJobs.results[].expiryDate?string | null
openJobs.results[].postingDate?string | null
openJobs.results[].maxBaseSalary?string | integer | number | null
openJobs.results[].minBaseSalary?string | integer | number | null
openJobs.results[].applicationUrl?string | null
openJobs.results[].maxTotalSalary?string | integer | number | null
openJobs.results[].minTotalSalary?string | integer | number | null
openJobs.results[].baseSalaryCurrency?string | null
openJobs.nextToken?string | null
totalMatchingJobs?integer | null

Fields marked ? are optional.

GETCompanies by company slug jobs/v1/companies/{company_slug}/jobs

List the public open jobs returned by Levels.fyi for a company slug. Follow nextToken when present.

Input

company_slugRequiredPath · string

Levels.fyi company slug

Example: nvidia

limitOptionalQuery · integer | null

Example: 15

tokenOptionalQuery · string | null

Example: 5

Response

resultsobject[]
results[].idstring
results[].titlestring
results[].locations?string[]
results[].expiryDate?string | null
results[].postingDate?string | null
results[].maxBaseSalary?string | integer | number | null
results[].minBaseSalary?string | integer | number | null
results[].applicationUrl?string | null
results[].maxTotalSalary?string | integer | number | null
results[].minTotalSalary?string | integer | number | null
results[].baseSalaryCurrency?string | null
nextToken?string | null

Fields marked ? are optional.

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.