# Levels.fyi Jobs API

> Search Levels.fyi job listings by title or keyword and get each job with its salary range and estimated total compensation where Levels.fyi has them, plus company, location, listing date and job link. Returns up to 20 jobs per call, grouped by company; filter by location and sort by relevance, date or compensation.

Source: https://www.sandbase.ai/apis/levels-fyi/jobs
API reference: https://www.sandbase.ai/apis/levels-fyi/jobs#api

## Facts

- Provider: Levels.fyi
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/levels-fyi/jobs`
- Price: From $0.00085 per call
- Capabilities: api, levels fyi, jobs, salaries
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/levels-fyi/jobs` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `query` | string | yes |  |
| `limit` | integer | no |  |
| `sortBy` | string | no | relevance, date, compensation |
| `location` | string | no |  |

## FAQ

### How do I use the Levels.fyi Jobs API?

Send a POST request to https://api.sandbase.ai/v1/api/levels-fyi/jobs with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the Levels.fyi Jobs API cost?

From $0.00085 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the Levels.fyi Jobs API accept?

Required: query (string). Optional: limit (integer), sortBy (one of relevance, date, compensation) and location (string). The Parameters table and the Playground on this page list every field.

### What does the Levels.fyi Jobs API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Levels.fyi developer account or API key?

No. Levels.fyi Jobs runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Levels.fyi API access separately.

## README

### Levels.fyi Jobs API

Search Levels.fyi job listings by title or keyword and get each job with its salary range and estimated total compensation where Levels.fyi has them, plus company, location, listing date and job link. Returns up to 20 jobs per call, grouped by company; filter by location and sort by relevance, date or compensation.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "levels-fyi/jobs", "limit": 10, "query": "software engineer", "location": "united-states"}'
```

The result is returned in `outputs[0].data`. Lookups that find nothing fail with a not-found error.

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `query` | string | Yes | Job title, keywords or company name to search, e.g. software engineer or google. |
| `limit` | integer | No | Maximum number of jobs to return (1-20, default 20). Levels.fyi groups jobs by company, up to 3 per company, so several results can come from one employer. |
| `location` | string | No | Levels.fyi location slug as it appears in Levels.fyi URLs, e.g. united-states. Not a free-text city name; omit it to search everywhere. |
| `sortBy` | string | No | Sort order: best match (relevance), most recently posted (date), or highest total compensation (compensation). One of: `relevance`, `date`, `compensation`. |

#### Pricing

Billed at the actual cost of each call, about $0.00085 per request. A call can cost more when the first data source fails and another one answers. Failed calls and lookups that find nothing are not charged.