Losangelescounty APIlosangelescounty.gov ↗
Access LA County Board of Supervisors minutes, transcripts, agendas, code violations, and department contacts via 6 structured endpoints.
What is the Losangelescounty API?
The LA County Gov API exposes 6 endpoints covering public records from Los Angeles County's official sources, including Board of Supervisors meeting minutes, transcripts, and agendas. The get_code_violations endpoint returns housing and rental habitability violation records with support for multiple dataset types, while get_county_departments delivers structured contact information — name, phone, email, address, and website — for every county department in the official directory.
curl -X GET 'https://api.parse.bot/scraper/e2a41613-6aec-4498-b65c-dbb18fb07889/get_code_violations?limit=100&dataset_type=rental_housing' \ -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 losangelescounty-gov-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: LA County SDK — bounded, re-runnable; every call capped."""
from parse_apis.los_angeles_county_public_api import LACounty, NotFoundError
county = LACounty()
# Search board meeting minutes about budget topics
for minute in county.minutes.list(query="budget", limit=5):
print(minute.title, minute.date, minute.pdf_url)
# Search transcripts mentioning housing
transcript = county.transcripts.list(query="housing", limit=1).first()
if transcript:
print(transcript.title, transcript.file_url, transcript.content_preview[:80])
# List all county departments
for dept in county.departments.list(limit=5):
print(dept.name, dept.email, dept.website)
# Search public records across all document types
try:
for record in county.records.search(query="fire safety", limit=3):
print(record.title, record.type, record.date, record.url)
except NotFoundError as exc:
print(f"not found: {exc}")
# List board meeting agendas
for agenda in county.agendas.list(limit=5):
print(agenda.title, agenda.url)
print("exercised: minutes.list / transcripts.list / departments.list / records.search / agendas.list")
Extract code violation records from the LA County ArcGIS Feature Services. Supports Rental Housing Habitability Program (RHHP) and general housing violations.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of records to return |
| dataset_type | string | Dataset type: 'rental_housing' (default) or 'housing' (hotels/motels/MFDs) |
{
"type": "object",
"fields": {
"violations": "array",
"total_returned": "integer"
},
"sample": {
"data": {
"violations": [
{
"code": "H087",
"status": "HOUSING NON-CRITICAL",
"object_id": 1,
"description": "CAST-OFFS/DEBRIS/WASTE - PREMISES",
"serial_number": "DAXCHP2EU"
},
{
"code": "H092",
"status": "HOUSING NON-CRITICAL",
"object_id": 2,
"description": "WINDOWS/SCREENS - PREMISES",
"serial_number": "DALKTLOC7"
},
{
"code": "H087",
"status": "HOUSING NON-CRITICAL",
"object_id": 3,
"description": "CAST-OFFS/DEBRIS/WASTE - PREMISES",
"serial_number": "DAITXA0TH"
}
],
"total_returned": 100
},
"status": "success"
}
}About the Losangelescounty API
Board of Supervisors Records
Three endpoints cover the BOS document repository. get_meeting_minutes and get_meeting_transcripts both accept an optional query string and a limit parameter. Minutes responses include title, date, pdf_url, content_preview, doc_id, and object_id. Transcript responses return a file_url and file_extension alongside the same core fields, which is useful when transcripts are served in formats other than PDF. get_board_meeting_agendas requires no parameters and returns an array of agenda objects, each containing a title and a direct url to the agenda document.
Full-Text Record Search
search_county_records queries across all three document types — Minutes, Transcripts, and Supporting Documents — in a single call. The query parameter is required. Each result includes title, type, date, url, and content, letting callers distinguish document categories without issuing three separate requests. The total_hits field reflects the full result count in the index, independent of the limit applied to the returned array.
Code Violations and Department Directory
get_code_violations pulls from LA County ArcGIS Feature Services. The dataset_type parameter switches between rental_housing (Rental Housing Habitability Program records, the default) and housing (hotels, motels, and multi-family dwellings). Responses include an array of violation objects and a total_returned count. get_county_departments requires no inputs and returns the full county department list with name, email, website, phone, and address per entry — suitable for building contact directories or routing inquiries programmatically.
The Losangelescounty API is a managed, monitored endpoint for losangelescounty.gov — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when losangelescounty.gov changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official losangelescounty.gov API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor rental housing code violations in specific neighborhoods using
get_code_violationswith therental_housingdataset - Build a searchable archive of Board of Supervisors decisions by querying
search_county_recordswith policy-related keywords - Track agenda items for upcoming BOS meetings by polling
get_board_meeting_agendasfor new PDF links - Compare transcript and minutes content for the same meeting date using
get_meeting_transcriptsandget_meeting_minutesin parallel - Populate a county department contact database using the
name,phone,email, andaddressfields fromget_county_departments - Alert stakeholders when new hotel or motel housing violations appear by filtering
get_code_violationswithdataset_type=housing
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does LA County publish an official developer API?+
What fields does `get_code_violations` return for each violation record?+
dataset_type: rental_housing covers Rental Housing Habitability Program records, while housing covers hotels, motels, and multi-family dwellings. Both modes return a total_returned count alongside the violations array. Specific attribute fields (address, violation type, status) reflect what the underlying ArcGIS feature layer exposes for each dataset.Can I search minutes or transcripts by date range?+
get_meeting_minutes and get_meeting_transcripts support keyword filtering via the query parameter and a result count via limit, but neither accepts date range inputs. Each result includes a date field, so client-side filtering by date is possible after retrieval. You can fork this API on Parse and revise it to add date-range filtering as an additional parameter.Does the API cover individual BOS supervisor profiles or voting records?+
How complete is the department contact data from `get_county_departments`?+
name, email, website, phone, and address fields, but individual values may be empty strings if the source directory does not provide them.