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#
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#
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#
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_keydownload_auth.credentials.aws_access_key_idanddownload_auth.credentials.aws_secret_access_keyordownload_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#
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#
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#
Registration info
Create an account here
cop_ewds#
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#
No credentials are needed
sara#
Registration info
Create an account here, then use your email as username in
eodag credentials.
WEkEO#
wekeo_main#
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#
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#
Registration info
The registration procedure is the same as for wekeo_main.
CREODIAS#
creodias#
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#
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#
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#
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#
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#
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#
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#
Registration info
Create an account on DestinE, then use your username, password in eodag
credentials.
ECMWF#
ESA#
European Space Agency
European Space Agency providing access to climate monitoring and Earth observation missions.
fedeo_ceda#
No credentials are needed
EUMETSAT#
Meteoblue#
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#
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#
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#
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.