Harris County TX APIharriscountytx.gov ↗
Access Harris County election results, county services, public notices, and Commissioners Court meeting schedules via a structured JSON API.
What is the Harris County TX API?
The Harris County TX API provides 4 endpoints covering election results, county facilities, public notices, and the Commissioners Court calendar from harriscountytx.gov. The get_election_results endpoint returns contest-level vote breakdowns by absentee, early voting, and election day tallies. The get_county_services endpoint surfaces facility data — parks, libraries, senior centers, and more — with addresses and service-type-specific fields pulled from ArcGIS.
curl -X GET 'https://api.parse.bot/scraper/b0c5049d-7c08-4129-812f-771091f3cd8e/get_election_results?party=dem&election_code=0326' \ -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 harriscountytx-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.
from parse_apis.harris_county_public_data_api import HarrisCounty, Party, ServiceType
client = HarrisCounty()
# Fetch Democratic primary election results
result = client.electionresults.get(election_code="0326", party=Party.DEM)
print(result.et, result.edt)
for contest in result.contests:
print(contest.t, contest.tp, contest.pct)
# List parks from county services
for service in client.services.list(service_type=ServiceType.PARKS):
print(service.Name, service.Address, service.Acreage)
# Get public notices
for notice in client.notices.list():
print(notice.title, notice.link, notice.source)
# List upcoming court events
for event in client.courtevents.list():
print(event.EventDate, event.EventTime, event.EventBodyName, event.EventLocation)
Fetch election results for a specific Harris County election and party. Returns contest-level results including candidate names, vote counts by type (absentee, early voting, election day), and percentages. Each contest contains arrays of candidates with parallel arrays for vote breakdowns. Results are cumulative and timestamped with last-update time.
| Param | Type | Description |
|---|---|---|
| party | string | Party code. |
| election_code | string | Election code identifying a specific election (e.g. '0326' for March 2026 Primary). |
{
"type": "object",
"fields": {
"dt": "string — last update timestamp in ISO format",
"ec": "string — election code",
"et": "string — election type (e.g. 'Primary Election')",
"edt": "string — election date",
"contests": "array of contest objects with candidate names, vote breakdowns, and percentages"
},
"sample": {
"data": {
"o": 1,
"bc": 0,
"dt": "2026-03-13T13:20:00Z",
"ec": "0326",
"et": "Primary Election",
"rv": 0,
"to": null,
"vc": 275,
"vt": 275,
"edt": "March 03, 2026",
"contests": [
{
"i": 8301,
"t": "Dem - United States Senator",
"ab": [
5904,
6176,
125
],
"ca": [
"JAMES TALARICO (DEM)",
"JASMINE CROCKETT (DEM)",
"AHMAD R. HASSAN (DEM)"
],
"cp": "DEM",
"ed": [
69306,
70428,
1760
],
"ev": [
95093,
113723,
1970
],
"pr": 1157,
"sn": "1",
"tp": 1157,
"tv": [
170564,
190615,
3863
],
"vf": 0,
"pct": [
"46.72%",
"52.22%",
"1.06%"
]
}
]
},
"status": "success"
}
}About the Harris County TX API
Election Results
The get_election_results endpoint accepts an election_code parameter (e.g. '0326' for the March 2026 Primary) and an optional party filter ('dem' or 'rep'). Responses include the election type (et), election date (edt), and a contests array. Each contest object contains candidate names and vote counts broken down by absentee, early voting, and election day, plus percentage figures. This makes it straightforward to compute margin-of-victory or turnout comparisons across voting methods.
County Services and Facilities
get_county_services returns paginated feature records from Harris County's ArcGIS layer. The service_type parameter filters by category: 'Parks', 'Public_Library_Branches', 'CommunityCenters', 'Senior_Centers', or 'County_Annexes' (among accepted values). Each record includes Name, Address, and additional fields that vary by service type. Use limit and offset to page through large result sets.
Public Notices and Commissioners Court
get_public_notices requires no parameters and returns a notices array where each item carries a title, link, and source — distinguishing between notices from the Harris County homepage and the County Clerk's Commissioners Court exceptions archive. The get_commissioners_court_calendar endpoint queries the Legistar system and returns meeting events in descending date order. Each event object includes EventDate, EventTime, EventLocation, EventBodyName, and EventAgendaFile (a direct URL to the agenda document), along with additional Legistar metadata. A limit parameter controls how many meetings are returned.
The Harris County TX API is a managed, monitored endpoint for harriscountytx.gov — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when harriscountytx.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 harriscountytx.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?+
- Track candidate vote totals and absentee vs. election-day splits for Harris County primary or general elections
- Build a facility finder that locates nearby Harris County parks, libraries, or senior centers by address
- Monitor the Commissioners Court agenda file URL to alert stakeholders when a new meeting packet is posted
- Aggregate public notices from multiple Harris County sources into a single feed for legal or civic monitoring tools
- Compare early voting and election day turnout across contests within the same election code
- Paginate through Harris County community center records to populate a directory or mapping application
- Feed Commissioners Court meeting dates and locations into a calendar or scheduling integration
| 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 Harris County have an official developer API?+
What vote breakdown fields does get_election_results return?+
contests array includes candidate names alongside separate vote counts for absentee, early voting, and election day balloting, plus percentage values. The ec field echoes back the election code and edt gives the election date, so you can associate results with a specific race and cycle without additional lookups.Does get_county_services return all service types in a single call?+
service_type parameter selects one category per request (e.g. 'Parks' or 'Senior_Centers'). The response includes count and a services array scoped to that type, with limit and offset for pagination. If you need multiple facility types, issue a separate call for each service_type value.