Skip to main content
Ctrl+K
 - Home

For Users

  • Getting Started
    • Why EODAG?
    • Features Overview
    • Installation
    • Product types
    • Product storage status
    • Configure EODAG
  • Featured providers
  • API User Guide
    • Providers and products
    • Configuration
    • Search
    • Queryables
    • Serialize/Deserialize
    • Crunch
    • Download
    • Post-process
    • STAC client
  • API Reference
    • EODataAccessGateway
    • SearchResult
    • EOProduct
    • Assets
    • Utils
    • Exceptions
    • Types
    • Call graphs
  • CLI User Guide
  • Migration guide
  • Tutorials
    • Search for products by tile
    • Get Copernicus DEM using EODAG
    • ECMWF API plugin for EODAG
    • Copernicus Atmosphere using ECMWFSearch plugin
    • The wekeo provider in EODAG
    • Get forecast data from meteoblue using EODAG
    • Sentinel-1 processing for ship detection (SNAP)
    • Sentinel-2 processing to get a burnt area map (Sen2Cor, SNAP, snappy)
    • DEDT Lumi through ECMWF Polytope API
    • Get data from fedeo_ceda using EODAG
  • EODAG-related projects

For Developers/Contributors

  • Add a Provider
  • Add a product type
  • Plugins
    • Search Plugins
      • eodag.plugins.search.qssearch.QueryStringSearch
      • eodag.plugins.search.qssearch.ODataV4Search
      • eodag.plugins.search.qssearch.PostJsonSearch
      • eodag.plugins.search.qssearch.StacSearch
      • eodag.plugins.search.qssearch.WekeoSearch
      • eodag.plugins.search.static_stac_search.StaticStacSearch
      • eodag.plugins.search.stac_list_assets.StacListAssets
      • eodag.plugins.search.cop_marine.CopMarineSearch
      • eodag.plugins.search.creodias_s3.CreodiasS3Search
      • eodag.plugins.search.build_search_result.ECMWFSearch
      • eodag.plugins.search.build_search_result.MeteoblueSearch
      • eodag.plugins.search.build_search_result.WekeoECMWFSearch
      • eodag.plugins.search.csw.CSWSearch
    • Crunch Plugins
      • eodag.plugins.crunch.filter_date.FilterDate
      • eodag.plugins.crunch.filter_latest_intersect.FilterLatestIntersect
      • eodag.plugins.crunch.filter_latest_tpl_name.FilterLatestByName
      • eodag.plugins.crunch.filter_overlap.FilterOverlap
      • eodag.plugins.crunch.filter_property.FilterProperty
    • Authentication Plugins
      • eodag.plugins.authentication.generic.GenericAuth
      • eodag.plugins.authentication.token.TokenAuth
      • eodag.plugins.authentication.header.HTTPHeaderAuth
      • eodag.plugins.authentication.aws_auth.AwsAuth
      • eodag.plugins.authentication.openid_connect.OIDCRefreshTokenBase
      • eodag.plugins.authentication.openid_connect.OIDCAuthorizationCodeFlowAuth
      • eodag.plugins.authentication.keycloak.KeycloakOIDCPasswordAuth
      • eodag.plugins.authentication.token_exchange.OIDCTokenExchangeAuth
      • eodag.plugins.authentication.qsauth.HttpQueryStringAuth
      • eodag.plugins.authentication.sas_auth.SASAuth
    • Download Plugins
      • eodag.plugins.download.http.HTTPDownload
      • eodag.plugins.download.aws.AwsDownload
      • eodag.plugins.download.creodias_s3.CreodiasS3Download
    • API Plugins
      • eodag.plugins.apis.usgs.UsgsApi
      • eodag.plugins.apis.ecmwf.EcmwfApi
  • Drivers
    • eodag.api.product.drivers.base.NoDriver
    • eodag.api.product.drivers.generic.GenericDriver
    • eodag.api.product.drivers.sentinel1.Sentinel1Driver
    • eodag.api.product.drivers.sentinel2.Sentinel2Driver
  • Parameters mapping
  • Contribute
  • Release history
  • GitHub Repository
  • Repository
  • Suggest edit
  • Open issue
  • .rst

Featured providers

Contents

  • AWS / GCS EO catalogs
    • Earth Search
      • earth_search
      • earth_search_gcs
    • aws_eos
  • Copernicus
    • Copernicus Data Stores
      • cop_ads
      • cop_cds
      • cop_dataspace
      • cop_ewds
      • cop_marine
    • sara
    • WEkEO
      • wekeo_main
      • wekeo_cmems
      • wekeo_ecmwf
    • CREODIAS
      • creodias
      • creodias_s3
  • CNES
    • GEODES
      • geodes
      • geodes_s3
    • hydroweb_next
    • peps
  • Destination Earth
    • DEDL
    • DEDT Lumi
  • ECMWF
  • ESA
    • fedeo_ceda
  • EUMETSAT
  • Meteoblue
  • Planetary Computer
  • USGS / Landsat
    • usgs
    • usgs_satapi_aws

Featured providers#

eodag connects you to a variety of Earth Observation (EO) data providers. This section introduces the featured providers that are already integrated, so you can easily start searching, accessing, and downloading products.

Some providers are completely open, while others require an account to access their data. If credentials are needed, check the registration guide for details.

EODAG is not limited to the providers listed here

If a desired provider is missing, you can add it yourself. See how to add a new provider for more details.


AWS / GCS EO catalogs#

Cloud-Native Earth Observation Data

These providers offer scalable access to satellite imagery through cloud infrastructure with global distribution.

Earth Search#

earth_search#

Element84 STAC API for data on AWS.

Registration info

Setup Requirements:

  • Create an account on AWS

  • Once the account is activated go to the identity access management console

  • Click on user, then on your user name and then on security credentials.

  • In access keys, click on create access key.

  • Add these credentials to the user configuration file.

Warning

Billing Alert

A credit card number must be provided when creating an AWS account because fees apply after a given amount of downloaded data.


earth_search_gcs#

Element84 Earth Search on Google Cloud Storage.

Registration info

You need HMAC keys for Google Cloud Storage:

  • Sign in using a google account.

  • Get or create HMAC keys for your user account on a project for interoperability API access from this page (create a default project if none exists).

  • Add these credentials to the user configuration file.


aws_eos#

EOS Data Analytics search for AWS public datasets.

Registration info

You need credentials for both EOS Data Analytics (search) and AWS (download):

  • Create an account on EOS

  • Get your EOS api key from here

  • Create an account on AWS

  • Once the account is activated go to the identity access management console

  • Click on user, then on your user name and then on security credentials.

  • In access keys, click on create access key.

  • Add these credentials to the user configuration file:

    • search_auth.credentials.api_key

    • download_auth.credentials.aws_access_key_id and download_auth.credentials.aws_secret_access_key or download_auth.credentials.aws_profile

Note

Usage Limits

EOS free trial account is limited to 1000 requests, see also their subscription plans.


Copernicus#

European Space Programme

The Copernicus programme provides free and open access to Earth observation data from the Sentinel satellite constellation and climate services.

Copernicus Data Stores#

cop_ads#

Copernicus Atmosphere Data Store.

Registration info

Go to the ECMWF homepage and create an account by clicking on Log in and then Register.

Then log in and go to your user profile on Atmosphere Data Store and use your Personal Access Token as apikey in eodag credentials.

To download data you have to accept the Licence to use Copernicus Products. To accept the licence:

  • Go to Datasets while being logged in.

  • Open the details of a dataset and go to the download tab.

  • Scroll down and accept the licence in the section Terms of use.

  • You can check which licences you have accepted in your user profile.


cop_cds#

Copernicus Climate Data Store.

Registration info

Go to the ECMWF homepage and create an account by clicking on Log in and then Register. Then log in and go to your user profile on Climate Data Store and use your Personal Access Token as apikey in eodag credentials.

To download data, you also have to accept certain terms depending on the dataset. Some datasets have a specific licence whereas other licences are valid for a group of datasets. For example after accepting the Licence to use Copernicus Products you can use all ERA5 datasets, to use the seasonal data from C3S you also have to accept the Additional licence to use non European contributions.

To accept a licence:

  • Search for the dataset you want to download here while being logged in.

  • Open the dataset details and go to the download tab.

  • Scroll down and accept the licence in the section Terms of use.

  • You can check which licences you have accepted in your user profile.


cop_dataspace#

Copernicus Data Space Ecosystem.

Registration info

Create an account here


cop_ewds#

CEMS Early Warning Data Store.

Registration info

Go to the ECMWF homepage and create an account by clicking on Log in and then Register. Then log in and go to your user profile on CEMS Early Warning Data Store and use your Personal Access Token as apikey in eodag credentials.

To download data, you also have to accept certain terms depending on the dataset. There are two different licences that have to be accepted to use the CEMS EWDS datasets. Accepting the CEMS-FLOODS datasets licence is necessary to use the GLOFAS and EFAS datasets, the Licence to use Copernicus Products is valid for the Fire danger datasets.

To accept a licence:

  • Search for the dataset you want to download here while being logged in.

  • Open the dataset details and go to the download tab.

  • Scroll down and accept the licence in the section Terms of use.

  • You can check which licences you have accepted in your user profile.


cop_marine#

Copernicus Marine Service.

No credentials are needed


sara#

Sentinel Australasia Regional Access.

Registration info

Create an account here, then use your email as username in eodag credentials.


WEkEO#

wekeo_main#

WEkEO Copernicus Sentinel, DEM, and CLMS data.

Registration info

You need an access token to authenticate and to accept terms and conditions with it:

  • Create an account on WEkEO

  • Add your WEkEO credentials (username, password) to the user configuration file.

  • Depending on which data you want to retrieve, you will then need to accept terms and conditions (for once). To do this, follow the tutorial guidelines or run the following commands in your terminal.

  • First, get a token from your base64-encoded credentials (replace USERNAME and PASSWORD with your credentials):

    curl -X POST --data '{"username": "USERNAME", "password": "PASSWORD"}' \
    -H "Content-Type: application/json" \
    "https://gateway.prod.wekeo2.eu/hda-broker/gettoken"
    

    The WEkEO API will respond with a token:

    { "access_token": "xxxxxxxx-yyyy-zzzz-xxxx-yyyyyyyyyyyy",
      "refresh_token": "xxxxxxxx-yyyy-zzzz-xxxx-yyyyyyyyyyyy",
      "scope":"openid",
      "id_token":"token",
      "token_type":"Bearer",
      "expires_in":3600
    }
    
  • Accept terms and conditions by running this command and replacing <access_token> and <licence_name>:

    curl --request PUT \
        --header 'accept: application/json' \
        --header 'Authorization: Bearer <access_token>' \
        https://gateway.prod.wekeo2.eu/hda-broker/api/v1/termsaccepted/<licence_name>
    

The licence name depends on which data you want to retrieve. To use all datasets available in WEkEO, the following licences have to be accepted:

  • EUMETSAT_Copernicus_Data_Licence

  • Copernicus_Land_Monitoring_Service_Data_Policy

  • Copernicus_Sentinel_License

  • Copernicus_ECMWF_License

  • Copernicus_DEM_Instance_COP-DEM-GLO-30-F_Global_30m

  • Copernicus_DEM_Instance_COP-DEM-GLO-90-F_Global_90m


wekeo_cmems#

Copernicus Marine (CMEMS) data from WEkEO.

Registration info

The registration procedure is the same as for wekeo_main. The licence that has to be accepted to access the Copernicus Marine data is:

  • Copernicus_Marine_Service_Product_License


wekeo_ecmwf#

WEkEO ECMWF data.

Registration info

The registration procedure is the same as for wekeo_main.


CREODIAS#

creodias#

CloudFerro DIAS.

Registration info

Create an account here, then use your username, password in eodag credentials. You will also need totp in credentials, a temporary 6-digits OTP (One Time Password, see Creodias documentation) to be able to authenticate and download. Check Authenticate using an OTP to see how to proceed.


creodias_s3#

CloudFerro DIAS data through their S3 EODATA.

Registration info

Create an account on creodias, then go to keymanager and click Add credential to generate the s3 access key and secret key. Add those credentials to the user configuration file (variables aws_access_key_id and aws_secret_access_key).


CNES#

French National Space Agency

CNES provides access to French satellite missions including SPOT, Pléiades, and specialized thematic data hubs.

GEODES#

geodes#

GEODES, French National Space Agency (CNES) Earth Observation portal.

Registration info

Go to https://geodes-portal.cnes.fr, then login or create an account by clicking on Log in in the top-right corner. Once logged-in, create an API key in the user settings page, and used it as apikey in EODAG provider auth credentials.


geodes_s3#

GEODES, French National Space Agency (CNES) Earth Observation portal through their internal S3 Datalake.

Registration info

This provider is only available for CNES users. You need to be connected to the CNES network to access the data. Get credentials for internal Datalake and use them as aws_access_key_id, aws_secret_access_key and aws_session_token EODAG credentials.


hydroweb_next#

hydroweb.next thematic hub for hydrology data access.

Registration info

Go to https://hydroweb.next.theia-land.fr, then login or create an account by clicking on Log in in the top-right corner. Once logged-in, create an API key in the user settings page, and used it as apikey in EODAG provider auth credentials.


peps#

French National Space Agency (CNES) catalog for Sentinel products.

Registration info

create an account here, then use your email as username in eodag credentials.


Destination Earth#

Digital Twin of Earth

Destination Earth initiative creates digital replicas of Earth systems for climate adaptation and environmental policy.

DEDL#

Destination Earth Data Lake (DEDL).

Registration info

You need a DESP OpenID account in order to authenticate.

To create one go here, then click on Sign In, select the identity provider DESP OpenID and then click Authenticate. Finally click on Register to create a new account.


DEDT Lumi#

Destination Earth Digital Twin output on Lumi.

Registration info

Create an account on DestinE, then use your username, password in eodag credentials.


ECMWF#

European Centre for Medium-Range Weather Forecasts.

Registration info

Create an account here.

Then use email as username and key as password from here in eodag credentials. EODAG can be used to request for public datasets as for operational archive. Please note that for public datasets you might need to accept a license (e.g. for TIGGE)


ESA#

European Space Agency

European Space Agency providing access to climate monitoring and Earth observation missions.

fedeo_ceda#

FedEO CEDA (Centre for Environmental Data Archival) through CEOS Federated Earth Observation missions access. The FedEO service periodically ingests the latest ESA CCI (Climate Change Initiative) Open Data Portal catalogue of all CCI datasets.

No credentials are needed


EUMETSAT#

EUMETSAT Data Store (European Organisation for the Exploitation of Meteorological Satellites).

Registration info

Create an account here.

Then use the consumer key as username and the consumer secret as password from here in eodag credentials.


Meteoblue#

Meteoblue weather and forecast Dataset API.

Registration info

EODAG uses dataset API which requires the access level Access Gold.

Contact support@meteoblue.com to apply for a free API key trial.


Planetary Computer#

Microsoft Planetary Computer.

Registration info

Most datasets are anonymously accessible, but a subscription key may be needed to increase rate limits and access private datasets.

Create an account here, then view your keys by signing in with your Microsoft account here.


USGS / Landsat#

U.S. Geological Survey

United States Geological Survey providing access to Landsat archive and other Earth observation programs.

usgs#

U.S geological survey catalog for Landsat products.

Registration info

Create an account here, and request an access to the Machine-to-Machine (M2M) API. Then you will need to generate an application token. Use it as password in eodag credentials, associated to your username.

Product requests can be performed once access to the M2M API has been granted to you.


usgs_satapi_aws#

USGS Landsatlook SAT API / STAC server for Landsat data hosted on AWS S3.

Registration info

You need AWS credentials for download:

  • Create an account on AWS

  • Once the account is activated go to the identity access management console

  • Click on user, then on your user name and then on security credentials.

  • In access keys, click on create access key.

  • Add these credentials to the user configuration file.

Warning

Billing Alert

A credit card number must be provided when creating an AWS account because fees apply after a given amount of downloaded data.

previous

Configure EODAG

next

API User Guide

Contents
  • AWS / GCS EO catalogs
    • Earth Search
      • earth_search
      • earth_search_gcs
    • aws_eos
  • Copernicus
    • Copernicus Data Stores
      • cop_ads
      • cop_cds
      • cop_dataspace
      • cop_ewds
      • cop_marine
    • sara
    • WEkEO
      • wekeo_main
      • wekeo_cmems
      • wekeo_ecmwf
    • CREODIAS
      • creodias
      • creodias_s3
  • CNES
    • GEODES
      • geodes
      • geodes_s3
    • hydroweb_next
    • peps
  • Destination Earth
    • DEDL
    • DEDT Lumi
  • ECMWF
  • ESA
    • fedeo_ceda
  • EUMETSAT
  • Meteoblue
  • Planetary Computer
  • USGS / Landsat
    • usgs
    • usgs_satapi_aws

By CS GROUP - France

© Copyright 2018-2025, CS GROUP - France, https://www.csgroup.eu.

Last updated on 2025-10-13.