Public API

Climate data

There are seven factors in focus. Four atmospheric greenhouse gases: carbon dioxide (co2), methane (ch4), sulfur hexafluoride (sf6), dinitrogen oxide (n2o), global temperatures, global ocean levels and finally condition of Greenland's and Antarctica's glaciers. Within each of the factors you will find multiple sets of data, usually based on data scope: monthly, weekly or annual data, some datasets are available for global values and values calculated for Mauna Loa Observatory Hawaii separately.

Data is read from ftp servers or obtained within a NASA's EarthData program, parsed and saved into database for unlimited access. Update schedule runs in relation to data scope and source data publications. That ensures both: that values are up to date and that no excessive traffic is generated at the source.

More on data

Documentation


Request

Response

Endpoints:

carbon dioxide CO2

methane CH4

sulfur hexafluoride SF6

nitrous oxide N2O

sea levels

glaciers

temperatures

Request structure

Send a GET request to one of supported endpoints. Endpoints are structured like so:

<ROOT_ENDPOINT> / :factor / :query
Examples:
https://climatemonitor.info/api/public/v1/co2/daily
https://climatemonitor.info/api/public/v1/ch4/monthly
https://climatemonitor.info/api/public/v1/temperatures/annual
https://climatemonitor.info/api/public/v1/glaciers/greenland
https://climatemonitor.info/api/public/v1/co2/for/2015-04-01
https://climatemonitor.info/api/public/v1/co2/for/2018

Root endpoint

Root endpoint is bound to API version. Current latest endpoint:

https://climatemonitor.info/api/public/v1

After significan updates new endpoints will be introduced. For sake of dependant applications all legacy endpoints will be maintained.

Factor

There are currently 7 climate factors availaible: levels of 4 greenhouse gases, global temperature anomalies, ocean mass anomalies and glaciers mass loss.

<ROOT_ENDPOINT>/co2/:query
<ROOT_ENDPOINT>/ch4/:query
<ROOT_ENDPOINT>/sf6/:query
<ROOT_ENDPOINT>/n2o/:query
<ROOT_ENDPOINT>/temperatures/:query
<ROOT_ENDPOINT>/ocean/:query
<ROOT_ENDPOINT>/glaciers/:query

Query - get full dataset

Depending on datasets availaible for chosen FACTOR all available endpoints

<ROOT_ENDPOINT>/:factor /daily
<ROOT_ENDPOINT>/:factor /monthly
<ROOT_ENDPOINT>/:factor /annual
<ROOT_ENDPOINT>/:factor /annual_ml
<ROOT_ENDPOINT>/:factor /monthly_gl
Examples:
https://climatemonitor.info/api/public/v1/ch4/monthly
https://climatemonitor.info/api/public/v1/co2/latest
https://climatemonitor.info/api/public/v1/co2/monthly_ml
https://climatemonitor.info/api/public/v1/ocean/levels

Query - get single value

Query structure:

/for/<DATE>

Depending on availaible datasets:


daily value:

/for/YYYY-MM-DD

monthly average:

/for/YYYY-MM

annual average:

/for/YYYY
Examples:
https://climatemonitor.info/api/public/v1/co2/for/2018-05-12
https://climatemonitor.info/api/public/v1/co2/for/2012

Response structure

Response from API is provided in JSend format with possible outcomes: success, fail and error.

Success response

Requested data is always provided in data object

{
  status:"success",
  data: {
    label:"2012-09-03",
    value: 389.43,
    unit:"ppm",
  }
}

Response containing full dataset:

{
  status:"success",
  data: {
    title:"Annual co2 Mauna Loa Observatory",
    description:"Annual mean atmospheric carbon dioxide, expressed...",
    readings: [
      {
        label:"2010-01-01",
        value: 389.43,
      },

    // full dataset (...)

      {
        label:"2021-07-23",
        value: 416.43,
      },
    ],
    unit: "ppm",
    lastUpdate: "2021-07-24T18:24:25.789Z",
  }
}

Fail response

Response status 4xx, client-side errors, e.g. invalid request:

{
  status:"fail",
  message:"Requested date is outside of dataset scope: 2011-01-01 - 2021-04-26",
}

Error response

Response status 5xx, server-side errors:

{
  status:"error",
  message:"Internal server error ;)",
}

All availaible endpoints

Earth atmospheric CO2

Latest available daily CO2 reading from Mauna Loa Observatory, Hawaii:

https://climatemonitor.info/api/public/v1/co2/latest

Earth daily CO2:

https://climatemonitor.info/api/public/v1/co2/daily

Earth CO2 weekly average from Mauna Loa Observatory, Hawaii:

https://climatemonitor.info/api/public/v1/co2/weekly_ml

Earth CO2 weekly global average:

https://climatemonitor.info/api/public/v1/co2/weekly_gl

Earth CO2 monthly average from Mauna Loa Observatory, Hawaii:

https://climatemonitor.info/api/public/v1/co2/monthly_ml

Earth CO2 monthly global average:

https://climatemonitor.info/api/public/v1/co2/monthly_gl

Earth CO2 annual global average:

https://climatemonitor.info/api/public/v1/co2/annual_gl

Earth CO2 annual average from Mauna Loa Observatory, Hawaii:

https://climatemonitor.info/api/public/v1/co2/annual_ml

Annual global CO2 increase:

https://climatemonitor.info/api/public/v1/co2/increase_gl

Annual CO2 increase, Mauna Loa Observatory, Hawaii:

https://climatemonitor.info/api/public/v1/co2/increase_ml

Earth CO2 reading for the date:

https://climatemonitor.info/api/public/v1/co2/for/2016-04-10

Earth CO2 monthly average:

https://climatemonitor.info/api/public/v1/co2/for/2016-04

Earth CO2 annaul average:

https://climatemonitor.info/api/public/v1/co2/for/2016

Earth atmospheric methane CH4

Monthly global atmospheric CH4:

https://climatemonitor.info/api/public/v1/ch4/monthly

Annual global atmospheric CH4:

https://climatemonitor.info/api/public/v1/ch4/annual

Annual atmospheric CH4 growth rate:

https://climatemonitor.info/api/public/v1/ch4/growth

Earth atmospheric sulfur hexafluoride SF6

Monthly global atmospheric SF6:

https://climatemonitor.info/api/public/v1//sf6/monthly

Annual global atmospheric SF6:

https://climatemonitor.info/api/public/v1/sf6/annual

Annual atmospheric SF6 growth rate:

https://climatemonitor.info/api/public/v1/sf6/growth

Earth atmospheric dinitrogen oxide N20

Monthly global atmospheric N20:

https://climatemonitor.info/api/public/v1/n2o/monthly

Annual global atmospheric N20:

https://climatemonitor.info/api/public/v1/n2o/annual

Annual atmospheric N20 growth rate:

https://climatemonitor.info/api/public/v1/n2o/growth

Global ocean levels

Global ocean mass:

https://climatemonitor.info/api/public/v1/ocean/mass

Ocean level variation:

https://climatemonitor.info/api/public/v1/ocean/level

Arctica and Antarctica mass loss

Antarctica ice mass:

https://climatemonitor.info/api/public/v1/glaciers/antarctica

Greenland ice mass:

https://climatemonitor.info/api/public/v1/glaciers/greenland

Temperatures

Average annual land surface temperature anomaly:

https://climatemonitor.info/api/public/v1/temp/annual_anomaly_min
https://climatemonitor.info/api/public/v1/temp/annual_anomaly_avg
https://climatemonitor.info/api/public/v1/temp/annual_anomaly_max

Annual land and ocean combined temperature anomaly:

https://climatemonitor.info/api/public/v1/temp/annual_anomaly_loc

Average monthly land surface temperature anomaly:

https://climatemonitor.info/api/public/v1/temp/monthly_anomaly_min
https://climatemonitor.info/api/public/v1/temp/monthly_anomaly_avg
https://climatemonitor.info/api/public/v1/temp/monthly_anomaly_max

Monthly land and ocean combined temperature anomaly:

https://climatemonitor.info/api/public/v1/temp/monthly_anomaly_loc

Average daily land surface temperature anomaly (last ten years):

https://climatemonitor.info/api/public/v1/temp/daily_min
https://climatemonitor.info/api/public/v1/temp/daily_avg
https://climatemonitor.info/api/public/v1/temp/daily_max
polar bear
climatemonitor © 2022