drought.national_stats
mock data$0.001 / callUS National Drought Statistics
Retrieve weekly US national drought statistics from the USDA/NOAA US Drought Monitor for a date range. Returns drought coverage by severity level (D0 Abnormally Dry through D4 Exceptional Drought) for CONUS and the total US (including Alaska/Hawaii/territories), reported as either square miles ("area") or percent of total land area ("percent"). Choose "cumulative" statistics_type to see how much area is in each level or worse (D1 includes D2+D3+D4); choose "categorical" for non-overlapping, mutually exclusive counts. Data is published weekly on Tuesdays — dates automatically snap to the nearest valid release. Maximum query window: 1 year. Useful for climate risk analysis, agricultural planning, and drought trend monitoring.
Input schema
Measurement unit: "area" returns drought coverage in square miles (default); "percent" returns drought coverage as a percentage of total US land area.
End date for the query range in YYYY-MM-DD format (e.g. "2024-01-08"). Maximum range is 1 year from start_date.
Start date for the query range in YYYY-MM-DD format (e.g. "2024-01-01"). USDM publishes weekly on Tuesdays; dates snap to the nearest release.
How drought levels are counted: "cumulative" (default) means each D-level includes worse levels (D1 includes D1+D2+D3+D4); "categorical" means each level is non-overlapping and mutually exclusive.
Call via REST
curl -X POST https://unifyapi.pro/api/call/drought.national_stats \
-H "Authorization: Bearer uak_live_..." \
-H "Content-Type: application/json" \
-d '{"metric":"<metric>","end_date":"<end_date>","start_date":"<start_date>","statistics_type":"<statistics_type>"}'