# 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. - Page: https://fous.com/methods/levels.fyi/get-company-salaries - Method: `levels.fyi/get_company_salaries`, version 1 - Website: levels.fyi - Returns: company, role, location, currency, levels (level name, typical title, median total pay, base, stock, bonus, data points, page link) - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `role` | string | yes | `"product manager"` | Job family in words, for example software engineer. | | `company` | string | yes | `"Meta"` | Company name, for example Google. | | `location` | string | no | | Country or location shown by Levels.fyi, for example United States or India. Default "United States". | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "role": "product manager", "company": "Meta" } ``` Its output: ```json { "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" } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash 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"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## 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 ## Input schema ```json { "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 ```json { "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 } ``` ## See more - [Levels.fyi API: Compare company pay](https://fous.com/methods/levels.fyi/compare-company-pay.md): Compares 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 API: List top paying companies](https://fous.com/methods/levels.fyi/list-top-paying-companies.md): Lists 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. - [PayScale API: Get company pay](https://fous.com/methods/payscale.com/get-company-pay.md): Shows an employer's average annual base salary and its common jobs, with salary ranges, from PayScale public research pages. - [AmbitionBox API: Get company salaries](https://fous.com/methods/ambitionbox.com/get-company-salaries.md): Gets 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. - [PayScale API: Get salary for a job title](https://fous.com/methods/payscale.com/get-salary.md): Gets typical pay for a job title from PayScale research pages. You can narrow it to a country and a city. - [Indeed API: Get salary for a job title](https://fous.com/methods/indeed.com/get-salary.md): Finds 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. - [Lever API: List company jobs](https://fous.com/methods/jobs.lever.co/list-company-jobs.md): Lists open jobs on a company's Lever job board, with optional team, location and workplace filters. - [Indeed API: Get company reviews](https://fous.com/methods/indeed.com/get-company-reviews.md): Looks up a company on Indeed and returns its overall employee rating, number of ratings, category ratings and CEO approval. - [All Levels.fyi methods](https://fous.com/methods/levels.fyi.md)