Please cite this package using:

Tam E, Reilly A, Ghaedi H, Jin S (2022). rhud: A R Interface to the HUD
      (US Department of Housing and Urban Development) APIs. 0.3.0.9000,
      https://github.com/etam4260/rhud/.

Are you a python developer? Check out hudpy instead.

This interface uses the HUD User Data API but is not endorsed or certified by HUD User

rhud main functionality is to help with the task of spatially allocating data associated with ZIP codes to and from other well-known geographic regions such as counties, congressional districts, metroareas, metroarea divisions, and census tracts.

rhud includes access to the USPS Crosswalk Files, Fair Markets Rent, Income Limits, and Comprehensive Housing and Affordability Strategy dataset APIs.

Please read https://www.huduser.gov/portal/dataset/api-terms-of-service.html for all terms of service.

According to HUD USER:

All services, which utilize or access the API, should display the following notice prominently within the application: “This product uses the HUD User Data API but is not endorsed or certified by HUD User.” You may use the HUD User name in order to identify the source of API content subject to these rules. You may not use the HUD User name, or the like to imply endorsement of any product, service, or entity, not-for-profit, commercial or otherwise.

According to (HUD User Home Page | HUD USER), HUD User is a U.S. Department of Housing and Urban Development information source that includes reports and reference documents. HUD USER was founded in 1978 by the Department of Housing and Urban Development’s Office of Policy Development and Research.

HUD User maintains an API to gain access to their data. However, their API system can be confusing and provides their information in JSON format rather than a data-frame like object. Although there exist file downloadables, R users may want to be able to extract specific bits of the data into memory.

You can install the development version from GitHub with:

# install.packages("devtools")
devtools::install_github("etam4260/rhud")

For more details on how to setup and utilize this package. Please go to https://etam4260.github.io/rhud/. Select [Setup] in the navigation bar.

To use functions provided by this package, you need to get access HUD USER via token. Go to https://www.huduser.gov/hudapi/public/login to register for an account and then create a token with access to all datasets provided by HUD. This will include selecting USPS Crosswalk, Fair Markets Rent, Income Limits, and Comprehensive Housing Affordability Strategy.

Now copy and paste that key into the hud_set_key() function to be used throughout your R session.

hud_set_key("sample-key")

This sample provided below shows how to query the USPS Crosswalk API

hud_cw_zip_tract(zip = '35213', year = c('2010'), quarter = c('1'))

The APIs and datasets which this library interfaces are listed below. The HUD also provide miscellaneous supplemental APIs under them.

1. HUD User

• USPS Crosswalk

• Fair Markets Rent
  • Small Areas Fair Markets Rent

• Income Limits

• Comprehensive Housing and Affordability Strategy

• US Geographic Entities

• Key access

• Caching

• Utilities

• Emmet Tam(https://github.com/etam4260)[[email protected]]

• Allison Reilly[[email protected]]

• Hamed Ghaedi[[email protected]]

• Shuyu Jin(https://github.com/geojsy)[[email protected]]

• License: GPL >= 2

• To get citation information for rhud in R, type citation(package = ‘rhud’)

• This interface uses the HUD User Data API but is not endorsed or certified by HUD User.

• The limit on the maximum number of API calls is 1200 queries a min. Each function call does not correspond to a single API call!

• This is a WIP so please report any issues or bugs to: https://github.com/etam4260/rhud/issues

• This is open source, so please fork and introduce some pull requests!

HUD User Home Page: HUD USER. HUD User Home Page | HUD USER. (n.d.). Retrieved
        February 24, 2022, from https://www.huduser.gov/portal/home.html