|
|
# NAR
|
|
|
|
|
|
## Provider
|
|
|
|
|
|
* **provider_name**: NAR
|
|
|
* **provider_longname**: National Realestate Association
|
|
|
* **provider URL**: https://www.nar.realtor
|
|
|
* **region**: US
|
|
|
* **terms of use**: https://www.nar.realtor/terms-of-use, https://www.nar.realtor/reprint-guidelines, but see https://www.nar.realtor/research-and-statistics/housing-statistics/existing-home-sales
|
|
|
* **approximate number of datasets**:
|
|
|
|
|
|
|
|
|
## Data accessibility
|
|
|
|
|
|
* **SDMX: (If yes, links and SDMX releases implemented**: ML 2.0, ML 2.1, JSON 2.1) else No
|
|
|
* **REST API**: (If yes, links doc and base URL api) else NO
|
|
|
* **Bulk Download: (if yes, links and formats**: csv, xls, sdmx, also indicate wheter they are zipped) else No
|
|
|
* **Account**: Yes if account (login/password) are requires for access to SDMX/REST API or Bulk Download
|
|
|
|
|
|
## Desired datasets
|
|
|
|
|
|
* **Description**: (brief description of subset that we want on Widukind
|
|
|
or list if less than 10)
|
|
|
|
|
|
|
|
|
## Data tree
|
|
|
|
|
|
* **Existence of a hierachy of datasets on web site**: yes
|
|
|
* **How to recover the information**: parse https://www.nar.realtor/research-and-statistics/housing-statistics
|
|
|
|
|
|
## Datasets
|
|
|
|
|
|
### Existing home sales
|
|
|
* **datasetCode**: ehs
|
|
|
* ** URL**: https://www.nar.realtor/sites/default/files/documents/ehs-05-2018-overview-2018-06-20.pdf
|
|
|
* **how to get release date**: part of the file name
|
|
|
* **dataset docHref**: https://www.nar.realtor/research-and-statistics/housing-statistics/existing-home-sales
|
|
|
* **dataset notes**: no
|
|
|
* **dimension_list**: region, seasonal adjustment, unit: (units, month supply for 'Supply')
|
|
|
* **use of attributes**: yes
|
|
|
* **attribute_list**: r: revised, p: preliminary
|
|
|
* **available frequencies**: annual, monthly
|
|
|
* **availability of previous updates**: no
|
|
|
* **existence of real time datasets**: no
|
|
|
|
|
|
## Series
|
|
|
|
|
|
* **Series key**: ehs_us_sa, ehs_ne_sa, ehs_mw_sa, ...., ehs_us_nsa, ..., invent, supply, speh_us_nsa, ..., speh_us_sa, ....
|
|
|
* **Series name**: existing home sales - us - seasonally adjusted annual rate
|
|
|
* **Series docHref**: no
|
|
|
* **Series notes**: yes for inventory
|
|
|
* **missing values**: '*'
|
|
|
* **date format**: aaaa, aaaa jan, aaaa feb, ....
|
|
|
* **mixed frequencies in the same dataset**: yes
|
|
|
* **Notes**: 'Mos supply' is the unsold inventory in month supply at current sales pace, ignore vs last month, vs last year
|
|
|
|
|
|
### Pending home sales index
|
|
|
* **datasetCode**: phsi
|
|
|
* ** URL**: https://www.nar.realtor/sites/default/files/documents/phs-04-2018-pending-home-sales-05-31-2018.pdf
|
|
|
* **how to get release date**: part of the file name
|
|
|
* **dataset docHref**: https://www.nar.realtor/sites/default/files/documents/phs-04-2018-pending-home-sales-05-31-2018.pdf
|
|
|
* **dataset notes**: no
|
|
|
* **dimension_list**: region, seasonal adjustment
|
|
|
* **use of attributes**: yes
|
|
|
* **attribute_list**: r: revised, p: preliminary
|
|
|
* **available frequencies**: annual, monthly
|
|
|
* **availability of previous updates**: no
|
|
|
* **existence of real time datasets**: no
|
|
|
|
|
|
## Series
|
|
|
|
|
|
* **Series key**: phsi_us_sa, phsi_ne_sa, phsi_mw_sa, ...., phsi_us_nsa
|
|
|
* **Series name**: pending home sales index - us - seasonally adjusted annual rate
|
|
|
* **Series docHref**: no
|
|
|
* **Series notes**: no
|
|
|
* **missing values**: '*'
|
|
|
* **date format**: aaaa, aaaa jan, aaaa feb, ....
|
|
|
* **mixed frequencies in the same dataset**: yes
|
|
|
* **Note**: ignore vs last month, vs last year
|
|
|
|
|
|
### Housing affordability index
|
|
|
* **datasetCode**: hai
|
|
|
* ** URL**: https://www.nar.realtor/sites/default/files/documents/hai-04-2018-housing-affordability-index-2018-06-08.pdf
|
|
|
* **how to get release date**: part of the file name
|
|
|
* **dataset docHref**: https://www.nar.realtor/research-and-statistics/housing-statistics/housing-affordability-index
|
|
|
* **dataset notes**: no
|
|
|
* **dimension_list**: region, seasonal adjustment
|
|
|
* **use of attributes**: yes
|
|
|
* **attribute_list**: r: revised, p: preliminary
|
|
|
* **available frequencies**: annual, monthly
|
|
|
* **availability of previous updates**: no
|
|
|
* **existence of real time datasets**: no
|
|
|
|
|
|
## Series
|
|
|
|
|
|
* **Series key**: use initials of series name
|
|
|
* **Series name**: Median priced existing single family home, ....
|
|
|
* **Series docHref**: no
|
|
|
* **Series notes**: yes
|
|
|
* **missing values**: no
|
|
|
* **date format**: aaaa, aaaa jan, aaaa feb, ....
|
|
|
* **mixed frequencies in the same dataset**: yes
|
|
|
* **Note**: ignore regional breakdown
|
|
|
|
|
|
|
|
|
## Updates
|
|
|
|
|
|
* **calendar of future updates**: yes on docHref page of each datasets
|
|
|
* **summary of previous updates**: no
|
|
|
* **regular updates**: no
|
|
|
* **RSS flow**: https://www.nar.realtor/rss-feeds
|
|
|
* **best way to monitor updates**: parse update date
|
|
|
|
|
|
## Special problems
|
|
|
|
|
|
(like variable names in ESRI)
|
|
|
|
|
|
## Other remarks
|
|
|
|
|
|
- The PDF files can be converted to ASCII with pdftotext (Debian package poppler-utils). Use -layout option
|
|
|
- See also https://github.com/deanmalmgren/textract and pdfminer.six
|
|
|
|
|
|
|