What it returns
The Federal Housing Finance Agency's House Price Index from its official master file, for the United States, the nine census divisions, every state and 400+ metropolitan areas, one row per place and period, with the period-over-period and year-over-year change.
| field | meaning |. |---|---|. | `placeId`, `placeName`, `level` | where |. | `indexType`, `flavor`, `frequency` | which FHFA index |. | `year`, `period`, `periodLabel` | month (1-12) or quarter (1-4) |. | `indexNsa`, `indexSa` | index, not seasonally adjusted and seasonally adjusted (null where FHFA publishes no SA series) |. | `changePct` | % change from the previous period (seasonally adjusted where available) |. | `yoyPct` | % change from the same period a year earlier, not seasonally adjusted |. | `note`, `source` | FHFA's note and the master file |.
Request
POST https://api.pushbuild.com/fhfa-house-price-index/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
places | list of strings | USA, census division ids (e.g. DV_PAC), two-letter state codes, metro CBSA codes (e.g. 12420) or part of a metro name (4+ characters, e.g. Austin). Use ALL for every place at the chosen levels. Default: USA. |
levels | list of strings | Optional filter: USA or Census Division, State, MSA, Puerto Rico. |
flavor | string: purchase-only, all-transactions, expanded-data | purchase-only (sales prices), all-transactions (adds refinance appraisals, longest metro coverage) or expanded-data (adds county recorder and Enterprise data). Default: "purchase-only". |
indexType | string: traditional, non-metro, distress-free, manufactured, developmental | FHFA index type. Most series are traditional. Default: "traditional". |
frequency | string: auto, monthly, quarterly | auto returns monthly where FHFA publishes it (US and census divisions, purchase-only) and quarterly elsewhere. Default: "auto". |
lastN | integer | Most recent periods per place. Ignored when fromYear is set. Default: 12. |
fromYear | integer | Return every period from this year. Optional. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/fhfa-house-price-index/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"places": ["USA", "CA", "TX", "FL"], "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.16 per 1,000 index values. No charge for errors or empty searches.
Related APIs
Australian Bureau of Statistics API: CPI, Jobs, GDP & Any Dataflow API
Australian Bureau of Statistics data from the official ABS Data API: monthly CPI and trimmed mean, unemployment by state, GDP, wage price index and household spending presets, any ABS dataflow by SDMX key, and dataflow search.
Bank of Canada API: Policy Rate, CORRA, Bonds, CPI & CAD FX API
Bank of Canada statistics from its official Valet API: policy rate, CORRA, prime, T-bills, benchmark bond yields, mortgage and GIC rates, CPI and core CPI, commodity prices and daily CAD exchange rates.
Bank of England API: Bank Rate, SONIA, Gilts & Mortgages API
Bank of England statistics from its official database: Bank Rate, SONIA, gilt yields, implied inflation, mortgage rates and approvals, M4 money, lending and sterling FX.
BLS Data API: Any Bureau of Labor Statistics Series API
Any US Bureau of Labor Statistics time series by id (CPI, payrolls by industry, unemployment, wages, PPI, JOLTS, import prices) plus state unemployment and labor force from plain state codes, with month-over-month and year-over-year changes..
Bundesbank API: German Bund Yields, CPI & Euro FX Rates API
Deutsche Bundesbank statistics from its official time series API: German government bond yields (2, 5, 10 and 30 years, daily), German consumer price index and ECB euro reference rates.
Cboe Put/Call Ratios & VIX Futures Term Structure API
Daily Cboe options statistics: total, equity, index, SPX and VIX put/call ratios with call and put volume and open interest by product, plus the VIX futures curve with settlements, open interest and contango versus spot VIX..
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com