Time series · drought-county
County drought categories
Weekly percent of each US county's area in each US Drought Monitor category over the last 400 days: none, D0 abnormally dry, D1 moderate, D2 severe, D3 extreme and D4 exceptional drought. The categories don't overlap and add up to 100.
- Updates
- Weekly
- Coverage
- —
- Current version
- —
- Last published
- —
- Validation
- —
- License
- USDM terms (credit required)
- Commercial use
- Allowed
Chart
Use the API
Each series and location is its own small file. The examples follow the series and location picked above. See the docs for versions, caching and errors.
curl
# One series for one place (.json or .csv)
curl -s "https://api.waterdata.dev/v1/drought-county/area/us-county-06037.json"
# Every series and place in one file
curl -sO "https://api.waterdata.dev/v1/drought-county/download/drought-county.csv"Python (polars)
import polars as pl
# One series for one place
df = pl.read_csv("https://api.waterdata.dev/v1/drought-county/area/us-county-06037.csv")
# Every series and place, with series and location columns
everything = pl.read_parquet("https://api.waterdata.dev/v1/drought-county/download/drought-county.parquet")JavaScript
const res = await fetch("https://api.waterdata.dev/v1/drought-county/area/us-county-06037.json");
if (!res.ok) throw new Error((await res.json()).detail); // errors are problem+json
const { meta, data } = await res.json();
console.log(meta.location_name, data.at(-1)); // { date, value, ... }Downloads
The whole dataset in one file, with series and location columns. Parquet keeps the column types and is much smaller.
- drought-county.csv CSV
- drought-county.parquet Parquet
Schema and series
Each series file has these columns. The bulk downloads add series and location columns in
front.
| Column | Type | Unit | Can be empty | Description |
|---|---|---|---|---|
| date | date (YYYY-MM-DD) | — | no | The map's valid date (a Tuesday); USDM releases it two days later |
| none | number | percent | no | Not in any category |
| d0 | number | percent | no | D0 abnormally dry (only) |
| d1 | number | percent | no | D1 moderate drought (only) |
| d2 | number | percent | no | D2 severe drought (only) |
| d3 | number | percent | no | D3 extreme drought (only) |
| d4 | number | percent | no | D4 exceptional drought |
Series
| Series id | Name |
|---|---|
| area | Percent of county area by drought category |
Locations
Covers all 3,222 US counties and equivalents (ids: us-county- plus the 5-digit FIPS code).
Place names come from the shared location registry; see Sources.
Source and license
- Source
- U.S. Drought Monitor county statistics (categorical percent of area)
- Publisher
- National Drought Mitigation Center, University of Nebraska-Lincoln
- License
- US Drought Monitor terms: free to use with credit (
LicenseRef-USDM-Credit-Required) - Commercial use
- Allowed
Credit the source with this exact text:
The U.S. Drought Monitor is jointly produced by the National Drought Mitigation Center at the University of Nebraska-Lincoln, the United States Department of Agriculture, the National Oceanic and Atmospheric Administration and the National Aeronautics and Space Administration. Map courtesy of NDMC.
Checked every 1 day. If the source hasn't changed in 15 days, the status page flags it as stale.
Endpoints
Every URL for this dataset. To pin the current version, put it after the id:
/v1/drought-county@<version>.
The API reference describes each response.
| What | URL |
|---|---|
| Metadata: version, coverage, downloads, validation | /v1/drought-county |
| Versions and monthly snapshots | /v1/drought-county/versions |
| Series and locations | /v1/drought-county/locations |
| Percent of county area by drought category (JSON) | /v1/drought-county/area/{location}.json |
| Percent of county area by drought category (CSV) | /v1/drought-county/area/{location}.csv |
| Whole dataset (CSV) | /v1/drought-county/download/drought-county.csv |
| Whole dataset (Parquet) | /v1/drought-county/download/drought-county.parquet |