Levels.fyi API: Get company salaries by level
Returns Levels.fyi's published 50th-percentile annual pay (total, base, stock, bonus) for each career level at a company and role, optionally in a location, in the location's currency.
Unofficial. Not affiliated with or endorsed by Levels.fyi.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Role, required
role Job family in words, for example software engineer.
product manager
- Company, required
company Company name, for example Google.
Meta
- Location optional
location Country or location shown by Levels.fyi, for example United States or India.
United States (default)
Input as JSON
{ "role": "product manager", "company": "Meta"}Output
{ "role": "Product Manager", "levels": [ { "page_url": "https://www.levels.fyi/companies/meta/salaries/product-manager/levels/rotational-product-manager-rpm" , "level_name": "L3", "data_points": 34, "typical_title": "Rotational Product Manager (RPM)", "bonus_per_year": 12000, "stock_per_year": 33000, "base_salary_per_year": 129000, "median_total_pay_per_year": 166000 }, { "page_url": "https://www.levels.fyi/companies/meta/salaries/product-manager/levels/l4-product-manager" , "level_name": "L4", "data_points": 14, "typical_title": "L4 Product Manager", "bonus_per_year": 25000, "stock_per_year": 55000, "base_salary_per_year": 176000, "median_total_pay_per_year": 266000 }, { "page_url": "https://www.levels.fyi/companies/meta/salaries/product-manager/levels/l5-product-manager" , "level_name": "L5", "data_points": 37, "typical_title": "L5 Product Manager", "bonus_per_year": 32000, "stock_per_year": 140000, "base_salary_per_year": 220000, "median_total_pay_per_year": 390000 } ], "company": "Meta", "currency": "USD", "location": "United States"}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"levels.fyi/get_company_salaries","input":{"role":"product manager","company":"Meta"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "levels.fyi/get_company_salaries" , "input": { "role": "product manager", "company": "Meta" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "levels.fyi/get_company_salaries" , "input": { "role": "product manager", "company": "Meta" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run levels.fyi/get_company_salaries# with {"role":"product manager","company":"Meta"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "company", "role" ], "properties": { "role": { "type": "string", "description": "Job family in words, for example software engineer." }, "company": { "type": "string", "description": "Company name, for example Google." }, "location": { "type": "string", "default": "United States", "description": "Country or location shown by Levels.fyi, for example United States or India." } }}Output schema
{ "type": "object", "required": [ "company", "role", "location", "currency", "levels" ], "properties": { "role": { "type": "string", "description": "Job family name." }, "levels": { "type": "array", "items": { "type": "object", "required": [ "level_name", "typical_title", "median_total_pay_per_year", "base_salary_per_year", "stock_per_year", "bonus_per_year", "data_points", "page_url" ], "properties": { "page_url": { "type": "string", "description": "Public page for this level and location." }, "level_name": { "type": "string", "description": "Company career level." }, "data_points": { "type": [ "integer", "null" ], "description": "Number of reported pay observations shown for the level." }, "typical_title": { "type": [ "string", "null" ], "description": "Job title for the level." }, "bonus_per_year": { "type": [ "number", "null" ], "description": "50th-percentile bonus per year." }, "stock_per_year": { "type": [ "number", "null" ], "description": "50th-percentile stock grant per year." }, "base_salary_per_year": { "type": [ "number", "null" ], "description": "50th-percentile base salary per year." }, "median_total_pay_per_year": { "type": [ "number", "null" ], "description": "50th-percentile total annual pay." } }, "additionalProperties": false }, "description": "Career levels from junior to senior; pay fields are published 50th-percentile annual amounts, independently calculated." }, "company": { "type": "string", "description": "Company name." }, "currency": { "type": "string", "description": "Currency code for all annual pay amounts." }, "location": { "type": "string", "description": "Location of pay figures." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
levels.fyi/get_company_salaries- Returns
- company, role, location, currency, levels (level name, typical title, median total pay, base, stock, bonus, data points, page link)
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method levels.fyi/get_company_salaries with the inputs above.
Ask your agent
- What's the median total comp at each level for software engineers at Google in the United States?
- Show me the base, stock, and bonus breakdown by level for product managers at Meta according to levels.fyi
- How much does a data scientist make at each career level at Amazon in India, in rupees?
- I'm interviewing at Stripe for a senior software engineer role — what's the typical pay per level there so I can benchmark my offer?
- Pull the levels.fyi median compensation ladder for hardware engineers at Apple in Canada
See more
All Levels.fyi methodsCompares Levels.fyi's published median yearly pay (total, base, stock, bonus) for one role across 2 to 10 companies in a location, ranked by median total pay. Components are null where the site does not publish them; companies with no data come last with a note.
levels.fyi/compare_company_payLists the companies on the Levels.fyi leaderboard for a job role and location, ranked by median yearly total pay (all levels). The public leaderboard shows up to 50 companies per selection.
levels.fyi/list_top_paying_companiesShows an employer's average annual base salary and its common jobs, with salary ranges, from PayScale public research pages.
payscale.com/get_company_payGets annual salaries by role at an Indian company from AmbitionBox, ordered by number of reports, plus annual averages by experience band when a job title is supplied.
ambitionbox.com/get_company_salariesGets typical pay for a job title from PayScale research pages. You can narrow it to a country and a city.
payscale.com/get_salaryFinds the typical pay for a job title in the United States or a U.S. city or state on Indeed's public salary pages, with the number of reported salaries, the last update date, and the top-paying cities and companies when shown.
indeed.com/get_salaryLists open jobs on a company's Lever job board, with optional team, location and workplace filters.
jobs.lever.co/list_company_jobsLooks up a company on Indeed and returns its overall employee rating, number of ratings, category ratings and CEO approval.
indeed.com/get_company_reviews