{
  "data": {
    "id": "fAy0J1vUWP28nRQsV",
    "actId": "4kmlCKvD5WZdgbm1q",
    "userId": "4BicJNfmk8uEe3GtT",
    "startedAt": "2026-11-20T12:11:20.453Z",
    "finishedAt": "2026-11-20T12:11:30.011Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CI"
    },
    "stats": {
      "durationMillis": 9481,
      "runTimeSecs": 9.481,
      "computeUnits": 0.010534444444444445,
      "imageSizeBytes": 358342656
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "chIfRjofLtMMYtdFe",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Levels.fyi Scraper Input\",\n  \"description\": \"Scrape compensation data from Levels.fyi — by company, role, location, leaderboards, or any URL.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"What to scrape from Levels.fyi.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"byCompany\",\n        \"byCompanyByRole\",\n        \"byCompanyByRoleLevel\",\n        \"byRole\",\n        \"byRoleLocation\",\n        \"searchCompanies\",\n        \"topCompanies\",\n        \"byUrl\"\n      ],\n      \"enumTitles\": [\n        \"Company overview (every role at one company)\",\n        \"Company × role (level breakdown + percentiles)\",\n        \"Company × role × level (single bucket detail)\",\n        \"Role landing (top companies for one role)\",\n        \"Role × location (geo compensation breakdown)\",\n        \"Search / list popular companies\",\n        \"Top companies & locations index\",\n        \"Scrape by levels.fyi URL\"\n      ],\n      \"default\": \"byCompanyByRole\",\n      \"prefill\": \"byCompanyByRole\"\n    },\n    \"company\": {\n      \"title\": \"Company slug\",\n      \"type\": \"string\",\n      \"description\": \"Levels.fyi company slug (mode=byCompany / byCompanyByRole / byCompanyByRoleLevel). Examples: `google`, `meta`, `apple`, `amazon`, `microsoft`, `netflix`, `openai`, `anthropic`. Visit `https://www.levels.fyi/companies/<slug>/salaries` to verify.\",\n      \"editor\": \"textfield\",\n      \"default\": \"google\",\n      \"prefill\": \"google\"\n    },\n    \"role\": {\n      \"title\": \"Role / job-family slug\",\n      \"type\": \"string\",\n      \"description\": \"Job-family slug (mode=byCompanyByRole / byCompanyByRoleLevel / byRole / byRoleLocation). Pick from common slugs or pass any valid Levels.fyi job-family slug.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"software-engineer\",\n        \"product-manager\",\n        \"data-scientist\",\n        \"data-engineer\",\n        \"machine-learning-engineer\",\n        \"hardware-engineer\",\n        \"site-reliability-engineer\",\n        \"security-software-engineer\",\n        \"engineering-manager\",\n        \"technical-program-manager\",\n        \"product-designer\",\n        \"ux-researcher\",\n        \"solution-architect\",\n        \"management-consultant\",\n        \"investment-banker\",\n        \"marketing\",\n        \"sales\",\n        \"recruiter\",\n        \"human-resources\",\n        \"financial-analyst\",\n        \"business-analyst\",\n        \"accountant\",\n        \"venture-capitalist\",\n        \"chief-of-staff\",\n        \"biomedical-engineer\",\n        \"civil-engineer\",\n        \"mechanical-engineer\",\n        \"chemical-engineer\"\n      ],\n      \"enumTitles\": [\n        \"Software Engineer\",\n        \"Product Manager\",\n        \"Data Scientist\",\n        \"Data Engineer\",\n        \"Machine Learning Engineer\",\n        \"Hardware Engineer\",\n        \"Site Reliability Engineer\",\n        \"Security Software Engineer\",\n        \"Engineering Manager\",\n        \"Technical Program Manager\",\n        \"Product Designer\",\n        \"UX Researcher\",\n        \"Solution Architect\",\n        \"Management Consultant\",\n        \"Investment Banker\",\n        \"Marketing\",\n        \"Sales\",\n        \"Recruiter\",\n        \"Human Resources\",\n        \"Financial Analyst\",\n        \"Business Analyst\",\n        \"Accountant\",\n        \"Venture Capitalist\",\n        \"Chief of Staff\",\n        \"Biomedical Engineer\",\n        \"Civil Engineer\",\n        \"Mechanical Engineer\",\n        \"Chemical Engineer\"\n      ],\n      \"default\": \"software-engineer\",\n      \"prefill\": \"software-engineer\"\n    },\n    \"level\": {\n      \"title\": \"Level slug\",\n      \"type\": \"string\",\n      \"description\": \"Levels.fyi level slug (mode=byCompanyByRoleLevel). Examples: `L3`, `L4`, `L5`, `IC3`, `E4`, `M1`. Slugs are company-specific — find them on the company×role page.\",\n      \"editor\": \"textfield\"\n    },\n    \"locationSlug\": {\n      \"title\": \"Location slug\",\n      \"type\": \"string\",\n      \"description\": \"Levels.fyi location slug (mode=byRoleLocation). Common: `united-states`, `san-francisco-bay-area`, `greater-seattle-area`, `new-york-city-area`, `europe`, `india`, `canada`, `germany`, `united-kingdom`, `japan`.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"united-states\",\n        \"san-francisco-bay-area\",\n        \"greater-seattle-area\",\n        \"new-york-city-area\",\n        \"los-angeles\",\n        \"boston\",\n        \"austin\",\n        \"chicago\",\n        \"denver\",\n        \"atlanta\",\n        \"europe\",\n        \"united-kingdom\",\n        \"germany\",\n        \"france\",\n        \"netherlands\",\n        \"ireland\",\n        \"switzerland\",\n        \"asia\",\n        \"india\",\n        \"japan\",\n        \"singapore\",\n        \"china\",\n        \"south-korea\",\n        \"canada\",\n        \"toronto\",\n        \"vancouver\",\n        \"australia\",\n        \"latin-america\",\n        \"brazil\",\n        \"mexico\",\n        \"africa\"\n      ],\n      \"enumTitles\": [\n        \"United States\",\n        \"San Francisco Bay Area\",\n        \"Greater Seattle Area\",\n        \"New York City Area\",\n        \"Los Angeles\",\n        \"Boston\",\n        \"Austin\",\n        \"Chicago\",\n        \"Denver\",\n        \"Atlanta\",\n        \"Europe\",\n        \"United Kingdom\",\n        \"Germany\",\n        \"France\",\n        \"Netherlands\",\n        \"Ireland\",\n        \"Switzerland\",\n        \"Asia\",\n        \"India\",\n        \"Japan\",\n        \"Singapore\",\n        \"China\",\n        \"South Korea\",\n        \"Canada\",\n        \"Toronto\",\n        \"Vancouver\",\n        \"Australia\",\n        \"Latin America\",\n        \"Brazil\",\n        \"Mexico\",\n        \"Africa\"\n      ],\n      \"default\": \"san-francisco-bay-area\",\n      \"prefill\": \"san-francisco-bay-area\"\n    },\n    \"url\": {\n      \"title\": \"Levels.fyi URL (mode=byUrl)\",\n      \"type\": \"string\",\n      \"description\": \"Any levels.fyi URL — `/companies/<slug>/salaries`, `/companies/<slug>/salaries/<role>`, `/t/<role>/locations/<loc>`, `/companies`, etc. Auto-routes to the right scraper.\",\n      \"editor\": \"textfield\"\n    },\n    \"search\": {\n      \"title\": \"Company name filter (mode=searchCompanies)\",\n      \"type\": \"string\",\n      \"description\": \"Substring match against the popular-companies catalog (case-insensitive). Empty = return all listed popular companies.\",\n      \"editor\": \"textfield\"\n    },\n    \"minTotalCompensation\": {\n      \"title\": \"Min total compensation\",\n      \"type\": \"integer\",\n      \"description\": \"Drop salary samples / level rows with totalCompensation below this value (USD-equivalent at the page's exchange rate).\",\n      \"minimum\": 0,\n      \"maximum\": 10000000\n    },\n    \"maxTotalCompensation\": {\n      \"title\": \"Max total compensation\",\n      \"type\": \"integer\",\n      \"description\": \"Drop salary samples / level rows with totalCompensation above this value.\",\n      \"minimum\": 0,\n      \"maximum\": 10000000\n    },\n    \"minYearsOfExperience\": {\n      \"title\": \"Min years of experience\",\n      \"type\": \"integer\",\n      \"description\": \"Drop salary samples below this YOE.\",\n      \"minimum\": 0,\n      \"maximum\": 60\n    },\n    \"maxYearsOfExperience\": {\n      \"title\": \"Max years of experience\",\n      \"type\": \"integer\",\n      \"description\": \"Drop salary samples above this YOE.\",\n      \"minimum\": 0,\n      \"maximum\": 60\n    },\n    \"includeSamples\": {\n      \"title\": \"Include individual salary samples\",\n      \"type\": \"boolean\",\n      \"description\": \"Emit one record per individual salary submission inside each level (mode=byCompany / byCompanyByRole). When false, only level-aggregate rows are emitted.\",\n      \"default\": true,\n      \"prefill\": true\n    },\n    \"includeAggregates\": {\n      \"title\": \"Include level aggregates / percentiles\",\n      \"type\": \"boolean\",\n      \"description\": \"Emit one record per level (and an overall percentiles record) summarising compensation.\",\n      \"default\": true,\n      \"prefill\": true\n    },\n    \"useResidentialProxyOnBlock\": {\n      \"title\": \"Auto-escalate to Apify residential on 403/429\",\n      \"type\": \"boolean\",\n      \"description\": \"If Cloudflare blocks the direct fetch, retry through Apify residential proxy.\",\n      \"default\": true,\n      \"prefill\": true\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Hard cap on emitted records.\",\n      \"minimum\": 1,\n      \"maximum\": 5000,\n      \"default\": 200,\n      \"prefill\": 200\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# Levels.fyi Pay Leveling & Leaderboard Scraper\n\nLevels.fyi is a crowdsourced database of tech-industry pay, organized by company, job family (role) and internal level. This actor has eight entry points into that data — from a single company's full comp overview down to one specific company × role × level bucket, plus role and location leaderboards.\n\n## What this actor does\n\n- **Company overview** (`byCompany`) — every job family at a company with its median total compensation.\n- **Company × role** (`byCompanyByRole`) — per-level medians and, optionally, every individual salary submission behind them.\n- **Company × role × level** (`byCompanyByRoleLevel`) — a single level bucket plus its percentile breakdown.\n- **Role landing** (`byRole`) — top-paying companies and top-paying locations for one job family.\n- **Role × location** (`byRoleLocation`) — percentile breakdown and top-paying companies for a role in a specific place.\n- **Company search, top-companies index, or any Levels.fyi URL** — browse the company catalog, the locations/role index, or paste a URL and the actor figures out which page type it is.\n- Fields a record doesn't carry (e.g. no stock grant on a sales role, no percentile breakdown for a thin sample) are omitted rather than filled in.\n\n## Output per record\n\nEvery record carries `recordType`, `scrapedAt`, and (when relevant) `url` back to the source page. Fields vary by `recordType`:\n\n- **`companyOverview`** (mode=`byCompany`): `company`, `companySlug`, `companyDescription`, `companyWebsite`, `companyYearFounded`, `companyEmployeeCount`, `companyTicker`, `companyLinkedIn`, `companyTwitter`, `companyHq`, `medianTotalCompensation`, `highestPayingJobFamily`/`highestPayingLevel`/`highestTotalCompensation`, `lowestPayingJobFamily`/`lowestTotalCompensation`, `jobFamilies[]` (each with `jobFamily`, `jobFamilySlug`, and `titles[]` of `{title, titleSlug, count, medianTotalCompensation}`)\n- **`levelAggregate`** (modes `byCompanyByRole`/`byCompanyByRoleLevel`): `company`, `jobFamily`, `level`, `levelName`, `secondaryLevelName`, `count`, `countLast12Months`, `medianBaseSalary`, `medianTotalCompensation`, `medianBonus`, `medianStockGrant`, `medianCommission`, `currency`, `exchangeRate`\n- **`salarySample`** (same modes, when `includeSamples` is on): `uuid`, `company`, `title`, `jobFamily`, `level`, `focusTag`, `yearsOfExperience`, `yearsAtCompany`, `yearsAtLevel`, `offerDate`, `location`, `workArrangement`, `compPerspective`, `baseSalary`, `totalCompensation`, `stockGrant`, `bonus`, `firstYearTotalCompensation`, `firstYearStockGrant`, `firstYearBonus`, `salesComp`, `baseSalaryCurrency`, `stockGrantCurrency`, `bonusCurrency`, `stockType`, `salaryFormat`, `employmentType`, `education`, `gender`, `ethnicity`, `currency`, `exchangeRate`, `companyLogo`\n- **`percentiles`** (modes `byCompanyByRoleLevel`/`byRoleLocation`): `company`, `jobFamily`, `location`, `locationName`, `count`, `currency`, plus percentile columns named `baseSalary_<p>`, `totalComp_<p>`, `bonus_<p>`, `stockGrant_<p>` (e.g. `totalComp_p50`, `totalComp_p90`)\n- **`topCompany`** (modes `byRole`/`byRoleLocation`): `company`, `companySlug`, `jobFamily`, `location`, `medianTotalCompensation`, `companyLogo`\n- **`topLocation`** (modes `byRole`/`topCompanies`): `location`, `locationSlug`, `locationType`, `jobFamily`, `region`, `medianTotalCompensation`\n- **`jobFamily`** (mode `topCompanies`): `jobFamily`, `jobFamilySlug`, `category`, `jobFamilyIcon`\n- **`company`** (mode `searchCompanies`): `company`, `companySlug`, `fundingStage` (for startups grouped by funding stage)\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `byCompanyByRole` | `byCompany`, `byCompanyByRole`, `byCompanyByRoleLevel`, `byRole`, `byRoleLocation`, `searchCompanies`, `topCompanies`, or `byUrl` |\n| `company` | string | `google` | Company slug (modes `byCompany`/`byCompanyByRole`/`byCompanyByRoleLevel`) |\n| `role` | string | `software-engineer` | Job-family slug (modes `byCompanyByRole`/`byCompanyByRoleLevel`/`byRole`/`byRoleLocation`) |\n| `level` | string | – | Level slug, company-specific, e.g. `L4`, `E4` (mode=`byCompanyByRoleLevel`) |\n| `locationSlug` | string | `san-francisco-bay-area` | Location slug (mode=`byRoleLocation`) |\n| `url` | string | – | Any Levels.fyi URL to auto-route (mode=`byUrl`) |\n| `search` | string | – | Substring filter against the popular-companies list (mode=`searchCompanies`) |\n| `minTotalCompensation` | integer | – | Drop records below this total compensation |\n| `maxTotalCompensation` | integer | – | Drop records above this total compensation |\n| `minYearsOfExperience` | integer | – | Drop salary samples below this years of experience |\n| `maxYearsOfExperience` | integer | – | Drop salary samples above this years of experience |\n| `includeSamples` | boolean | `true` | Emit individual `salarySample` records (modes `byCompany`/`byCompanyByRole`) |\n| `includeAggregates` | boolean | `true` | Emit `levelAggregate`/percentile records |\n| `useResidentialProxyOnBlock` | boolean | `true` | Retry through an Apify proxy if the direct fetch is blocked |\n| `maxItems` | integer | `200` | Hard cap on emitted records (1–5000) |\n\n### Example: full level breakdown for a company and role\n\n```json\n{\n  \"mode\": \"byCompanyByRole\",\n  \"company\": \"meta\",\n  \"role\": \"software-engineer\",\n  \"includeSamples\": false,\n  \"maxItems\": 50\n}\n```\n\n### Example: individual submissions above a comp floor\n\n```json\n{\n  \"mode\": \"byCompanyByRole\",\n  \"company\": \"amazon\",\n  \"role\": \"data-scientist\",\n  \"includeSamples\": true,\n  \"includeAggregates\": false,\n  \"minTotalCompensation\": 200000,\n  \"maxItems\": 100\n}\n```\n\n### Example: top-paying companies for a role in a region\n\n```json\n{\n  \"mode\": \"byRoleLocation\",\n  \"role\": \"product-manager\",\n  \"locationSlug\": \"europe\",\n  \"maxItems\": 50\n}\n```\n\n### Example: scrape by a Levels.fyi URL directly\n\n```json\n{\n  \"mode\": \"byUrl\",\n  \"url\": \"https://www.levels.fyi/companies/openai/salaries/software-engineer\"\n}\n```\n\n## Use cases\n\n- **Salary benchmarking** — pull company × role × level medians to set a competitive offer.\n- **Offer negotiation** — compare an individual offer against recent `salarySample` records at the same level.\n- **Compensation research** — track median total comp trends across companies for one job family.\n- **Talent market mapping** — use `byRole`/`byRoleLocation` leaderboards to see which employers pay the most for a role in a region.\n- **Company due diligence** — pull a `companyOverview` record for headcount, founding year and pay spread across job families.\n\n## FAQ\n\n**Do I need a Levels.fyi account or API key?**\nNo — every mode reads data the site serves to anonymous visitors.\n\n**Why are `medianBaseSalary`, `medianBonus` etc. sometimes missing from a `levelAggregate` record?**\nLevels.fyi only reports a median for a pay component when it has at least one non-zero submission for it; a level with no bonus submissions simply won't have `medianBonus`.\n\n**What's the difference between `levelAggregate` and `salarySample` records?**\n`levelAggregate` is one row per level with medians and counts. `salarySample` is one row per individual crowdsourced submission behind that level — turn `includeSamples` on to get both.\n\n**Why do percentile fields look like `totalComp_p50`?**\nLevels.fyi returns percentile breakdowns as a set of named points (e.g. the 25th, 50th, 90th percentile); the actor keeps that structure as flat `<metric>_<percentile>` columns rather than guessing which percentiles always exist.\n\n**Can I filter by years of experience?**\nYes, on `salarySample` records, with `minYearsOfExperience`/`maxYearsOfExperience`. It has no effect on aggregate or leaderboard record types, which don't carry a per-person experience value.\n\n**What does mode=`byUrl` actually do?**\nIt inspects the URL's path (company page, company×role page, role page, role×location page, or companies index) and runs the matching scrape logic automatically, so you don't have to pick a mode yourself.\n\n**Is this affiliated with Levels.fyi?**\nNo. This is an independent, third-party actor built on Levels.fyi's publicly browsable pages.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "levels-fyi-pay-leveling-and-leaderboard-scraper",
      "title": "Levels.fyi Pay Leveling & Leaderboard Scraper",
      "description": "Pull Levels.fyi pay data by company, role and level: base salary, stock, bonus and total compensation medians, individual submissions, percentile breakdowns, and top-paying company and location leaderboards.",
      "version": "1.0",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# Levels.fyi Pay Leveling & Leaderboard Scraper\n\nLevels.fyi is a crowdsourced database of tech-industry pay, organized by company, job family (role) and internal level. This actor has eight entry points into that data — from a single company's full comp overview down to one specific company × role × level bucket, plus role and location leaderboards.\n\n## What this actor does\n\n- **Company overview** (`byCompany`) — every job family at a company with its median total compensation.\n- **Company × role** (`byCompanyByRole`) — per-level medians and, optionally, every individual salary submission behind them.\n- **Company × role × level** (`byCompanyByRoleLevel`) — a single level bucket plus its percentile breakdown.\n- **Role landing** (`byRole`) — top-paying companies and top-paying locations for one job family.\n- **Role × location** (`byRoleLocation`) — percentile breakdown and top-paying companies for a role in a specific place.\n- **Company search, top-companies index, or any Levels.fyi URL** — browse the company catalog, the locations/role index, or paste a URL and the actor figures out which page type it is.\n- Fields a record doesn't carry (e.g. no stock grant on a sales role, no percentile breakdown for a thin sample) are omitted rather than filled in.\n\n## Output per record\n\nEvery record carries `recordType`, `scrapedAt`, and (when relevant) `url` back to the source page. Fields vary by `recordType`:\n\n- **`companyOverview`** (mode=`byCompany`): `company`, `companySlug`, `companyDescription`, `companyWebsite`, `companyYearFounded`, `companyEmployeeCount`, `companyTicker`, `companyLinkedIn`, `companyTwitter`, `companyHq`, `medianTotalCompensation`, `highestPayingJobFamily`/`highestPayingLevel`/`highestTotalCompensation`, `lowestPayingJobFamily`/`lowestTotalCompensation`, `jobFamilies[]` (each with `jobFamily`, `jobFamilySlug`, and `titles[]` of `{title, titleSlug, count, medianTotalCompensation}`)\n- **`levelAggregate`** (modes `byCompanyByRole`/`byCompanyByRoleLevel`): `company`, `jobFamily`, `level`, `levelName`, `secondaryLevelName`, `count`, `countLast12Months`, `medianBaseSalary`, `medianTotalCompensation`, `medianBonus`, `medianStockGrant`, `medianCommission`, `currency`, `exchangeRate`\n- **`salarySample`** (same modes, when `includeSamples` is on): `uuid`, `company`, `title`, `jobFamily`, `level`, `focusTag`, `yearsOfExperience`, `yearsAtCompany`, `yearsAtLevel`, `offerDate`, `location`, `workArrangement`, `compPerspective`, `baseSalary`, `totalCompensation`, `stockGrant`, `bonus`, `firstYearTotalCompensation`, `firstYearStockGrant`, `firstYearBonus`, `salesComp`, `baseSalaryCurrency`, `stockGrantCurrency`, `bonusCurrency`, `stockType`, `salaryFormat`, `employmentType`, `education`, `gender`, `ethnicity`, `currency`, `exchangeRate`, `companyLogo`\n- **`percentiles`** (modes `byCompanyByRoleLevel`/`byRoleLocation`): `company`, `jobFamily`, `location`, `locationName`, `count`, `currency`, plus percentile columns named `baseSalary_<p>`, `totalComp_<p>`, `bonus_<p>`, `stockGrant_<p>` (e.g. `totalComp_p50`, `totalComp_p90`)\n- **`topCompany`** (modes `byRole`/`byRoleLocation`): `company`, `companySlug`, `jobFamily`, `location`, `medianTotalCompensation`, `companyLogo`\n- **`topLocation`** (modes `byRole`/`topCompanies`): `location`, `locationSlug`, `locationType`, `jobFamily`, `region`, `medianTotalCompensation`\n- **`jobFamily`** (mode `topCompanies`): `jobFamily`, `jobFamilySlug`, `category`, `jobFamilyIcon`\n- **`company`** (mode `searchCompanies`): `company`, `companySlug`, `fundingStage` (for startups grouped by funding stage)\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `byCompanyByRole` | `byCompany`, `byCompanyByRole`, `byCompanyByRoleLevel`, `byRole`, `byRoleLocation`, `searchCompanies`, `topCompanies`, or `byUrl` |\n| `company` | string | `google` | Company slug (modes `byCompany`/`byCompanyByRole`/`byCompanyByRoleLevel`) |\n| `role` | string | `software-engineer` | Job-family slug (modes `byCompanyByRole`/`byCompanyByRoleLevel`/`byRole`/`byRoleLocation`) |\n| `level` | string | – | Level slug, company-specific, e.g. `L4`, `E4` (mode=`byCompanyByRoleLevel`) |\n| `locationSlug` | string | `san-francisco-bay-area` | Location slug (mode=`byRoleLocation`) |\n| `url` | string | – | Any Levels.fyi URL to auto-route (mode=`byUrl`) |\n| `search` | string | – | Substring filter against the popular-companies list (mode=`searchCompanies`) |\n| `minTotalCompensation` | integer | – | Drop records below this total compensation |\n| `maxTotalCompensation` | integer | – | Drop records above this total compensation |\n| `minYearsOfExperience` | integer | – | Drop salary samples below this years of experience |\n| `maxYearsOfExperience` | integer | – | Drop salary samples above this years of experience |\n| `includeSamples` | boolean | `true` | Emit individual `salarySample` records (modes `byCompany`/`byCompanyByRole`) |\n| `includeAggregates` | boolean | `true` | Emit `levelAggregate`/percentile records |\n| `useResidentialProxyOnBlock` | boolean | `true` | Retry through an Apify proxy if the direct fetch is blocked |\n| `maxItems` | integer | `200` | Hard cap on emitted records (1–5000) |\n\n### Example: full level breakdown for a company and role\n\n```json\n{\n  \"mode\": \"byCompanyByRole\",\n  \"company\": \"meta\",\n  \"role\": \"software-engineer\",\n  \"includeSamples\": false,\n  \"maxItems\": 50\n}\n```\n\n### Example: individual submissions above a comp floor\n\n```json\n{\n  \"mode\": \"byCompanyByRole\",\n  \"company\": \"amazon\",\n  \"role\": \"data-scientist\",\n  \"includeSamples\": true,\n  \"includeAggregates\": false,\n  \"minTotalCompensation\": 200000,\n  \"maxItems\": 100\n}\n```\n\n### Example: top-paying companies for a role in a region\n\n```json\n{\n  \"mode\": \"byRoleLocation\",\n  \"role\": \"product-manager\",\n  \"locationSlug\": \"europe\",\n  \"maxItems\": 50\n}\n```\n\n### Example: scrape by a Levels.fyi URL directly\n\n```json\n{\n  \"mode\": \"byUrl\",\n  \"url\": \"https://www.levels.fyi/companies/openai/salaries/software-engineer\"\n}\n```\n\n## Use cases\n\n- **Salary benchmarking** — pull company × role × level medians to set a competitive offer.\n- **Offer negotiation** — compare an individual offer against recent `salarySample` records at the same level.\n- **Compensation research** — track median total comp trends across companies for one job family.\n- **Talent market mapping** — use `byRole`/`byRoleLocation` leaderboards to see which employers pay the most for a role in a region.\n- **Company due diligence** — pull a `companyOverview` record for headcount, founding year and pay spread across job families.\n\n## FAQ\n\n**Do I need a Levels.fyi account or API key?**\nNo — every mode reads data the site serves to anonymous visitors.\n\n**Why are `medianBaseSalary`, `medianBonus` etc. sometimes missing from a `levelAggregate` record?**\nLevels.fyi only reports a median for a pay component when it has at least one non-zero submission for it; a level with no bonus submissions simply won't have `medianBonus`.\n\n**What's the difference between `levelAggregate` and `salarySample` records?**\n`levelAggregate` is one row per level with medians and counts. `salarySample` is one row per individual crowdsourced submission behind that level — turn `includeSamples` on to get both.\n\n**Why do percentile fields look like `totalComp_p50`?**\nLevels.fyi returns percentile breakdowns as a set of named points (e.g. the 25th, 50th, 90th percentile); the actor keeps that structure as flat `<metric>_<percentile>` columns rather than guessing which percentiles always exist.\n\n**Can I filter by years of experience?**\nYes, on `salarySample` records, with `minYearsOfExperience`/`maxYearsOfExperience`. It has no effect on aggregate or leaderboard record types, which don't carry a per-person experience value.\n\n**What does mode=`byUrl` actually do?**\nIt inspects the URL's path (company page, company×role page, role page, role×location page, or companies index) and runs the matching scrape logic automatically, so you don't have to pick a mode yourself.\n\n**Is this affiliated with Levels.fyi?**\nNo. This is an independent, third-party actor built on Levels.fyi's publicly browsable pages.\n",
      "input": {
        "title": "Levels.fyi Scraper Input",
        "description": "Scrape compensation data from Levels.fyi — by company, role, location, leaderboards, or any URL.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "What to scrape from Levels.fyi.",
            "editor": "select",
            "enum": [
              "byCompany",
              "byCompanyByRole",
              "byCompanyByRoleLevel",
              "byRole",
              "byRoleLocation",
              "searchCompanies",
              "topCompanies",
              "byUrl"
            ],
            "enumTitles": [
              "Company overview (every role at one company)",
              "Company × role (level breakdown + percentiles)",
              "Company × role × level (single bucket detail)",
              "Role landing (top companies for one role)",
              "Role × location (geo compensation breakdown)",
              "Search / list popular companies",
              "Top companies & locations index",
              "Scrape by levels.fyi URL"
            ],
            "default": "byCompanyByRole",
            "prefill": "byCompanyByRole"
          },
          "company": {
            "title": "Company slug",
            "type": "string",
            "description": "Levels.fyi company slug (mode=byCompany / byCompanyByRole / byCompanyByRoleLevel). Examples: `google`, `meta`, `apple`, `amazon`, `microsoft`, `netflix`, `openai`, `anthropic`. Visit `https://www.levels.fyi/companies/<slug>/salaries` to verify.",
            "editor": "textfield",
            "default": "google",
            "prefill": "google"
          },
          "role": {
            "title": "Role / job-family slug",
            "type": "string",
            "description": "Job-family slug (mode=byCompanyByRole / byCompanyByRoleLevel / byRole / byRoleLocation). Pick from common slugs or pass any valid Levels.fyi job-family slug.",
            "editor": "select",
            "enum": [
              "software-engineer",
              "product-manager",
              "data-scientist",
              "data-engineer",
              "machine-learning-engineer",
              "hardware-engineer",
              "site-reliability-engineer",
              "security-software-engineer",
              "engineering-manager",
              "technical-program-manager",
              "product-designer",
              "ux-researcher",
              "solution-architect",
              "management-consultant",
              "investment-banker",
              "marketing",
              "sales",
              "recruiter",
              "human-resources",
              "financial-analyst",
              "business-analyst",
              "accountant",
              "venture-capitalist",
              "chief-of-staff",
              "biomedical-engineer",
              "civil-engineer",
              "mechanical-engineer",
              "chemical-engineer"
            ],
            "enumTitles": [
              "Software Engineer",
              "Product Manager",
              "Data Scientist",
              "Data Engineer",
              "Machine Learning Engineer",
              "Hardware Engineer",
              "Site Reliability Engineer",
              "Security Software Engineer",
              "Engineering Manager",
              "Technical Program Manager",
              "Product Designer",
              "UX Researcher",
              "Solution Architect",
              "Management Consultant",
              "Investment Banker",
              "Marketing",
              "Sales",
              "Recruiter",
              "Human Resources",
              "Financial Analyst",
              "Business Analyst",
              "Accountant",
              "Venture Capitalist",
              "Chief of Staff",
              "Biomedical Engineer",
              "Civil Engineer",
              "Mechanical Engineer",
              "Chemical Engineer"
            ],
            "default": "software-engineer",
            "prefill": "software-engineer"
          },
          "level": {
            "title": "Level slug",
            "type": "string",
            "description": "Levels.fyi level slug (mode=byCompanyByRoleLevel). Examples: `L3`, `L4`, `L5`, `IC3`, `E4`, `M1`. Slugs are company-specific — find them on the company×role page.",
            "editor": "textfield"
          },
          "locationSlug": {
            "title": "Location slug",
            "type": "string",
            "description": "Levels.fyi location slug (mode=byRoleLocation). Common: `united-states`, `san-francisco-bay-area`, `greater-seattle-area`, `new-york-city-area`, `europe`, `india`, `canada`, `germany`, `united-kingdom`, `japan`.",
            "editor": "select",
            "enum": [
              "united-states",
              "san-francisco-bay-area",
              "greater-seattle-area",
              "new-york-city-area",
              "los-angeles",
              "boston",
              "austin",
              "chicago",
              "denver",
              "atlanta",
              "europe",
              "united-kingdom",
              "germany",
              "france",
              "netherlands",
              "ireland",
              "switzerland",
              "asia",
              "india",
              "japan",
              "singapore",
              "china",
              "south-korea",
              "canada",
              "toronto",
              "vancouver",
              "australia",
              "latin-america",
              "brazil",
              "mexico",
              "africa"
            ],
            "enumTitles": [
              "United States",
              "San Francisco Bay Area",
              "Greater Seattle Area",
              "New York City Area",
              "Los Angeles",
              "Boston",
              "Austin",
              "Chicago",
              "Denver",
              "Atlanta",
              "Europe",
              "United Kingdom",
              "Germany",
              "France",
              "Netherlands",
              "Ireland",
              "Switzerland",
              "Asia",
              "India",
              "Japan",
              "Singapore",
              "China",
              "South Korea",
              "Canada",
              "Toronto",
              "Vancouver",
              "Australia",
              "Latin America",
              "Brazil",
              "Mexico",
              "Africa"
            ],
            "default": "san-francisco-bay-area",
            "prefill": "san-francisco-bay-area"
          },
          "url": {
            "title": "Levels.fyi URL (mode=byUrl)",
            "type": "string",
            "description": "Any levels.fyi URL — `/companies/<slug>/salaries`, `/companies/<slug>/salaries/<role>`, `/t/<role>/locations/<loc>`, `/companies`, etc. Auto-routes to the right scraper.",
            "editor": "textfield"
          },
          "search": {
            "title": "Company name filter (mode=searchCompanies)",
            "type": "string",
            "description": "Substring match against the popular-companies catalog (case-insensitive). Empty = return all listed popular companies.",
            "editor": "textfield"
          },
          "minTotalCompensation": {
            "title": "Min total compensation",
            "type": "integer",
            "description": "Drop salary samples / level rows with totalCompensation below this value (USD-equivalent at the page's exchange rate).",
            "minimum": 0,
            "maximum": 10000000
          },
          "maxTotalCompensation": {
            "title": "Max total compensation",
            "type": "integer",
            "description": "Drop salary samples / level rows with totalCompensation above this value.",
            "minimum": 0,
            "maximum": 10000000
          },
          "minYearsOfExperience": {
            "title": "Min years of experience",
            "type": "integer",
            "description": "Drop salary samples below this YOE.",
            "minimum": 0,
            "maximum": 60
          },
          "maxYearsOfExperience": {
            "title": "Max years of experience",
            "type": "integer",
            "description": "Drop salary samples above this YOE.",
            "minimum": 0,
            "maximum": 60
          },
          "includeSamples": {
            "title": "Include individual salary samples",
            "type": "boolean",
            "description": "Emit one record per individual salary submission inside each level (mode=byCompany / byCompanyByRole). When false, only level-aggregate rows are emitted.",
            "default": true,
            "prefill": true
          },
          "includeAggregates": {
            "title": "Include level aggregates / percentiles",
            "type": "boolean",
            "description": "Emit one record per level (and an overall percentiles record) summarising compensation.",
            "default": true,
            "prefill": true
          },
          "useResidentialProxyOnBlock": {
            "title": "Auto-escalate to Apify residential on 403/429",
            "type": "boolean",
            "description": "If Cloudflare blocks the direct fetch, retry through Apify residential proxy.",
            "default": true,
            "prefill": true
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Hard cap on emitted records.",
            "minimum": 1,
            "maximum": 5000,
            "default": 200,
            "prefill": 200
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Levels.fyi Pay Leveling & Leaderboard Scraper Output",
        "description": "Levels.fyi compensation records — company overviews, per-level medians, individual submissions, percentiles, and top-paying company/location leaderboards.",
        "properties": {
          "records": {
            "type": "string",
            "title": "Compensation records",
            "description": "Dataset containing all scraped Levels.fyi records.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Compensation records",
              "transformation": {
                "fields": [
                  "recordType",
                  "company",
                  "jobFamily",
                  "level",
                  "location",
                  "totalCompensation",
                  "baseSalary",
                  "stockGrant",
                  "bonus",
                  "currency",
                  "url"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.0.1",
    "imageDigest": "fb9c5b5819fce69f41be960d902691c280635ec7d365d8a979a756709cbabc52",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.010534444444444445
    }
  }
}