# GovSalaries Public Employee Salary Scraper (`jungle_synthesizer/govsalaries-public-employee-salary-scraper`) Actor Nationwide database of actual US public-employee pay — every state and employer type: cities, counties, school districts, universities, colleges, hospitals, police and fire departments. Filter by state, category, employer or job title; add pay and benefits detail per record. - **URL**: https://apify.com/jungle\_synthesizer/govsalaries-public-employee-salary-scraper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Jobs, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.80 / 1,000 record scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## GovSalaries Public Employee Salary Scraper Scrape public-employee pay records from [GovSalaries](https://govsalaries.com), the nationwide database of actual US government payroll. Returns employee name, year, job title, employer, state, and category across every US state and nine employer types — cities, counties, school districts, colleges, universities, hospitals, fire departments, and police. --- ### GovSalaries Scraper Features - Covers all 50 states plus DC and federal employers — one actor, every jurisdiction - Filters by state, employer category, a specific employer, job title text, or year - Returns the full pay breakdown as an opt-in — regular pay, other pay, total pay, benefits, and total compensation - Pulls employer aggregates too: headcount, average annual wage, median annual wage - Pure HTTP scraping — no browser required - Supports resuming a stopped run without re-paying for records you already have --- ### Who Uses Public Payroll Data? - **Journalists and watchdog groups** — pull salary history for any agency, any state, without filing a records request - **Union negotiators** — benchmark police, fire, and teacher pay against comparable jurisdictions - **Compensation and relocation researchers** — school-district and university pay are the highest-volume slices, and now they're queryable - **Policy researchers** — track public payroll spend across categories and geography - **Recruiters and HR teams** — check what a public-sector role actually pays before making an offer --- ### How GovSalaries Scraper Works 1. Pick a scope — one or more states, one or more employer categories, a single employer, or leave it open for everything. 2. The scraper walks GovSalaries' own category and employer indexes to find matching roster pages, then reads name, year, job title, and employer off each one. 3. Set `includePay` to true and each row also gets a follow-up fetch for the pay breakdown and employer aggregates — one extra request per record, billed as an add-on. 4. Records stream out until `maxItems` is reached or the scope is exhausted. --- ### Input ```json { "states": ["CA"], "categories": ["school-district"], "includePay": true, "maxItems": 100 } ```` | Field | Type | Default | Description | |-------|------|---------|-------------| | `states` | array | all states | US state/territory codes to include (e.g. `CA`, `TX`, `DC`, `FD` for federal). Leave empty for all. | | `categories` | array | all categories | Employer types to include: `city`, `county`, `state`, `school-district`, `college`, `university`, `fire-protection`, `police`, `hospital`. Leave empty for all. | | `agency` | string | — | Limit results to one employer by name or URL slug. Requires at least one selected state. | | `jobTitleQuery` | string | — | Only return rows whose job title contains this text. | | `year` | integer | — | Only return rows from one calendar year. | | `includePay` | boolean | `false` | Add regular pay, other pay, total pay, benefits, and total compensation to each row. | | `maxItems` | integer | `15` | Maximum number of records to return. | | `resumeCursor` | string | — | Cursor from a previous run's Output. Continues a stopped crawl without re-charging for records already delivered. | A second example, pulling every record for a single employer with the full pay breakdown: ```json { "states": ["CA"], "agency": "gilroy-unified", "includePay": true, "maxItems": 500 } ``` *** ### GovSalaries Scraper Output Fields Without `includePay` (the default — fast, roster-only): ```json { "employee_name": "Paul Winslow", "year": 2024, "job_title": "Assistant Superintendent HR", "agency": "Gilroy Unified", "state": "CA", "category": "school-district", "profile_url": "https://govsalaries.com/paul-winslow-213465883" } ``` With `includePay: true`, the same row also carries the pay breakdown and employer aggregates: ```json { "employee_name": "Paul Winslow", "year": 2024, "job_title": "Assistant Superintendent HR", "agency": "Gilroy Unified", "state": "CA", "category": "school-district", "profile_url": "https://govsalaries.com/paul-winslow-213465883", "total_compensation": 305010, "regular_pay": 238377, "other_pay": 17334, "total_pay": 255711, "benefits": 49299, "location": "Santa Clara County", "pay_plan": null, "employer_employees_number": 1538, "employer_average_annual_wage": 87722, "employer_median_annual_wage": 69535 } ``` | Field | Type | Description | |-------|------|-------------| | `employee_name` | string | Employee's full name | | `year` | number | Calendar year the record covers | | `job_title` | string | Job title as listed (some agencies don't publish this — expect `N/A`) | | `agency` | string | Employer name | | `state` | string | Two-letter state code (or `FD` for federal) | | `category` | string | Employer type — see the `categories` input field for the full list | | `profile_url` | string | Link to the employee's detail page on GovSalaries | | `total_compensation` | number | Total compensation, `includePay` only | | `regular_pay` | number | Regular pay, `includePay` only | | `other_pay` | number | Other pay, `includePay` only | | `total_pay` | number | Total pay (regular + other), `includePay` only | | `benefits` | number | Benefits value, `includePay` only | | `location` | string | County, `includePay` only | | `pay_plan` | string | Pay plan, when published — `includePay` only | | `employer_employees_number` | number | Employer's total headcount, `includePay` only | | `employer_average_annual_wage` | number | Employer's average annual wage, `includePay` only | | `employer_median_annual_wage` | number | Employer's median annual wage, `includePay` only | *** ### Resuming a large crawl Every run emits a `resumeCursor` in its Output. If a large crawl stops before it finishes — because it hit `maxItems`, your spend cap (`maxTotalChargeUsd`), or was aborted — start a new run with **the same input** plus that `resumeCursor` to continue from where it left off. The crawl resumes from the queued work the previous run didn't reach. - You are **not re-charged** for records the earlier run already delivered. - Resume within your account's run-retention window — on the free tier, roughly your 10 most recent runs. Once the source run is pruned, its `resumeCursor` is no longer valid. - `resumeCursor` is opaque — supply it unmodified. *** ### FAQ #### How do I scrape GovSalaries? Run this actor with a state, a category, or an employer — or leave the filters empty and let `maxItems` bound the run. GovSalaries Scraper handles the pagination and employer discovery for you. #### What data can I get from GovSalaries? Employee name, year, job title, employer, state, and category on every run. Add `includePay: true` for the full pay breakdown — regular pay, other pay, total pay, benefits, total compensation — plus employer headcount and wage averages. #### Can I filter by state or employer type? Yes. `states` and `categories` both take multiple values, so you can pull, say, school districts in California and Texas in one run. `agency` narrows to a single employer, and `jobTitleQuery` filters by title text. #### How much does GovSalaries Scraper cost to run? Roster records (name, year, title, employer) are priced at the standard per-record rate. The pay breakdown is a separate add-on charge per record, only billed when `includePay` is set — you're not paying for data you didn't ask for. #### Does GovSalaries Scraper need proxies? No setup on your end. The actor handles its own access — you just configure the input and run it. #### What job titles show up as "N/A"? Some agencies don't publish job titles for every record — GovSalaries lists those rows as `N/A`, and the scraper returns exactly what the source shows rather than guessing. *** ### Need More Features? Need custom fields, filters, or a different target site? [File an issue](https://console.apify.com/actors/issues) or get in touch. ### Why Use GovSalaries Scraper? - **National coverage** — every state, every employer level, one actor. Most public-pay sources cover a single state. - **Real payroll, not advertised pay** — this is what public employees are actually paid, not a job listing's salary range. - **Pay data on demand** — the roster is free to browse; the full pay breakdown is a per-record add-on, so you only pay for what you use. # Actor input Schema ## `sp_intended_usage` (type: `string`): What will this data feed? E.g. lead lists, KYB checks, price tracking. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): We'll personally help with your use case. No spam. ## `resumeCursor` (type: `string`): Paste a previous run's resumeCursor to continue where it stopped. ## `states` (type: `array`): US states/territories to include. Leave empty for all. ## `categories` (type: `array`): Employer types to include. Leave empty for all. ## `agency` (type: `string`): Limit results to one employer by name or slug. ## `jobTitleQuery` (type: `string`): Only return rows whose job title contains this text. ## `year` (type: `integer`): Only return rows from one calendar year. ## `includePay` (type: `boolean`): Add regular pay, other pay, total pay, benefits and total compensation to each row. ## `maxItems` (type: `integer`): Maximum number of records to return. ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "states": [ "CA" ], "categories": [], "includePay": false, "maxItems": 10 } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "states": [ "CA" ], "categories": [], "agency": "", "jobTitleQuery": "", "includePay": false, "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/govsalaries-public-employee-salary-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "states": ["CA"], "categories": [], "agency": "", "jobTitleQuery": "", "includePay": False, "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/govsalaries-public-employee-salary-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "states": [ "CA" ], "categories": [], "agency": "", "jobTitleQuery": "", "includePay": false, "maxItems": 10 }' | apify call jungle_synthesizer/govsalaries-public-employee-salary-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/govsalaries-public-employee-salary-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "GovSalaries Public Employee Salary Scraper", "description": "Nationwide database of actual US public-employee pay — every state and employer type: cities, counties, school districts, universities, colleges, hospitals, police and fire departments. Filter by state, category, employer or job title; add pay and benefits detail per record.", "version": "0.1", "x-build-id": "H5tEvZXcZW6w9klBp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~govsalaries-public-employee-salary-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-govsalaries-public-employee-salary-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/jungle_synthesizer~govsalaries-public-employee-salary-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-govsalaries-public-employee-salary-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/jungle_synthesizer~govsalaries-public-employee-salary-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-govsalaries-public-employee-salary-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "maxItems" ], "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "What will this data feed? E.g. lead lists, KYB checks, price tracking." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact email (optional)", "minLength": 1, "type": "string", "description": "We'll personally help with your use case. No spam." }, "resumeCursor": { "title": "Resume cursor (continue a previous run)", "type": "string", "description": "Paste a previous run's resumeCursor to continue where it stopped." }, "states": { "title": "States", "type": "array", "description": "US states/territories to include. Leave empty for all.", "items": { "type": "string", "enum": [ "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "DC", "FD" ], "enumTitles": [ "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "Florida", "Georgia", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire", "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming", "District of Columbia", "Federal" ] } }, "categories": { "title": "Employer Categories", "type": "array", "description": "Employer types to include. Leave empty for all.", "items": { "type": "string", "enum": [ "city", "county", "state", "school-district", "college", "university", "fire-protection", "police", "hospital" ], "enumTitles": [ "City", "County", "State Government", "School District", "College", "University", "Fire Protection", "Police", "Hospital" ] } }, "agency": { "title": "Employer", "type": "string", "description": "Limit results to one employer by name or slug." }, "jobTitleQuery": { "title": "Job Title Contains", "type": "string", "description": "Only return rows whose job title contains this text." }, "year": { "title": "Year", "type": "integer", "description": "Only return rows from one calendar year." }, "includePay": { "title": "Include Pay Breakdown", "type": "boolean", "description": "Add regular pay, other pay, total pay, benefits and total compensation to each row.", "default": false }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of records to return.", "default": 15 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```