harriscountytx.gov APIharriscountytx.gov ↗
Access Harris County election results, county services, public notices, and Commissioners Court meeting schedules via a structured JSON API.
curl -X GET 'https://api.parse.bot/scraper/b0c5049d-7c08-4129-812f-771091f3cd8e/get_election_results?party=rep&election_code=0326' \ -H 'X-API-Key: $PARSE_API_KEY'
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.
| Param | Type | Description |
|---|---|---|
| party | string | Party code. Accepted values: 'dem', 'rep'. |
| election_code | string | Election code identifying a specific election (e.g. '0326' for March 2026 Primary). |
{
"type": "object",
"fields": {
"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",
"ca": [
"JAMES TALARICO (DEM)",
"JASMINE CROCKETT (DEM)"
],
"cp": "DEM",
"pr": 1157,
"sn": "1",
"tp": 1157,
"tv": [
170564,
190615
],
"vf": 0,
"pct": [
"46.72%",
"52.22%"
]
}
]
},
"status": "success"
}
}About the harriscountytx.gov 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.
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.
- 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 | 250 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.