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/access/monitoring/climate-at-a-glance/global/time-series/{region}/{parameter}/{surface}/{timescale}/{month}/{begYear}-{endYear}/data.{format}
Optional Parameters
Note: not applicable to Average Temperature Anomalies (parameter = tavg)
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 |
region |
String |
Accepted surface values in parentheses
globe
Global (land, ocean, land_ocean)
nhem
Northern Hemisphere (land, ocean, land_ocean)
shem
Southern Hemisphere (land, ocean, land_ocean)
northAmerica
North America (land)
southAmerica
South America (land)
gulfOfAmerica
Gulf of America (land_ocean)
arctic
Arctic (land_ocean)
antarctic
Antarctic (land_ocean)
coords
Enter Coordinates (land_ocean)
|
parameter |
String |
tavg
Average Temperature Anomaly
|
surface/coordinates* |
String |
land_ocean
Land and Ocean
[-90 - 90],[-180 - 180]
Latitude and Longitude*
*If 'coords' is entered for region, use comma separated latitude (between -90.0 and 90.0) and longitude (between -180.0 and 180.0) with no spaces (e.g., 30.4,84.3).
|
timescale |
Integer, String |
|
month |
Integer |
|
startYear |
Integer |
4-digit year (must be less than or equal to endYear)
1850-2025
Average Temperature Anomaly
|
endYear |
Integer |
4-digit year (must be greater than or equal to startYear)
1850-2025
Average Temperature Anomaly
|
format |
String |
csv
Comma-Separated Values
json
JavaScript Object Notation
xml
Extensible Markup Language
|
basePeriod |
Boolean |
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)
1850-2025
Average Temperature Anomaly
|
endBaseYear |
Integer |
4-digit year (must be greater than or equal to begBaseYear)
1850-2025
Average Temperature Anomaly
|