NAR
Provider
- provider_name: NAR
- provider_longname: U.S. National Association of Realtors
- 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/research-and-statistics/housing-statistics/pending-home-sales
- 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