U.S. Drought Monitor

Web Service Information

The U.S. Drought Monitor statistics are available through a set of REST services. The information below describes how to use these services. If you have any questions about the services, feel free to contact us.

Comprehensive Statistics


Comprehensive statistics include values for None and D0-D4 for each week for the selected area(s)

URL Structure

Use the following structure for the URL:

https://usdmdataservices.unl.edu/api/[area]/[statistics type]?aoi=[aoi]&startdate=[start date]&enddate=[end date]&statisticsType=[statistics type]

An explanation of each of the variables in the above URL is given below.

Area

The following areas are available:

National = USStatistics

USDA Climate Hubs = ClimateHubStatistics

Regional Drought Early Warning Systems (RDEWS) = RDEWSStatistics

Counties = CountyStatistics

States = StateStatistics

National Weather Service Weather Forecast Offices (WFOs) = WeatherForecastOfficeStatistics

U.S. Army Corps of Engineers Districts = USACEDistrictStatistics

U.S. Army Corps of Engineers Divisions = USACEDivisionStatistics

U.S. Urban Areas = UrbanAreaStatistics

River Forecast Centers = RiverForecastCenterStatistics

Regional Climate Center Regions = RegionStatistics

National Weather Service Regions = NWSRegionStatistics

Hydrologic Units (HUCs) = HUCStatistics

FEMA Regions = FEMARegionStatistics

Climate Divisions = ClimateDivisionStatistics

Statistics Type

Area = GetDroughtSeverityStatisticsByArea

Percent of Area = GetDroughtSeverityStatisticsByAreaPercent

Population = GetDroughtSeverityStatisticsByPopulation

Percent of Population = GetDroughtSeverityStatisticsByPopulationPercent

Area of Interest

Select a specific area within the type of area (i.e. a single state or county).

Parameter = aoi

AOI Values

National

  • Use us for both the continental U.S. and total U.S.
  • Use conus for the continental U.S. only
  • Use total for the total U.S.

USDA Climate Hubs

  • The climate hubs use an ID number
    • California = 12
    • Caribbean = 8
    • Midwest = 5
    • Northeast = 4
    • Northern Forests = 11
    • Northern Plains = 3
    • Northwest = 9
    • Southeast  = 1
    • Southern Plains = 7
    • Southwest = 2
    • Southwest including Hawaii = 10

Regional Drought Early Warning Systems (RDEWS)

  • Each RDEWS has been assigned an ID number
    • ACF River Basin = 1
    • California-Nevada = 2
    • Coastal Carolinas = 3
    • Midwest = 4
    • Pacific Northwest = 5
    • Upper Colorado River Basin = 6
    • Missouri River Basin = 7
    • Southern Plains = 8
    • Four Corners = 9
    • Hopi = 10
    • Navajo = 11
    • Northeast = 23

Counties

  • Use the county’s five digit FIPS code

State

  • Use the state’s two digit FIPS code

National Weather Service Weather Forecast Offices (WFOs)

  • Use the three letter code for each WFO

U.S. Army Corps of Engineers Districts

  • Use the three letter code for each district

U.S. Army Corps of Engineers Divisions

  • Use the three letter code for each district

Urban Areas

  • Use the geo ID for each urban area

River Forecast Centers

  • Use the RFC code (i.e. CBRFC = Colorado Basin RFC)

Regional Climate Center Regions

  • The regions are identified by an ID number
    • High Plains = 4
    • Midwest = 1
    • Northeast = 2
    • South = 5
    • Southeast = 3
    • West = 6

National Weather Service Regions

  • Use the NWS region’s two letter code (i.e. CR for Central Region)

Hydrologic Units (HUCs)

  • Use the HUC ID number (for 2, 4, 6 and 8 digit)

FEMA Regions

  • Use the region’s number

Climate Divisions

  • Use the climate division’s ID number

Dates

Start Date = startdate

End Date = enddate

Use the following date format M/D/YYYY

Statistics Format

Choose between traditional or categorical statistics. Use a value of 1 for traditional or 2 for categorical.

Parameter = statisticsType

Output Format

By default the data are output in XML format. You can specify an output format in the "request" " accept" header. The format options are XML, CSV, and JSON.

Example

If a person wanted to obtain statistics for the total area in drought for both the continental U.S. and the total U.S. between the dates of January 1st, 2012 and January 1st, 2013 in traditional format, the URL would look like the following:

https://usdmdataservices.unl.edu/api/USStatistics/GetDroughtSeverityStatisticsByArea?aoi=us&startdate=1/1/2012&enddate=1/1/2013&statisticsType=1