Openthebooks APIopenthebooks.com ↗
Search Nevada state employee salary records by job title, department, employer, year, or name to find compensation information across the state workforce. Quickly lookup and compare salaries for specific roles or departments within Nevada's public sector.
curl -X GET 'https://api.parse.bot/scraper/2ca9c77c-aac9-405d-9a55-fbfa7662e0d1/search_salaries_by_title?page=8&year=2024&title=economics&employer=University+of+Nevada%2C+Reno' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace openthebooks-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: OpenTheBooks SDK — bounded, re-runnable; every call capped."""
from parse_apis.openthebooks_com_api import OpenTheBooks, TitleRequired
client = OpenTheBooks()
# Search for economics department at UNR, 2024
for record in client.salary_search_results.search(
title="economics", employer="University of Nevada, Reno", year="2024", limit=3
):
print(record.name, record.title, record.annual_wages)
# Take a single result for a broader search
result = client.salary_search_results.search(
title="football", employer="University of Nevada, Reno", limit=1
).first()
if result:
print(result.name, result.title, result.year)
# Typed error: title is required
try:
client.salary_search_results.search(title="nursing", year="2024", limit=1).first()
except TitleRequired as e:
print("error:", e)
print("exercised: salary_search_results.search")
Search Nevada state employee salary records by title/department keyword. The title filter is applied client-side (case-insensitive substring match) against server-paginated results sorted by annual wages descending. Each page contains up to 100 upstream records; matches_on_page reports how many matched the title filter. Use employer and year filters to narrow the server-side result set before title filtering. Results are auto-iterated across upstream pages.
| Param | Type | Description |
|---|---|---|
| name | string | Employee last name (optionally followed by first name, no comma) for server-side filtering. |
| page | integer | Upstream page number (1-based). Each page has up to 100 upstream records, of which zero or more may match the title filter. |
| year | string | Year to filter by (e.g. '2024'). Omit or leave empty for all years. |
| titlerequired | string | Keyword to match in the employee title field (case-insensitive substring). Titles typically contain academic department names (e.g. 'economics', 'nursing', 'computer science'). |
| employer | string | Employer name for server-side filtering. Must match a value from the site's employer dropdown (e.g. 'University of Nevada, Reno', 'University of Nevada, Las Vegas'). |
{
"type": "object",
"fields": {
"page": "integer — current upstream page number",
"records": "array of matching salary records with year, employer, name, title, annual_wages, source",
"year_filter": "string or null — the year filter applied",
"title_filter": "string — the title keyword that was applied",
"has_next_page": "boolean — whether more upstream pages exist",
"employer_filter": "string or null — the employer filter applied",
"matches_on_page": "integer — how many records matched the title filter",
"records_on_page": "integer — total upstream records on this page (up to 100)"
},
"sample": {
"data": {
"page": 8,
"records": [
{
"name": "Sokolova Anna",
"year": "2024",
"title": "Associate Professor Economics",
"source": "University of Nevada, Reno",
"employer": "University of Nevada, Reno",
"annual_wages": "$124,978.54"
},
{
"name": "Pram Kym",
"year": "2024",
"title": "Assistant Professor Economics",
"source": "University of Nevada, Reno",
"employer": "University of Nevada, Reno",
"annual_wages": "$118,205.20"
}
],
"year_filter": "2024",
"title_filter": "economics",
"has_next_page": true,
"employer_filter": "University of Nevada, Reno",
"matches_on_page": 2,
"records_on_page": 100
},
"status": "success"
}
}About the Openthebooks API
The Openthebooks API on Parse exposes 1 endpoint for the publicly available data on openthebooks.com. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.