# Levels.fyi — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access real compensation data, benefits packages, and salary trends across tech companies and job levels. Retrieve internship pay, H-1B visa salary records, company profiles, and detailed breakdowns by role and level.

**Category:** Jobs | **Website:** [levels.fyi/](https://levels.fyi/) | **Docs:** [parse.bot/marketplace/543e5df9-c450-4ead-936b-8e2bb002be6f/levels-fyi-api](https://parse.bot/marketplace/543e5df9-c450-4ead-936b-8e2bb002be6f/levels-fyi-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-levels-fyi-api-543e5df9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_company_benefits

Retrieve benefits and perks data for a specific company including benefit categories, descriptions, field values, and computed monetary values. Each benefit includes its perk definition, category tag, and any company-specific field values.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_slug` | string | Yes | Company slug identifier (e.g. 'google', 'meta', 'amazon'). Obtain from get_popular_companies. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-levels-fyi-api-543e5df9/get_company_benefits \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company_slug":"<string>"}'
```

### get_company_overview

Retrieve a company profile overview including full company details (name, description, industry, ticker, HQ location, vesting info), a structured overview summary, related companies, and available job families at the company.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_slug` | string | Yes | Company slug identifier (e.g. 'google', 'meta', 'amazon'). Obtain from get_popular_companies. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-levels-fyi-api-543e5df9/get_company_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company_slug":"<string>"}'
```

### get_h1b_salaries

Retrieve paginated H-1B visa salary records for a given year, sorted by date descending. Each record includes company, job title, wage, location (city/state), and certification status. Returns page metadata with totalPages and totalRecords.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (starts at 1). |
| `year` | integer | No | Year of H-1B records. Valid values include 2020 through 2025. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-levels-fyi-api-543e5df9/get_h1b_salaries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","year":"<integer>"}'
```

### get_internship_salaries

Retrieve internship salary data across all companies. Returns the full dataset including monthly and hourly pay, location, season, year, and education level for each record. No pagination — returns all records in one call (thousands of entries).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-levels-fyi-api-543e5df9/get_internship_salaries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_job_families

Retrieve the full directory of job titles and families organized as a flat list. Each job family includes slug, name, category, focus tags, and job titles. Covers categories like Technology, Design, Business, Finance, Engineering, Human Resources, Healthcare, and more. Returns all families in one call — no pagination.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-levels-fyi-api-543e5df9/get_job_families \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_popular_companies

Retrieve a list of popular companies from the Levels.fyi directory with their slugs and salary page URLs. Returns approximately 24 top companies. No pagination — single response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-levels-fyi-api-543e5df9/get_popular_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_salary_data

Retrieve detailed salary data for a specific company and job family, optionally filtered by location. Includes level breakdowns with sample data points, percentile distributions for base salary/total compensation/bonus/stock, median compensation details, and company metadata. Each level average includes individual salary samples. When a location slug is provided, results are scoped to that geographic area and location metadata is included.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_slug` | string | Yes | Company slug identifier (e.g. 'google', 'meta', 'amazon'). Obtain from get_popular_companies or get_company_overview. |
| `job_family_slug` | string | No | Job family slug (e.g. 'software-engineer', 'product-manager', 'data-scientist'). Obtain from get_job_families. |
| `location` | string | No | Location slug to filter salary data by geographic area. Accepts country slugs (e.g. 'germany', 'united-kingdom', 'india') or metro area slugs (e.g. 'london-metro-area', 'san-francisco-bay-area', 'greater-seattle-area'). When provided, results are filtered to that location and location_meta is populated. Omitting returns the default country data (United States). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-levels-fyi-api-543e5df9/get_salary_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company_slug":"<string>","job_family_slug":"<string>","location":"<string>"}'
```

### get_salary_summary_md

Retrieve an aggregate salary summary in Markdown format for a given company and optional job family. Includes median compensation, level breakdowns by job family, and attribution information. Useful for quick overviews without parsing structured data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_slug` | string | Yes | Company slug identifier (e.g. 'google', 'meta', 'amazon'). Obtain from get_popular_companies. |
| `job_family_slug` | string | No | Job family slug (e.g. 'software-engineer', 'product-manager', 'data-scientist'). Omitting returns an overall company salary summary across all roles. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-levels-fyi-api-543e5df9/get_salary_summary_md \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company_slug":"<string>","job_family_slug":"<string>"}'
```