# Levels.fyi search

Search Levels.fyi jobs by company, location, level and pay. Takes q, page, company and more, all optional. Served by Litescrape.

Search Levels.fyi jobs by company, location, level and pay.

- Tool ID: `litescrape/levels-search`
- Name in the catalog: Levels.fyi Search
- Provider: [Litescrape](/providers/litescrape.md)
- Capability: [B2B data](/tools/b2b-data.md)
- Price: $0.00015 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.00015
}
```

Pricing source: [https://litescrape.com/pricing](https://litescrape.com/pricing). $0.15 per 1,000 successful HTTP 200 requests; every native endpoint costs one call. Failed requests are not billed. Prepaid credits expire after six months..

Price verification date: 2026-11-03.

## Complete input schema


```json
{
  "additionalProperties": false,
  "properties": {
    "q": {
      "anyOf": [
        {
          "maxLength": 512,
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Job title, keywords or company; omit to browse."
    },
    "page": {
      "default": 1,
      "description": "One-based results page. Use next_page from the response to continue.",
      "minimum": 1,
      "type": "integer"
    },
    "company": {
      "anyOf": [
        {
          "pattern": "^[a-z0-9][a-z0-9-]{0,127}$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Company slug, such as google."
    },
    "location": {
      "anyOf": [
        {
          "pattern": "^[a-z0-9][a-z0-9-]{0,127}$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Levels.fyi location slug, such as united-states; not a free-text city name."
    },
    "sort": {
      "default": "relevance",
      "description": "Result ordering.",
      "enum": [
        "relevance",
        "date_published",
        "total_compensation"
      ],
      "type": "string"
    },
    "limit": {
      "default": 5,
      "description": "Companies per page; jobs are grouped by company.",
      "maximum": 20,
      "minimum": 1,
      "type": "integer"
    },
    "jobs_per_company": {
      "default": 3,
      "description": "Maximum matching jobs included for each company.",
      "maximum": 15,
      "minimum": 1,
      "type": "integer"
    },
    "companies": {
      "anyOf": [
        {
          "items": {
            "pattern": "^[a-z0-9][a-z0-9-]{0,127}$",
            "type": "string"
          },
          "maxItems": 100,
          "minItems": 1,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "Company slugs as a JSON array; mutually exclusive with company. A single company advances jobs instead of company groups."
    },
    "locations": {
      "anyOf": [
        {
          "items": {
            "pattern": "^[a-z0-9][a-z0-9-]{0,127}$",
            "type": "string"
          },
          "maxItems": 100,
          "minItems": 1,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "City, state or country slugs as a JSON array, such as [\"united-states\",\"canada\"]. Mutually exclusive with location."
    },
    "job_families": {
      "anyOf": [
        {
          "items": {
            "pattern": "^[a-z0-9][a-z0-9-]{0,127}$",
            "type": "string"
          },
          "maxItems": 100,
          "minItems": 1,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "Job-family slugs as a JSON array, such as [\"software-engineer\"]."
    },
    "levels": {
      "anyOf": [
        {
          "items": {
            "enum": [
              "internship",
              "entry",
              "mid_staff",
              "principal",
              "manager",
              "director",
              "executive"
            ],
            "type": "string"
          },
          "maxItems": 100,
          "minItems": 1,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "Standard seniority levels as a JSON array."
    },
    "employment_types": {
      "anyOf": [
        {
          "items": {
            "enum": [
              "full_time",
              "part_time",
              "contract",
              "temporary",
              "internship",
              "volunteer",
              "other"
            ],
            "type": "string"
          },
          "maxItems": 100,
          "minItems": 1,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "Employment types as a JSON array."
    },
    "work_arrangements": {
      "anyOf": [
        {
          "items": {
            "enum": [
              "remote",
              "office",
              "hybrid"
            ],
            "type": "string"
          },
          "maxItems": 100,
          "minItems": 1,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "Work arrangements as a JSON array."
    },
    "min_base_compensation": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "Minimum annual base compensation in USD."
    },
    "min_total_compensation": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "Minimum median annual total compensation in USD; may include Levels.fyi estimates."
    },
    "company_types": {
      "anyOf": [
        {
          "items": {
            "enum": [
              "private",
              "public",
              "nonprofit",
              "government",
              "education",
              "delisted"
            ],
            "type": "string"
          },
          "maxItems": 100,
          "minItems": 1,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "Company types as a JSON array."
    },
    "company_sizes": {
      "anyOf": [
        {
          "items": {
            "enum": [
              "seed",
              "early",
              "mid",
              "large",
              "enterprise"
            ],
            "type": "string"
          },
          "maxItems": 100,
          "minItems": 1,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "Company sizes as a JSON array: seed 1–50, early 51–200, mid 201–1,000, large 1,001–10,000, enterprise 10,001+ employees."
    },
    "company_valuations": {
      "anyOf": [
        {
          "items": {
            "maxItems": 2,
            "minItems": 2,
            "prefixItems": [
              {
                "type": "integer"
              },
              {
                "type": "integer"
              }
            ],
            "type": "array"
          },
          "maxItems": 100,
          "minItems": 1,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "Company valuation ranges in USD as a JSON array of [minimum, maximum] pairs."
    },
    "perk_ids": {
      "anyOf": [
        {
          "items": {
            "type": "integer"
          },
          "maxItems": 100,
          "minItems": 1,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "Benefit IDs as a JSON array, for example 58 remote work, 4 retirement plan, 35 paid time off, 22 health insurance."
    },
    "posted_within": {
      "anyOf": [
        {
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "Maximum posting age in posted_within_unit units."
    },
    "posted_within_unit": {
      "default": "days",
      "description": "Unit for posted_within.",
      "enum": [
        "days",
        "weeks",
        "months"
      ],
      "type": "string"
    }
  },
  "type": "object"
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "litescrape/levels-search",
  "input": {
    "q": "software engineer"
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://litescrape.com/docs/reference#levels-search-parameters)

[REST inspection](https://api.agentik.cc/v1/tools/litescrape/levels-search) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/litescrape/levels-search) · [Agent index](/llms.txt)