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
Parameters are passed using a GET request with a combination of path and optional query parameters. Accepted values are defined in the table below.
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}
The {begYear} and {endYear} parameters are optional. If they are not included, the entire period of record is returned.
https://www.ncei.noaa.gov/access/monitoring/climate-at-a-glance/{scope}/time-series/{region}/{parameter}/{surface}/{timescale}/{month}/data.{format}
Query Parameters
An optional query component may follow at the end of the URL path, preceded by a question-mark ?
, in the form of key=value
pairs, and separated by an ampersand &
.
…?{basePeriod}=[true|false]&{basePeriodBegYear}=[year]&{basePeriodEndYear}=[year]
Note: A base period is used to calculate anomalies based on the average of the requested period. basePeriod is not applicable to Global Average Temperature Anomalies (parameter = tavg) since base periods are fixed for each region.
See Data Info.
Request Parameter |
Type |
Description |
scope |
String |
|
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)
arctic
Arctic (land_ocean)
antarctic
Antarctic (land_ocean)
coords
Enter Coordinates (land_ocean)
|
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).
|
parameter |
String |
tavg
Average Temperature Anomaly
|
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
|
basePeriodBegYear |
Integer |
4-digit year (must be less than or equal to basePeriodEndYear)
1850-2025
Average Temperature Anomaly
|
basePeriodEndYear |
Integer |
4-digit year (must be greater than or equal to basePeriodBegYear)
1850-2025
Average Temperature Anomaly
|