# Levels.fyi API

> 3 public methods for Levels.fyi (levels.fyi), each 1 credit per completed run.

Unofficial. Not affiliated with or endorsed by Levels.fyi.

- Page: https://fous.com/methods/levels.fyi

## Methods

### [Compare company pay](https://fous.com/methods/levels.fyi/compare-company-pay.md)

`levels.fyi/compare_company_pay`, read. 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.

Returns: role, location, currency, companies (rank, median total, base, stock, bonus, note, link)

### [List top paying companies](https://fous.com/methods/levels.fyi/list-top-paying-companies.md)

`levels.fyi/list_top_paying_companies`, read. 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.

Returns: role, location, currency, companies (rank, company, median total pay per year, company link)

### [Get company salaries by level](https://fous.com/methods/levels.fyi/get-company-salaries.md)

`levels.fyi/get_company_salaries`, read. 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.

Returns: company, role, location, currency, levels (level name, typical title, median total pay, base, stock, bonus, data points, page link)