realestate-us — US rentals, AMI tables and utility allowances — openbash
Rental listings merged across sources, plus the HUD tables that decide what a subsidised rent may be.
realestate-us
realestate-us is a command on the openbash shell, reachable over HTTP, SSH and MCP with one key. It composes with the other programs through pipes; there is no per-program endpoint and no schema for the join.
realestate-us ami-rents CA --county Alameda
help
realestate-us: listings and the tables that bound them, as JSON.
RETURNS
One JSON object on stdout.
OPTIONS
A study run with no arguments prints its own — `realestate-us search` on a
line by itself lists every flag it takes. Worth doing once per study: the
flags are where the defaults are, and a default is a decision somebody made
for you.
START HERE
`ami-years` before assuming a year exists. The tables are published per
state and per year, and a missing year is not an empty answer, it is a
different question.
INDIA IS A DIFFERENT PROGRAM
`realestate-in`, and deliberately not a subcommand of this one. There is no
AMI band there for a rent to be measured against, and no ZIP to search by;
the answers come from different vendors at a different price. A program that
sold both sold half of itself to everybody.
Studies:
search <zip_code>
rental listings in one ZIP, merged across sources
detail <comp_key>
everything known about one listing, by its comp key
harvest <zips>
pull several ZIPs into the store at once — comma-separate them
ami-rents <state>
maximum rents by AMI percent and bedroom count
ami-income-limits <state>
income limits by AMI percent and household size
ami-counties <state>
which counties a state has AMI tables for
ami-years <state>
which years a state has AMI tables for — check this before assuming one
utility-allowance <state>
utility allowance schedules, which set what rent a voucher actually covers
JSON to stdout, so it composes: pipe to `jq` to pick a field, or `> /tmp/…` to keep it.
Run a study with no arguments — `realestate-us search` — to see what it takes.
What it answers
realestate-us search — rental listings in one ZIP, merged across sources realestate-us detail — everything known about one listing, by its comp key realestate-us harvest — pull several ZIPs into the store at once — comma-separate them realestate-us ami-rents — maximum rents by AMI percent and bedroom count realestate-us ami-income-limits — income limits by AMI percent and household size realestate-us ami-counties — which counties a state has AMI tables for realestate-us ami-years — which years a state has AMI tables for — check this before assuming one realestate-us utility-allowance — utility allowance schedules, which set what rent a voucher actually covers