# HCAD Harris County Property-Tax API

Assessment-protest outcomes and per-parcel value history for every Harris County, Texas parcel. No owner names.

Harris County (Houston) publishes its appraisal roll only as bulk annual downloads with no per-parcel API and no protest-outcome data. This API adds both: for one parcel, every ARB hearing with the value before the protest and the value after, plus the assessed-value series. Owner names and mailing addresses are dropped at ingest and never served.

- Coverage: 1.6 million parcels; protest outcomes 2005-2026, values 2015-2026
- Source: Harris County Appraisal District — Texas public record (Tex. Gov't Code ch. 552; Tex. Tax Code 25.027)
- API root: https://hcad-api.canvas-cart.workers.dev
- Machine guide: https://hcad-api.canvas-cart.workers.dev/llms.txt
- Record ids: a 13-digit HCAD account number, e.g. "0010090000001"; get it from /search?addr=

## Routes

- `GET /search?addr=<street>&limit=<n>` — free
- `GET /parcel/{acct}` — free
- `GET /parcel/{acct}/history` — paid ($0.02)
- `GET /parcel/{acct}/protests` — paid ($0.03)
- `GET /area/{neighborhood}/protest-stats` — paid ($0.05)

## Free search example

https://hcad-api.canvas-cart.workers.dev/search?addr=COMMERCE+ST&limit=3

## Paid call

Request `/parcel/{acct}/protests`. Expect `402 Payment Required` with price $0.02-$0.05 per call, network eip155:8453, asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (USDC), payout 0xA40Dadc75B69bEe8325E8089258235213293F8F4. Pay, repeat, receive the record.

Sample paid URL: https://hcad-api.canvas-cart.workers.dev/parcel/0010090000001/protests