cdsapi

For a more detailed description on how to use the cdsapi, please visit: https://cds.climate.copernicus.eu/how-to-api

Install

Install via pip with:

$ pip install cdsapi

Configure

Get your Personal Access Token from your profile on the CDS portal at the address: https://cds.climate.copernicus.eu/profile and write it into the configuration file, so it looks like:

$ cat ~/.cdsapirc
url: https://cds.climate.copernicus.eu/api
key: <PERSONAL-ACCESS-TOKEN>

Remember to agree to the Terms and Conditions of every dataset that you intend to download.

Test

Perform a small test retrieve of ERA5 data:

$ python
>>> import cdsapi
>>> cds = cdsapi.Client()
>>> cds.retrieve('reanalysis-era5-pressure-levels', {
           "variable": "temperature",
           "pressure_level": "1000",
           "product_type": "reanalysis",
           "date": "2017-12-01/2017-12-31",
           "time": "12:00",
           "format": "grib"
       }, 'download.grib')
>>>

License

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

In applying this licence, ECMWF does not waive the privileges and immunities granted to it by virtue of its status as an intergovernmental organisation nor does it submit to any jurisdiction.

Release files for cdsapi 0.7.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cdsapi 0.7.7
File	Size	Uploaded
cdsapi-0.7.7.tar.gz	13.3 kB	Sep 30, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for cdsapi 0.7.7
File	Interpreter	ABI	Platform	Reset
cdsapi-0.7.7-py2.py3-none-any.whl 12.3 kB Sep 30, 2025	Python 3, Python 2	none	any	Details

Total release size: 25.6 kB

Release files / cdsapi-0.7.7.tar.gz

Download URL	cdsapi-0.7.7.tar.gz
Size	13.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`bc0cf807c1b78aceba6a11c3a5180f885f47f71a4e58205e324cfedcee16f10b`
BLAKE2b-256 checksum How to use checksums	`55f36cb5b4bf077c441978c5d5be3a568d37e1f07f3e7177a17fa66aec2594b6`
Upload date	Sep 30, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Release files / cdsapi-0.7.7-py2.py3-none-any.whl

Download URL	cdsapi-0.7.7-py2.py3-none-any.whl
Size	12.3 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`384c1658572d6dc53f4111f6dd46fcdfe6fea54a688af9756d71f6fe9118b66d`
BLAKE2b-256 checksum How to use checksums	`4ff44a65460d5cb6784128019fd707a87993f378db25e796eba01400a0903f62`
Upload date	Sep 30, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.7`