County Time Series
County Data come from the U.S. Climate Divisional Database, which have data from 1895 to the present for the CONUS, 1925 - present for Alaska, and 1991 - present for Hawaii.
County Time Series Data Service API
Overview
A RESTful application programming interface (API) is available to access Climate at a Glance data. The API can format desired data as comma-separated values (CSV), JavaScript Object Notation (JSON), and Extensible Markup Language (XML). The Data Service is only available via HTTP Strict Transport Security (HSTS) following Federal government policy.
Request Endpoint Parameters
Accepted values are defined in the table below.
Required Parameters
Required parameters are passed as path parameters.
https://www.ncei.noaa.gov/
Optional Parameters
Optional parameters are passed using a GET request. This an optional query component which follows the path, preceded by a question-mark ?
, in the form of key=value
pairs, and separated by an ampersand &
.
โฆ?{basePeriod}=[true|false]&{begBaseYear}=[year]&{begBaseYear}=[year]
Request Parameter | Type | Description |
---|---|---|
scope | String |
Accepted Values
national
National
regional
Regional
statewide
Statewide
divisional
Divisional
county
County
city
City
|
location | String |
Accepted surface values in parentheses
Accepted Values
|
parameter | String |
Accepted Values
|
surface/ |
String |
Accepted Values
|
timescale | Integer, String |
Accepted Values
1-60
Number of Months
ytd
Year to Date
|
month | Integer |
Accepted Values
1-12
January-December
0
All Months
|
startYear | Integer |
4-digit year (must be less than or equal to endYear)
Accepted Values
|
endYear | Integer |
4-digit year (must be greater than or equal to startYear)
Accepted Values
|
format | String |
Accepted Values
csv
Comma-Separated Values
json
JavaScript Object Notation
xml
Extensible Markup Language
|
basePeriod | Boolean |
Accepted Values
true
Return anomalies based on the requested base period mean
false
Return no anomalies
|
begBaseYear | Integer |
4-digit year (must be less than or equal to endBaseYear)
Accepted Values
|
endBaseYear | Integer |
4-digit year (must be greater than or equal to begBaseYear)
Accepted Values
|

Citing This Page
- NOAA National Centers for Environmental information, Climate at a Glance: County Time Series, published February 2025, retrieved on February 23, 2025 from https://www.ncei.noaa.gov/access/monitoring/climate-at-a-glance/county/time-series